MCP Tools Reference: ces.googleapis.com

Tool: list_changelogs

Listet Änderungsprotokolle in der angegebenen App auf.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool list_changelogs aufrufen.

Curl-Anfrage
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 MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }'

Eingabeschema

Anfragenachricht für AgentService.ListChangelogs.

ListChangelogsRequest

JSON-Darstellung
{ "parent": string, "pageSize": integer, "pageToken": string, "filter": string, "orderBy": string }

Felder
parent	string Erforderlich. Der Ressourcenname der App, für die Changelogs aufgeführt werden sollen.
pageSize	integer Optional. Angeforderte Seitengröße. Der Server gibt möglicherweise weniger Elemente als angefordert zurück. Wenn kein Wert angegeben wurde, wählt der Server einen geeigneten Standardwert aus.
pageToken	string Optional. Der Wert next_page_token wurde gegebenenfalls von einem vorherigen AgentService.ListChangelogs-Listenaufruf zurückgegeben.
filter	string Optional. Filter, der beim Auflisten der Änderungsprotokolle angewendet werden soll. Weitere Informationen finden Sie unter https://google.aip.dev/160. Mit dem Filterstring kann nach action, resource_type, resource_name, author und create_time gefiltert werden. Der :-Vergleichsoperator kann für teilweise Übereinstimmungen ohne Berücksichtigung der Groß-/Kleinschreibung für Stringfelder verwendet werden, während = eine genaue Übereinstimmung mit Berücksichtigung der Groß-/Kleinschreibung ausführt. Beispiele: * action:update (Teilabgleich ohne Berücksichtigung der Groß-/Kleinschreibung) * action="Create" (genauer Abgleich mit Berücksichtigung der Groß-/Kleinschreibung) * resource_type:agent * resource_name:my-agent * author:[e-mail] * create_time > "2025-01-01T00:00:00Z" * create_time <= "2025-01-01T00:00:00Z" AND resource_type:tool
orderBy	string Optional. Feld, nach dem sortiert werden soll. Nur „name“ und „create_time“ werden unterstützt. Weitere Informationen finden Sie unter https://google.aip.dev/132#ordering.

Ausgabeschema

Antwortnachricht für AgentService.ListChangelogs.

ListChangelogsResponse

JSON-Darstellung
{ "changelogs": [ { object (Changelog) } ], "nextPageToken": string }

Felder
changelogs[]	object (Changelog) Die Liste der Änderungslogs.
nextPageToken	string Ein Token, das als ListChangelogsRequest.page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld fehlt, gibt es keine nachfolgenden Seiten.

Änderungsprotokoll

JSON-Darstellung
{ "name": string, "author": string, "displayName": string, "description": string, "resource": string, "resourceType": string, "action": string, "originalResource": { object }, "newResource": { object }, "dependentResources": [ { object } ], "createTime": string, "sequenceNumber": string }

Felder
name	string ID. Die eindeutige Kennung des Änderungsprotokolls. Format: projects/{project}/locations/{location}/apps/{app}/changelogs/{changelog}
author	string Nur Ausgabe. E‑Mail-Adresse des Autors der Änderung.
displayName	string Nur Ausgabe. Anzeigename der Änderung. In der Regel sollte es sich um den Anzeigenamen der geänderten Ressource handeln.
description	string Nur Ausgabe. Beschreibung der Änderung, in der in der Regel die geänderten Felder in der Ressource angegeben werden.
resource	string Nur Ausgabe. Die Ressource, die geändert wurde.
resourceType	string Nur Ausgabe. Der Typ der Ressource, die geändert wurde.
action	string Nur Ausgabe. Die Aktion, die für die Ressource ausgeführt wurde.
originalResource	object (Struct format) Nur Ausgabe. Die ursprüngliche Ressource vor der Änderung.
newResource	object (Struct format) Nur Ausgabe. Die neue Ressource nach der Änderung.
dependentResources[]	object (Struct format) Nur Ausgabe. Die abhängigen Ressourcen, die geändert wurden.
createTime	string (Timestamp format) Nur Ausgabe. Der Zeitpunkt, zu dem die Änderung vorgenommen wurde. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
sequenceNumber	string (int64 format) Nur Ausgabe. Die monoton steigende Sequenznummer des Änderungsprotokolls.

Struct

JSON-Darstellung
{ "fields": { string: value, ... } }

Felder
fields	map (key: string, value: value (Value format)) Ungeordnete Zuordnung von dynamisch typisierten Werten. Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

JSON-Darstellung
{ "key": string, "value": value }

Felder
key	string
value	value (Value format)

Wert

JSON-Darstellung
{ // 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. }

Felder
Union-Feld kind. Die Art des Werts. Für kind ist nur einer der folgenden Werte zulässig:
nullValue	null Stellt ein JSON-null dar.
numberValue	number Stellt eine JSON-Zahl dar. Darf nicht NaN, Infinity oder -Infinity sein, da diese in JSON nicht unterstützt werden. Auch große Int64-Werte können nicht dargestellt werden, da das JSON-Format sie in seinem Zahlentyp im Allgemeinen nicht unterstützt.
stringValue	string Stellt einen JSON-String dar.
boolValue	boolean Stellt einen booleschen JSON-Wert dar (true- oder false-Literal in JSON).
structValue	object (Struct format) Stellt ein JSON-Objekt dar.
listValue	array (ListValue format) Stellt ein JSON-Array dar.

ListValue

JSON-Darstellung
{ "values": [ value ] }

Felder
values[]	value (Value format) Wiederkehrendes Feld mit dynamisch typisierten Werten.

Zeitstempel

JSON-Darstellung
{ "seconds": string, "nanos": integer }

Felder
seconds	string (int64 format) Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss zwischen -62135596800 und 253402300799 liegen (einschließlich), was dem Zeitraum vom 01.01.0001 00:00:00 UTC bis zum 31.12.9999 23:59:59 UTC entspricht.
nanos	integer Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 (einschließlich) liegen.

NullValue

Stellt ein JSON-null dar.

NullValue ist ein Sentinel, der einen Enum mit nur einem Wert verwendet, um den Nullwert für die Typvereinigung Value darzustellen.

Ein Feld vom Typ NullValue mit einem anderen Wert als 0 gilt als ungültig. Die meisten ProtoJSON-Serialisierer geben ein Value mit einem als JSON-null festgelegten null_value aus, unabhängig vom Ganzzahlwert, und führen so zu einem Roundtrip zu einem 0-Wert.

Enums
NULL_VALUE	Nullwert.

Tool-Annotationen

Tool-Anmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann ein Bestätigungs-Prompt an einen Nutzer gesendet werden soll.

Zusammen mit dem Titelstring werden die folgenden booleschen Hinweise so definiert:

• readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: false.
• destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: true.
• idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: false.
• openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Einheiten interagieren. Wenn „false“, kann das Tool nur mit internen Einheiten interagieren. Ein Tool für die Websuche wäre beispielsweise Open World, ein Tool für das Gedächtnis nicht.

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Nur-Lese-Hinweis: ✅ | Open-World-Hinweis: ❌