MCP Tools Reference: ces.googleapis.com

Ferramenta: delete_toolset

Exclui o conjunto de ferramentas especificado.

O exemplo de código a seguir mostra como usar curl para chamar a ferramenta MCP delete_toolset.

Solicitação 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

Mensagem de solicitação para AgentService.DeleteToolset.

DeleteToolsetRequest

Representação JSON 
{
  "name": string,
  "force": boolean,
  "etag": string
}
Campos
name

string

Obrigatório. O nome do recurso do conjunto de ferramentas a ser excluído.
force

boolean

Opcional. Indica se o conjunto de ferramentas precisa ser excluído à força, mesmo que ainda seja referenciado por apps/agentes.

  • Se force = false, a exclusão falhará se algum agente ainda referenciar o conjunto de ferramentas.
  • Se force = true, todas as referências atuais dos agentes serão removidas e o conjunto de ferramentas será excluído.
etag

string

Opcional. A ETag atual do conjunto de ferramentas. Se uma ETag não for fornecida, a exclusão vai substituir todas as mudanças simultâneas. Se uma ETag for fornecida e não corresponder à atual do conjunto de ferramentas, a exclusão será bloqueada e um erro ABORTED será retornado.

Esquema de saída

Uma mensagem vazia genérica que pode ser reutilizada para evitar a definição de mensagens vazias duplicadas nas APIs. Um exemplo comum é usá-la como o tipo de solicitação ou resposta de um método de API. Por exemplo:

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

Anotações de ferramentas

As anotações de ferramentas são enviadas aos clientes do MCP para descrever o risco básico de uma determinada ferramenta. A maioria dos clientes trata essas dicas como não confiáveis, mas elas podem ser usadas para decidir quando um aviso de confirmação pode ser enviado a um usuário.

Junto com a string de título, as seguintes dicas booleanas são definidas da seguinte maneira:

  • readOnlyHint: se for verdadeiro, a ferramenta não modifica o ambiente. Padrão: falso.
  • destructiveHint: se for verdadeiro, a ferramenta poderá realizar ações destrutivas. Se for falso, a ferramenta só poderá realizar ações aditivas. Padrão: verdadeiro.
  • idempotentHint: se for verdadeiro, chamar a ferramenta repetidamente com os mesmos argumentos não terá efeito adicional no ambiente. Padrão: falso.
  • openWorldHint: se for verdadeiro, a ferramenta poderá interagir com um "mundo aberto" de entidades externas. Se for falso, a ferramenta só poderá interagir com entidades internas. Por exemplo, uma ferramenta de pesquisa na Web seria de mundo aberto, enquanto uma ferramenta de memória não seria.

Dica destrutiva: ✅ | Dica idempotente: ❌ | Dica somente leitura: ❌ | Dica de mundo aberto: ❌