MCP Tools Reference: ces.googleapis.com

Herramienta: list_changelogs

Enumera los registros de cambios de la app especificada.

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP list_changelogs.

Solicitud de 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
}'

Esquema de entrada

Mensaje de solicitud para AgentService.ListChangelogs.

ListChangelogsRequest

Representación JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
Campos
parent

string

Obligatorio. Es el nombre del recurso de la app de la que se enumerarán los registros de cambios.
pageSize

integer

Es opcional. Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los que se solicitaron. Si no se especifica, el servidor elegirá un valor predeterminado adecuado.
pageToken

string

Es opcional. El valor de next_page_token que se muestra de una llamada AgentService.ListChangelogs de lista anterior.
filter

string

Es opcional. Es el filtro que se aplicará cuando se listen los registros de cambios. Para obtener más información, consulta https://google.aip.dev/160.

La cadena de filtro se puede usar para filtrar por action, resource_type, resource_name, author y create_time. El comparador : se puede usar para la concordancia parcial que no distingue mayúsculas de minúsculas en los campos de cadena, mientras que = realiza una concordancia exacta que distingue mayúsculas de minúsculas.

Ejemplos: * action:update (coincidencia parcial que no distingue mayúsculas de minúsculas) * action="Create" (coincidencia exacta que distingue mayúsculas de minúsculas) * 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

Es opcional. Campo por el que se ordenará. Solo se admiten "name" y "create_time". Consulta https://google.aip.dev/132#ordering para obtener más detalles.

Esquema de salida

Mensaje de respuesta para AgentService.ListChangelogs.

ListChangelogsResponse

Representación JSON 
{
  "changelogs": [
    {
      object (Changelog)
    }
  ],
  "nextPageToken": string
}
Campos
changelogs[]

object (Changelog)

Es la lista de registros de cambios.
nextPageToken

string

Es un token que se puede enviar como ListChangelogsRequest.page_token para recuperar la página siguiente. La ausencia de este campo indica que no hay páginas posteriores.

Registro de cambios

Representación 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
}
Campos
name

string

Es el identificador. Es el identificador único del registro de cambios. Formato: projects/{project}/locations/{location}/apps/{app}/changelogs/{changelog}
author

string

Solo salida. Es la dirección de correo electrónico del autor del cambio.
displayName

string

Solo salida. Es el nombre visible del cambio. Por lo general, debe ser el nombre visible del recurso que se cambió.
description

string

Solo salida. Es la descripción del cambio, que suele capturar los campos modificados en el recurso.
resource

string

Solo salida. Es el recurso que se cambió.
resourceType

string

Solo salida. Es el tipo de recurso que se modificó.
action

string

Solo salida. Es la acción que se realizó en el recurso.
originalResource

object (Struct format)

Solo salida. Es el recurso original antes del cambio.
newResource

object (Struct format)

Solo salida. Es el recurso nuevo después del cambio.
dependentResources[]

object (Struct format)

Solo salida. Son los recursos dependientes que se modificaron.
createTime

string (Timestamp format)

Solo salida. Fecha y hora en que se realizó el cambio.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
sequenceNumber

string (int64 format)

Solo salida. Es el número de secuencia del registro de cambios, que aumenta de forma monótona.

Struct

Representación JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campos
fields

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

Es un mapa no ordenado de valores escritos de forma dinámica.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representación JSON 
{
  "key": string,
  "value": value
}
Campos
key

string
value

value (Value format)

Valor

Representación 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.
}
Campos
Campo de unión kind. Es el tipo de valor. kind puede ser solo uno de los parámetros siguientes:
nullValue

null

Representa un valor nulo.
numberValue

number

Representa un valor doble.
stringValue

string

Representa un valor de cadena.
boolValue

boolean

Representa un valor booleano.
structValue

object (Struct format)

Representa un valor estructurado.
listValue

array (ListValue format)

Representa un Value repetido.

ListValue

Representación JSON 
{
  "values": [
    value
  ]
}
Campos
values[]

value (Value format)

Es un campo repetido de valores escritos de forma dinámica.

Marca de tiempo

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa los segundos de la hora UTC desde la época de Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799 inclusive (lo que corresponde a 0001-01-01T00:00:00Z y 9999-12-31T23:59:59Z).
nanos

integer

Fracciones no negativas de un segundo a una resolución de nanosegundos. Este campo es la parte de la duración en nanosegundos, no una alternativa a los segundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Debe ser un valor entre 0 y 999,999,999, inclusive.

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