MCP Tools Reference: ces.googleapis.com

Herramienta: delete_toolset

Borra el conjunto de herramientas especificado.

En el siguiente muestra de código, se muestra cómo usar curl para llamar a la herramienta delete_toolset del MCP.

Solicitud 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": "delete_toolset",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensaje de solicitud para AgentService.DeleteToolset.

DeleteToolsetRequest

Representación JSON
{
  "name": string,
  "force": boolean,
  "etag": string
}
Campos
name

string

Obligatorio. Es el nombre de recurso del conjunto de herramientas que se borrará.

force

boolean

Es opcional. Indica si se debe borrar el conjunto de herramientas de forma forzada, incluso si la app o los agentes aún hacen referencia a él.

  • Si force = false, la eliminación falla si algún agente aún hace referencia al conjunto de herramientas.
  • Si force = true, se quitarán todas las referencias existentes de los agentes y se borrará el conjunto de herramientas.
etag

string

Es opcional. Es la ETag actual del conjunto de herramientas. Si no se proporciona una ETag, la eliminación sobrescribirá cualquier cambio simultáneo. Si se proporciona una ETag y no coincide con la ETag actual del conjunto de herramientas, se bloqueará la eliminación y se mostrará un error ABORTED.

Esquema de salida

Es un mensaje vacío genérico que puedes volver a usar para evitar definir mensajes vacíos duplicados en tus APIs. Un ejemplo típico es usarlo como el tipo de solicitud o respuesta de un método de API. Por ejemplo:

service Foo {
  rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
}

Anotaciones de herramientas

Las anotaciones de herramientas se envían a los clientes del MCP para describir el riesgo básico de una herramienta determinada. La mayoría de los clientes tratan estas sugerencias como no confiables, pero se pueden usar para decidir cuándo se puede enviar un mensaje de confirmación a un usuario.

Junto con la cadena de título, las siguientes sugerencias booleanas se definen de la siguiente manera:

  • readOnlyHint: Si es verdadero, la herramienta no modifica su entorno. Valor predeterminado: false.
  • destructiveHint: Si es verdadero, la herramienta puede realizar acciones destructivas. Si es falso, la herramienta solo puede realizar acciones aditivas. Valor predeterminado: true.
  • idempotentHint: Si es verdadero, llamar a la herramienta de forma repetida con los mismos argumentos no tendrá ningún efecto adicional en su entorno. Valor predeterminado: false.
  • openWorldHint: Si es verdadero, la herramienta puede interactuar con un "mundo abierto" de entidades externas. Si es falso, la herramienta solo puede interactuar con entidades internas. Por ejemplo, una herramienta de búsqueda web sería de mundo abierto, mientras que una herramienta de memoria no lo sería.

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