Method: projects.locations.collections.dataConnector.invokeConnectorMcp

调用 MCP 连接器。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。DataConnector 资源。

用于进行 MCP 调用的数据连接器。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "method": string,
  "params": {
    object
  },
  "engine": string,
  "toolSpecVersion": string
}
字段
method

string

必需。要调用的方法（例如“tools/list”“tools/call”“resources/read”“prompts/get”等）。
params

object (Struct format)

可选。该方法的任意结构化参数。

使用 google.protobuf.Struct 可使载荷架构保持灵活，与 JSON-RPC 的自由格式 params 字段相匹配。
engine

string

可选。引擎资源名称（例如“projects/{project}/locations/{location}/collections/{collection}/engines/{engine}”）。在调用发出 Discovery Search Service 请求的工具注册表工具时，用作搜索引擎 ID。
toolSpecVersion

string

可选。用于解析连接器的工具界面的工具规范版本。这对应于连接器的 BAP 工具规范文件名（例如“v2”“v5.2”）。如果未设置，服务器将使用连接器的默认（最新）工具规范。适用于所有方法（例如“tools/list”和“tools/call”）。

响应正文

返回 MCP 连接器调用结果的响应消息。它包含成功结果载荷或错误详情。

如果成功，响应正文将包含结构如下的数据：

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.
}
字段
联合字段 payload。应恰好设置 result 或 error 中的一个。payload 只能是以下其中一项：
result

value (Value format)

成功结果 - 任意结构化数据。
error

object (McpError)

调用失败时的错误详情。

授权范围

需要以下 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

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • discoveryengine.dataConnectors.executeAction

如需了解详情，请参阅 IAM 文档。

McpError

McpError 表示 MCP 调用失败时的错误详情。此结构遵循 JSON-RPC 2.0 错误对象形状。

JSON 表示法 
{
  "code": integer,
  "message": string,
  "data": value
}
字段
code

integer

数字错误代码。
message

string

简短且便于用户理解的错误说明。
data

value (Value format)

包含其他错误上下文的可选结构化数据。