Method: projects.locations.collections.dataConnector.invokeConnectorMcp

Effectue un appel à un connecteur MCP.

Requête HTTP

POST https://discoveryengine.googleapis.com/v1alpha/{name=projects/*/locations/*/collections/*/dataConnector}:invokeConnectorMcp

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Ressource DataConnector.

Connecteur de données utilisé pour effectuer l'appel MCP.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "method": string,
  "params": {
    object
  },
  "engine": string,
  "toolSpecVersion": string
}
Champs
method

string

Obligatoire. Méthode à appeler (par exemple, "tools/list", "tools/call", "resources/read", "prompts/get", etc.).
params

object (Struct format)

Facultatif. Paramètres structurés arbitraires pour la méthode.

L'utilisation de google.protobuf.Struct permet de conserver un schéma de charge utile flexible, correspondant au champ params de forme libre de JSON-RPC.
engine

string

Facultatif. Nom de la ressource du moteur (par exemple, "projects/{project}/locations/{location}/collections/{collection}/engines/{engine}"). Utilisé comme ID de moteur de recherche lors de l'appel d'outils de registre d'outils qui émettent des requêtes Discovery Search Service.
toolSpecVersion

string

Facultatif. Version de la spécification de l'outil par rapport à laquelle résoudre la surface de l'outil du connecteur. Cela correspond au nom du fichier de spécification de l'outil BAP du connecteur (par exemple, "v2", "v5.2"). Lorsqu'il n'est pas défini, le serveur utilise sa spécification d'outil par défaut (la plus récente) pour le connecteur. S'applique à toutes les méthodes (par exemple, "tools/list" et "tools/call").

Corps de la réponse

Message de réponse renvoyant le résultat d'un appel de connecteur MCP. Il contient une charge utile de résultat réussi ou des détails sur l'erreur.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{

  // Union field payload can be only one of the following:
  "result": value,
  "error": {
    object (McpError)
  }
  // End of list of possible types for union field payload.
}
Champs
Champ d'union payload. Un seul des champs result ou error doit être défini. payload ne peut être que l'un des éléments suivants :
result

value (Value format)

Résultat réussi : données structurées arbitraires.
error

object (McpError)

Détails de l'erreur lorsque l'appel échoue.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

Pour plus d'informations, consultez la page Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource name :

  • discoveryengine.dataConnectors.executeAction

Pour en savoir plus, consultez la documentation IAM.

McpError

McpError représente les détails de l'erreur lorsqu'un appel MCP échoue. Cette structure suit la forme de l'objet d'erreur JSON-RPC 2.0.

Représentation JSON 
{
  "code": integer,
  "message": string,
  "data": value
}
Champs
code

integer

Code d'erreur numérique.
message

string

Description courte et lisible de l'erreur.
data

value (Value format)

Données structurées facultatives avec un contexte d'erreur supplémentaire.