MCP Tools Reference: ces.googleapis.com

工具:list_changelogs

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

以下示例演示了如何使用 curl 调用 list_changelogs 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_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

过滤字符串可用于按 actionresource_typeresource_nameauthorcreate_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

表示 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 表示法
{
  "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 之间(含边界值)。

工具注释

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