MCP Tools Reference: ces.googleapis.com

Outil : list_changelogs

Liste les journaux des modifications dans l'application spécifiée.

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP list_changelogs.

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

Schéma d'entrée

Message de requête pour AgentService.ListChangelogs.

ListChangelogsRequest

Représentation JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
Champs
parent

string

Obligatoire. Nom de ressource de l'application dont vous souhaitez lister les journaux des modifications.
pageSize

integer

Facultatif. Taille de la page demandée. Le serveur peut renvoyer un nombre d'éléments inférieur à celui demandé. Si aucune valeur n'est spécifiée, le serveur sélectionne une valeur par défaut appropriée.
pageToken

string

Facultatif. La valeur next_page_token renvoyée par un appel de liste AgentService.ListChangelogs précédent.
filter

string

Facultatif. Filtre à appliquer lors de la liste des journaux des modifications. Pour en savoir plus, consultez https://google.aip.dev/160.

La chaîne de filtre peut être utilisée pour filtrer par action, resource_type, resource_name, author et create_time. Le comparateur : peut être utilisé pour une correspondance partielle non sensible à la casse sur les champs de chaîne, tandis que = effectue une correspondance exacte sensible à la casse.

Exemples : * action:update (correspondance partielle non sensible à la casse) * action="Create" (correspondance exacte sensible à la casse) * 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

Facultatif. Champ de tri. Seuls "name" et "create_time" sont acceptés. Pour en savoir plus, consultez https://google.aip.dev/132#ordering.

Schéma de sortie

Message de réponse pour AgentService.ListChangelogs.

ListChangelogsResponse

Représentation JSON 
{
  "changelogs": [
    {
      object (Changelog)
    }
  ],
  "nextPageToken": string
}
Champs
changelogs[]

object (Changelog)

Liste des journaux des modifications.
nextPageToken

string

Jeton pouvant être envoyé en tant que ListChangelogsRequest.page_token pour récupérer la page suivante. L'absence de ce champ indique qu'il n'y a pas d'autres pages.

Journal des modifications

Représentation 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
}
Champs
name

string

Identifiant. Identifiant unique du journal des modifications. Format : projects/{project}/locations/{location}/apps/{app}/changelogs/{changelog}
author

string

Uniquement en sortie. Adresse e-mail de l'auteur de la modification.
displayName

string

Uniquement en sortie. Nom à afficher de la modification. Il s'agit généralement du nom à afficher de la ressource qui a été modifiée.
description

string

Uniquement en sortie. Description de la modification, qui indique généralement les champs modifiés dans la ressource.
resource

string

Uniquement en sortie. Ressource modifiée.
resourceType

string

Uniquement en sortie. Type de ressource modifiée.
action

string

Uniquement en sortie. Action effectuée sur la ressource.
originalResource

object (Struct format)

Uniquement en sortie. Ressource d'origine avant la modification.
newResource

object (Struct format)

Uniquement en sortie. Nouvelle ressource après la modification.
dependentResources[]

object (Struct format)

Uniquement en sortie. Ressources dépendantes qui ont été modifiées.
createTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle la modification a été apportée.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
sequenceNumber

string (int64 format)

Uniquement en sortie. Numéro de séquence du journal des modifications, qui augmente de façon monotone.

Struct

Représentation JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Champs
fields

map (key: string, value: value (Value format))

Carte non ordonnée de valeurs typées dynamiquement.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Représentation JSON 
{
  "key": string,
  "value": value
}
Champs
key

string
value

value (Value format)

Valeur

Représentation 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.
}
Champs
Champ d'union kind. Type de valeur. kind ne peut être qu'un des éléments suivants :
nullValue

null

Représente un null JSON.
numberValue

number

Représente un nombre JSON. Ne doit pas être NaN, Infinity ni -Infinity, car ces valeurs ne sont pas acceptées au format JSON. Il ne peut pas non plus représenter de grandes valeurs Int64, car le format JSON ne les accepte généralement pas dans son type numérique.
stringValue

string

Représente une chaîne JSON.
boolValue

boolean

Représente une valeur booléenne JSON (littéral true ou false dans JSON).
structValue

object (Struct format)

Représente un objet JSON.
listValue

array (ListValue format)

Représente un tableau JSON.

ListValue

Représentation JSON 
{
  "values": [
    value
  ]
}
Champs
values[]

value (Value format)

Champ répété de valeurs typées de manière dynamique.

Horodatage

Représentation JSON 
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. Doit être compris entre -62135596800 et 253402300799 inclus (ce qui correspond à 0001-01-01T00:00:00Z et 9999-12-31T23:59:59Z).
nanos

integer

Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie en nanosecondes de la durée, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. Doit être compris entre 0 et 999 999 999 (inclus).

NullValue

Représente un null JSON.

NullValue est une sentinelle qui utilise une énumération avec une seule valeur pour représenter la valeur nulle de l'union de type Value.

Un champ de type NullValue avec une valeur autre que 0 est considéré comme non valide. La plupart des sérialiseurs ProtoJSON émettent un Value avec un null_value défini comme un null JSON, quelle que soit la valeur entière, et effectuent donc un aller-retour vers une valeur 0.

Enums
NULL_VALUE Valeur nulle.

Annotations d'outils

Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients traitent ces indices comme non fiables, mais ils peuvent être utilisés pour déterminer quand un message de confirmation peut être envoyé à un utilisateur.

En plus de la chaîne de titre, les indications booléennes suivantes sont définies comme suit :

  • readOnlyHint : si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".
  • destructiveHint : si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions d'ajout. Valeur par défaut : "true".
  • idempotentHint : si la valeur est "true", appeler l'outil à plusieurs reprises avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".
  • openWorldHint : si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.

Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ✅ | Indication Open World : ❌