MCP Tools Reference: ces.googleapis.com

工具：`get_conversation`

获取指定对话的详细信息。

以下示例演示了如何使用 curl 调用 get_conversation MCP 工具。

Curl 请求
curl --location 'https://ces.[REGION].rep.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "get_conversation", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }'

Curl 请求

                  
curl --location 'https://ces.[REGION].rep.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_conversation",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

输入架构

AgentService.GetConversation 的请求消息。

GetConversationRequest

JSON 表示法
{ "name": string, "source": enum (`Source`) }

字段

字段
`name`	`string` 必需。要检索的对话的资源名称。
`source (deprecated)`	`enum (Source)` 此项已弃用！可选。指明对话的来源。如果未设置，则搜索所有来源。

name

string

必需。要检索的对话的资源名称。

source
(deprecated)

enum (Source)

可选。指明对话的来源。如果未设置，则搜索所有来源。

输出架构

对话表示最终用户与 CES 应用之间的互动。

对话

JSON 表示法

JSON 表示法
{ "name": string, "startTime": string, "endTime": string, "turns": [ { object (`Turn`) } ], "turnCount": integer, "channelType": enum (`ChannelType`), "source": enum (`Source`), "inputTypes": [ enum (`InputType`) ], "entryAgent": string, "deployment": string, "appVersion": string, "languageCode": string, "messages": [ { object (`Message`) } ] }

{
  "name": string,
  "startTime": string,
  "endTime": string,
  "turns": [
    {
      object (Turn)
    }
  ],
  "turnCount": integer,
  "channelType": enum (ChannelType),
  "source": enum (Source),
  "inputTypes": [
    enum (InputType)
  ],
  "entryAgent": string,
  "deployment": string,
  "appVersion": string,
  "languageCode": string,
  "messages": [
    {
      object (Message)
    }
  ]
}

字段
`name`	`string` 标识符。对话的唯一标识符。格式：`projects/{project}/locations/{location}/apps/{app}/conversations/{conversation}`
`startTime`	`string (Timestamp format)` 仅限输出。对话的创建时间戳。采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例：`"2014-10-02T15:01:23Z"`、`"2014-10-02T15:01:23.045123456Z"` 或 `"2014-10-02T15:01:23+05:30"`。
`endTime`	`string (Timestamp format)` 仅限输出。对话结束时的时间戳。采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例：`"2014-10-02T15:01:23Z"`、`"2014-10-02T15:01:23.045123456Z"` 或 `"2014-10-02T15:01:23+05:30"`。
`turns[]`	`object (Turn)` 必需。对话中的回合。
`turnCount`	`integer` 仅限输出。对话中的回合数。
`channelType (deprecated)`	`enum (ChannelType)` 此项已弃用！已弃用。请改用 `input_types`。
`source`	`enum (Source)` 仅限输出。指明对话的来源。
`inputTypes[]`	`enum (InputType)` 仅限输出。对话的输入类型。
`entryAgent`	`string` 仅限输出。最初处理对话的代理。如果未指定，则对话由根代理处理。格式：`projects/{project}/locations/{location}/apps/{app}/agents/{agent}`
`deployment`	`string` 仅限输出。用于处理对话的应用的部署。格式：`projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}`
`appVersion`	`string` 仅限输出。用于处理对话的应用版本。格式：`projects/{project}/locations/{location}/apps/{app}/versions/{version}`
`languageCode`	`string` 仅限输出。对话的语言代码。
`messages[] (deprecated)`	`object (Message)` 此项已弃用！已弃用。请改用 turn。

时间戳

JSON 表示法
{ "seconds": string, "nanos": integer }

字段

字段
`seconds`	`string (int64 format)` 表示世界协调时间 (UTC) 的秒数（从 Unix 纪元 1970-01-01T00:00:00Z 开始算起）。必须介于 -62135596800 到 253402300799 之间（含边界值），对应于 0001-01-01T00:00:00Z 到 9999-12-31T23:59:59Z。
`nanos`	`integer` 秒数的非负小数部分（以纳秒为单位）。此字段是时长的纳秒部分，而不是秒的替代项。对于含小数部分的负秒数，仍必须包含按时间递升的非负纳秒值。必须在 0 到 999,999,999 之间（含边界值）。

seconds

string (int64 format)

