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

Les URL utilisent 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 demandes de service de recherche Discovery.
toolSpecVersion

string

Facultatif. Version de 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'elle n'est pas définie, le serveur utilise la 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 positif ou des informations sur les erreurs.

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

Représentation JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "result": value,
  "error": {
    object (McpError)
  }
  // End of mutually exclusive fields.
}
Champs
Vous devez définir soit result, soit error. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
result

value (Value format)

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

object (McpError)

Détails de l'erreur en cas d'échec de l'appel.
Fin des champs qui s'excluent mutuellement.

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

Brève description de l'erreur, lisible par l'humain.
data

value (Value format)

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