Method: projects.locations.collections.dataConnector.invokeConnectorMcp

Realiza una llamada a un conector de MCP.

Solicitud HTTP


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

Las URL usan la sintaxis de transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Obligatorio. Recurso DataConnector.

Es el conector de datos que se usa para realizar la llamada a MCP.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "method": string,
  "params": {
    object
  },
  "engine": string,
  "toolSpecVersion": string
}
Campos
method

string

Obligatorio. Es el método que se invocará (p. ej., "tools/list", "tools/call", "resources/read", "prompts/get", etcétera).
params

object (Struct format)

Es opcional. Son parámetros estructurados arbitrarios para el método.

El uso de google.protobuf.Struct mantiene el esquema de carga útil flexible, lo que coincide con el campo params de formato libre de JSON-RPC.
engine

string

Es opcional. Nombre del recurso del motor (p.ej., "projects/{project}/locations/{location}/collections/{collection}/engines/{engine}"). Se usa como el ID del motor de búsqueda cuando se invocan herramientas del registro de herramientas que emiten solicitudes del servicio de Búsqueda de descubrimiento.
toolSpecVersion

string

Es opcional. Es la versión de la especificación de la herramienta con la que se resuelve la superficie de la herramienta del conector. Corresponde al nombre del archivo de especificaciones de la herramienta de BAP del conector (p.ej., "v2", "v5.2"). Cuando no se establece, el servidor usa la especificación de herramienta predeterminada (más reciente) para el conector. Se aplica a todos los métodos (p.ej., "tools/list" y "tools/call").

Cuerpo de la respuesta

Es el mensaje de respuesta que devuelve el resultado de una invocación del conector de MCP. Contiene una carga útil de resultado exitoso o detalles del error.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación 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.
}
Campos
Se debe establecer exactamente uno de los valores result o error. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
result

value (Value format)

Resultado exitoso: Datos estructurados arbitrarios.
error

object (McpError)

Son los detalles del error cuando falla la llamada.
Fin de los campos mutuamente excluyentes.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • 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

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • discoveryengine.dataConnectors.executeAction

Para obtener más información, consulta la documentación de IAM.

McpError

McpError representa los detalles del error cuando falla una llamada a MCP. Esta estructura sigue la forma del objeto de error de JSON-RPC 2.0.

Representación JSON 
{
  "code": integer,
  "message": string,
  "data": value
}
Campos
code

integer

Es el código de error numérico.
message

string

Es una descripción breve y legible por humanos del error.
data

value (Value format)

Son datos estructurados opcionales con contexto de error adicional.