表示世界协调时间 (UTC) 的秒数（从 Unix 纪元 1970-01-01T00:00:00Z 开始算起）。必须介于 -62135596800 到 253402300799 之间（含边界值），对应于 0001-01-01T00:00:00Z 到 9999-12-31T23:59:59Z。

nanos

integer

秒数的非负小数部分（以纳秒为单位）。此字段是时长的纳秒部分，而不是秒的替代项。对于含小数部分的负秒数，仍必须包含按时间递升的非负纳秒值。必须在 0 到 999,999,999 之间（含边界值）。

Turn

JSON 表示法
{ "messages": [ { object (`Message`) } ], "rootSpan": { object (`Span`) } }

字段

字段
`messages[]`	`object (Message)` 可选。对话回合中的消息列表，包括用户输入、代理响应和处理期间的中间事件。
`rootSpan`	`object (Span)` 可选。操作处理的根 span。

messages[]

object (Message)

可选。对话回合中的消息列表，包括用户输入、代理响应和处理期间的中间事件。

rootSpan

object (Span)

可选。操作处理的根 span。

消息

JSON 表示法
{ "role": string, "chunks": [ { object (`Chunk`) } ], "eventTime": string }

字段

字段
`role`	`string` 可选。对话中的角色，例如用户、代理。
`chunks[]`	`object (Chunk)` 可选。消息的内容，以一系列块的形式呈现。
`eventTime`	`string (Timestamp format)` 可选。消息的发送或接收时间。如果消息是 `example` 的一部分，则不应使用此属性。采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例：`"2014-10-02T15:01:23Z"`、`"2014-10-02T15:01:23.045123456Z"` 或 `"2014-10-02T15:01:23+05:30"`。

role

string

可选。对话中的角色，例如用户、代理。

chunks[]

object (Chunk)

可选。消息的内容，以一系列块的形式呈现。

eventTime

string (Timestamp format)

可选。消息的发送或接收时间。如果消息是 example 的一部分，则不应使用此属性。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

块

JSON 表示法

