MCP Tools Reference: ces.googleapis.com

工具：list_changelogs

列出指定应用中的更改日志。

以下代码示例展示了如何使用 curl 调用 list_changelogs MCP 工具。

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

输入架构

AgentService.ListChangelogs 的请求消息。

ListChangelogsRequest

JSON 表示法 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
字段
parent

string

必需。要列出相应应用的更改日志的应用的资源名称。
pageSize

integer

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

string

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

string

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

过滤字符串可用于按 action、resource_type、resource_name、author 和 create_time 进行过滤。: 比较器可用于对字符串字段进行不区分大小写的部分匹配，而 = 则执行区分大小写的完全匹配。

示例：* action:update（不区分大小写的部分匹配）* action="Create"（区分大小写的完全匹配）* resource_type:agent * resource_name:my-agent * author:me@example.com * create_time > "2025-01-01T00:00:00Z" * create_time <= "2025-01-01T00:00:00Z" AND resource_type:tool
orderBy

string

可选。要排序的字段。仅支持“name”和“create_time”。如需了解详情，请参阅 https://google.aip.dev/132#ordering。

输出架构

AgentService.ListChangelogs 的响应消息。

ListChangelogsResponse

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

object (Changelog)

更改日志列表。
nextPageToken

string

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

更新日志

JSON 表示法 
{
  "name": string,
  "author": string,
  "displayName": string,
  "description": string,
  "resource": string,
  "resourceType": string,
  "action": string,
  "originalResource": {
    object
  },
  "newResource": {
    object
  },
  "dependentResources": [
    {
      object
    }
  ],
  "createTime": string,
  "sequenceNumber": string
}
字段
name

string

标识符。更改日志的唯一标识符。格式：projects/{project}/locations/{location}/apps/{app}/changelogs/{changelog}
author

string

仅限输出。相应更改的作者的电子邮件地址。
displayName

string

仅限输出。相应变更的显示名称。它通常应该是已更改资源的显示名称。
description

string

仅限输出。更改的说明，通常会捕获资源中已更改的字段。
resource

string

仅限输出。已更改的资源。
resourceType

string

仅限输出。已更改的资源类型。
action

string

仅限输出。对资源执行的操作。
originalResource

object (Struct format)

仅限输出。更改前的原始资源。
newResource

object (Struct format)

仅限输出。更改后的新资源。
dependentResources[]

object (Struct format)

仅限输出。已更改的相关资源。
createTime

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"。
sequenceNumber

string (int64 format)

仅限输出。变更日志的单调递增序列号。

结构体

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

表示 JSON null。
numberValue

number

表示 JSON 数值。不得为 NaN、Infinity 或 -Infinity，因为 JSON 不支持这些值。由于 JSON 格式通常不支持其数字类型中的大型 Int64 值，因此这种格式也无法表示大型 Int64 值。
stringValue

string

表示 JSON 字符串。
boolValue

boolean

表示 JSON 布尔值（JSON 中的 true 或 false 字面量）。
structValue

object (Struct format)

表示 JSON 对象。
listValue

array (ListValue format)

表示 JSON 数组。

ListValue

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

value (Value format)

动态类型值的重复字段。

时间戳

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

NullValue

表示 JSON null。

NullValue 是一个标记，使用仅包含一个值的枚举来表示 Value 类型联合的 null 值。

如果类型为 NullValue 的字段的值不是 0，则视为无效。大多数 ProtoJSON 序列化程序都会发出一个 Value，并将 null_value 设置为 JSON null，无论整数值是多少，因此都会往返于 0 值。

枚举
NULL_VALUE Null 值。

工具注释

工具注释会发送给 MCP 客户端，用于描述指定工具的基本风险。大多数客户端会将这些提示视为不受信任的，但它们可用于确定何时向用户发送确认提示。

除了标题字符串之外，还定义了以下布尔值提示：

  • readOnlyHint：如果为 true，则工具不会修改其环境。默认值：false。
  • destructiveHint：如果为 true，则工具可以执行破坏性操作。如果为 false，则该工具只能执行添加操作。默认值：true。
  • idempotentHint：如果为 true，则使用相同实参重复调用该工具不会对其环境产生任何额外影响。默认值：false。
  • openWorldHint：如果为 true，则工具可以与外部实体的“开放世界”互动。如果为 false，则该工具只能与内部实体互动。例如，网络搜索工具是开放世界工具，而内存工具不是开放世界工具。

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