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

ID。變更記錄的專屬 ID。格式：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 正規化，並使用 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 值，因此也無法表示這類值。
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)

代表自 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 型別聯集的空值。

如果 NullValue 類型的欄位值不是 0，則視為無效。大多數 ProtoJSON 序列化程式都會發出 Value，並將 null_value 設為 JSON null (不論整數值為何)，因此會來回傳輸至 0 值。

列舉
NULL_VALUE 空值。

工具註解

破壞性提示：❌ | 等冪提示：✅ | 唯讀提示：✅ | 開放世界提示：❌