JSON 表示法
{ // Union field `data` can be only one of the following: "text": string, "transcript": string, "blob": { object (`Blob`) }, "payload": { object }, "image": { object (`Image`) }, "toolCall": { object (`ToolCall`) }, "toolResponse": { object (`ToolResponse`) }, "agentTransfer": { object (`AgentTransfer`) }, "updatedVariables": { object }, "defaultVariables": { object } // End of list of possible types for union field `data`. }

{

  // Union field data can be only one of the following:
  "text": string,
  "transcript": string,
  "blob": {
    object (Blob)
  },
  "payload": {
    object
  },
  "image": {
    object (Image)
  },
  "toolCall": {
    object (ToolCall)
  },
  "toolResponse": {
    object (ToolResponse)
  },
  "agentTransfer": {
    object (AgentTransfer)
  },
  "updatedVariables": {
    object
  },
  "defaultVariables": {
    object
  }
  // End of list of possible types for union field data.
}

字段
联合字段 `data`。数据块数据。`data` 只能是下列其中一项：
`text`	`string` 可选。文本数据。
`transcript`	`string` 可选。与音频关联的转写内容。
`blob`	`object (Blob)` 可选。Blob 数据。
`payload`	`object (Struct format)` 可选。自定义载荷数据。
`image`	`object (Image)` 可选。图片数据。
`toolCall`	`object (ToolCall)` 可选。工具执行请求。
`toolResponse`	`object (ToolResponse)` 可选。工具执行响应。
`agentTransfer`	`object (AgentTransfer)` 可选。代理转移事件。
`updatedVariables`	`object (Struct format)` 一个结构体，表示对话中更新的变量，按变量名称键控。
`defaultVariables`	`object (Struct format)` 结构体表示对话开始时的默认变量，按变量名称键控。

Blob

JSON 表示法
{ "mimeType": string, "data": string }

字段

字段
`mimeType`	`string` 必需。来源数据的 IANA 标准 MIME 类型。
`data`	`string (bytes format)` 必需。相应 blob 的原始字节。使用 base64 编码的字符串。

mimeType

string

必需。来源数据的 IANA 标准 MIME 类型。

data

string (bytes format)

必需。相应 blob 的原始字节。

使用 base64 编码的字符串。

结构体

JSON 表示法
{ "fields": { string: value, ... } }

字段

字段
`fields`	`map (key: string, value: value (Value format))` 无序的动态类型值映射。包含一系列 `"key": value` 对的对象。示例：`{ "name": "wrench", "mass": "1.3kg", "count": "3" }`。

fields

map (key: string, value: value (Value format))

无序的动态类型值映射。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

FieldsEntry

JSON 表示法
{ "key": string, "value": value }

字段
`key`	`string`
`value`	`value (Value format)`

值

JSON 表示法

JSON 表示法
{ // Union field `kind` can be only one of the following: "nullValue": null, "numberValue": number, "stringValue": string, "boolValue": boolean, "structValue": { object }, "listValue": array // End of list of possible types for union field `kind`. }

{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}

字段
联合字段 `kind`。值的类型。`kind` 只能是下列其中一项：
`nullValue`	`null` 表示 null 值。
`numberValue`	`number` 表示双精度值。
`stringValue`	`string` 表示字符串值。
`boolValue`	`boolean` 表示布尔值。
`structValue`	`object (Struct format)` 表示结构化值。
`listValue`	`array (ListValue format)` 表示重复的 `Value`。

ListValue

JSON 表示法
{ "values": [ value ] }

字段

字段
`values[]`	`value (Value format)` 动态类型值的重复字段。

values[]

value (Value format)

动态类型值的重复字段。

图片

JSON 表示法
{ "mimeType": string, "data": string }

字段

字段
`mimeType`	`string` 必需。来源数据的 IANA 标准 MIME 类型。支持的图片类型包括： * image/png * image/jpeg * image/webp
`data`	`string (bytes format)` 必需。图片的原始字节。使用 base64 编码的字符串。

mimeType

string

必需。来源数据的 IANA 标准 MIME 类型。支持的图片类型包括： * image/png * image/jpeg * image/webp

data

string (bytes format)

必需。图片的原始字节。

使用 base64 编码的字符串。

ToolCall

JSON 表示法

JSON 表示法
{ "id": string, "displayName": string, "args": { object }, // Union field `tool_identifier` can be only one of the following: "tool": string, "toolsetTool": { object (`ToolsetTool`) } // End of list of possible types for union field `tool_identifier`. }

{
  "id": string,
  "displayName": string,
  "args": {
    object
  },

  // Union field tool_identifier can be only one of the following:
  "tool": string,
  "toolsetTool": {
    object (ToolsetTool)
  }
  // End of list of possible types for union field tool_identifier.
}

字段
`id`	`string` 可选。工具调用的唯一标识符。如果填充了此字段，客户端应返回执行结果，并在 `ToolResponse` 中包含匹配 ID。
`displayName`	`string` 仅限输出。工具的显示名称。
`args`	`object (Struct format)` 可选。以 JSON 对象格式表示的工具的输入参数和值。
联合字段 `tool_identifier`。要执行的工具的标识符。它可以是持久化工具，也可以是工具集中的工具。`tool_identifier` 只能是下列其中一项：
`tool`	`string` 可选。要执行的工具的名称。格式：`projects/{project}/locations/{location}/apps/{app}/tools/{tool}`
`toolsetTool`	`object (ToolsetTool)` 可选。要执行的工具集工具。

ToolsetTool

JSON 表示法
{ "toolset": string, "toolId": string }

字段

字段
`toolset`	`string` 必需。相应工具所源自的 Toolset 的资源名称。格式：`projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}`
`toolId`	`string` 可选。用于过滤工具的工具 ID，以检索相应工具的架构。

toolset

string

必需。相应工具所源自的 Toolset 的资源名称。格式：projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}

toolId

string

可选。用于过滤工具的工具 ID，以检索相应工具的架构。

ToolResponse

JSON 表示法

JSON 表示法
{ "id": string, "displayName": string, "response": { object }, // Union field `tool_identifier` can be only one of the following: "tool": string, "toolsetTool": { object (`ToolsetTool`) } // End of list of possible types for union field `tool_identifier`. }

{
  "id": string,
  "displayName": string,
  "response": {
    object
  },

  // Union field tool_identifier can be only one of the following:
  "tool": string,
  "toolsetTool": {
    object (ToolsetTool)
  }
  // End of list of possible types for union field tool_identifier.
}

字段
`id`	`string` 可选。相应回答所针对的匹配项的 ID。`tool call`
`displayName`	`string` 仅限输出。工具的显示名称。
`response`	`object (Struct format)` 必需。以 JSON 对象格式表示的工具执行结果。使用“output”键指定工具响应，使用“error”键指定错误详情（如有）。如果未指定“output”和“error”键，则整个“response”都被视为工具执行结果。
联合字段 `tool_identifier`。已执行的工具的标识符。它可以是持久化工具，也可以是工具集中的工具。`tool_identifier` 只能是下列其中一项：
`tool`	`string` 可选。要执行的工具的名称。格式：`projects/{project}/locations/{location}/apps/{app}/tools/{tool}`
`toolsetTool`	`object (ToolsetTool)` 可选。已执行的工具集工具。

AgentTransfer

JSON 表示法
{ "targetAgent": string, "displayName": string }

字段

字段
`targetAgent`	`string` 必需。对话要转移到的代理。智能体将从这一刻起接管对话。格式：`projects/{project}/locations/{location}/apps/{app}/agents/{agent}`
`displayName`	`string` 仅限输出。代理的显示名称。

targetAgent

string

必需。对话要转移到的代理。智能体将从这一刻起接管对话。格式：projects/{project}/locations/{location}/apps/{app}/agents/{agent}

displayName

string

仅限输出。代理的显示名称。

span

JSON 表示法
{ "name": string, "startTime": string, "endTime": string, "duration": string, "attributes": { object }, "childSpans": [ { object (`Span`) } ] }

字段
`name`	`string` 仅限输出。span 的名称。
`startTime`	`string (Timestamp format)` 仅限输出。时间段的开始时间。采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例：`"2014-10-02T15:01:23Z"`、`"2014-10-02T15:01:23.045123456Z"` 或 `"2014-10-02T15:01:23+05:30"`。
`endTime`	`string (Timestamp format)` 仅限输出。时间段的结束时间。采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例：`"2014-10-02T15:01:23Z"`、`"2014-10-02T15:01:23.045123456Z"` 或 `"2014-10-02T15:01:23+05:30"`。
`duration`	`string (Duration format)` 仅限输出。Span 的时长。该时长以秒为单位，最多包含九个小数位，以“`s`”结尾。示例：`"3.5s"`。
`attributes`	`object (Struct format)` 仅限输出。与 span 关联的键值对属性。
`childSpans[]`	`object (Span)` 仅限输出。嵌套在此 span 下的子 span。

时长

JSON 表示法
{ "seconds": string, "nanos": integer }

字段

字段
`seconds`	`string (int64 format)` 时间段的带符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间（含边界值）。注意：这些界限的计算依据是：60 秒/分钟 * 60 分钟/小时 * 24 小时/天 * 365.25 天/年 * 10000 年
`nanos`	`integer` 时间跨度的有符号秒数小数部分（以纳秒为单位）。时长不足 1 秒时，`seconds` 字段为 0，`nanos` 字段为正数或负数。对于时长为 1 秒或更长时间的情况，`nanos` 字段的非零值必须与 `seconds` 字段的符号相同。必须介于 -999,999,999 到 +999,999,999 之间（含边界值）。

seconds

string (int64 format)

时间段的带符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间（含边界值）。注意：这些界限的计算依据是：60 秒/分钟 * 60 分钟/小时 * 24 小时/天 * 365.25 天/年 * 10000 年

nanos

integer

时间跨度的有符号秒数小数部分（以纳秒为单位）。时长不足 1 秒时，seconds 字段为 0，nanos 字段为正数或负数。对于时长为 1 秒或更长时间的情况，nanos 字段的非零值必须与 seconds 字段的符号相同。必须介于 -999,999,999 到 +999,999,999 之间（含边界值）。

工具注释

破坏性提示：❌ | 等幂性提示：✅ | 只读提示：✅ | 开放世界提示：❌

MCP Tools Reference: ces.googleapis.com 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

工具：get_conversation

输入架构

GetConversationRequest

输出架构

对话

时间戳

Turn

消息

块

Blob

结构体

FieldsEntry

值

ListValue

图片

ToolCall

ToolsetTool

ToolResponse

AgentTransfer

span

时长

工具注释

MCP Tools Reference: ces.googleapis.com

工具：`get_conversation`