MCP Tools Reference: ces.googleapis.com

Ferramenta: delete_tool

Exclui a ferramenta especificada.

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

Solicitação do 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_tool",
    "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.DeleteTool.

DeleteToolRequest

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

string

Obrigatório. O nome do recurso da ferramenta a ser excluída.
force

boolean

Opcional. Indica se a ferramenta deve ser excluída à força, mesmo que ainda seja referenciada por agentes/exemplos.

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

string

Opcional. A etag atual da ferramenta. 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 à etag atual da ferramenta, 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 típico é 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 prompt 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: false.
  • 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: false.
  • 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: ❌