MCP Tools Reference: ces.googleapis.com

工具：list_conversations

列出对话。

以下示例演示了如何使用 curl 调用 list_conversations 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": "list_conversations",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

输入架构

AgentService.ListConversations 的请求消息。

ListConversationsRequest

JSON 表示法 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "source": enum (Source),
  "sources": [
    enum (Source)
  ]
}
字段
parent

string

必需。要列出对话的应用的资源名称。
pageSize

integer

可选。请求的页面大小。 服务器返回的项可能要比请求的少。如果未指定，服务器将选择合适的默认值。
pageToken

string

可选。从上一次列表 AgentService.ListConversations 调用返回的 next_page_token 值。
filter

string

可选。列出对话时要应用的过滤条件。如需了解详情，请参阅 https://google.aip.dev/160。
source

enum (Source)

可选。指明对话的来源。如果未设置，系统将默认应用 Source.Live。将被弃用，取而代之的是 sources 字段。
sources[]

enum (Source)

可选。指明对话的来源。如果未设置，则默认应用所有可用来源。

输出架构

AgentService.ListConversations 的响应消息。

ListConversationsResponse

JSON 表示法 
{
  "conversations": [
    {
      object (Conversation)
    }
  ],
  "nextPageToken": string
}
字段
conversations[]

object (Conversation)

对话列表。
nextPageToken

string

可作为 ListConversationsRequest.page_token 发送并用于检索下一页的令牌。如果缺少此字段，则表示没有后续页面。

对话

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

标识符。对话的唯一标识符。格式：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 之间（含边界值）。

Turn

JSON 表示法 
{
  "messages": [
    {
      object (Message)
    }
  ],
  "rootSpan": {
    object (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"。

块

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.
}
字段
联合字段 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 编码的字符串。

结构体

JSON 表示法 
{
  "fields": {
    string: value,
    ...
  }
}
字段
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 表示法 
{

  // 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)

动态类型值的重复字段。

图片

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

string

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

string (bytes format)

必需。图片的原始字节。

使用 base64 编码的字符串。

ToolCall

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

可选。工具调用的唯一标识符。如果填充了此字段，客户端应返回执行结果，并在 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，以检索相应工具的架构。

ToolResponse

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

可选。相应回答所针对的匹配项的 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

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

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 之间（含边界值）。

工具注释

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