MCP Tools Reference: ces.googleapis.com

Strumento: delete_agent

Elimina l'agente specificato.

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP delete_agent.

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

Schema di input

Messaggio di richiesta per AgentService.DeleteAgent.

DeleteAgentRequest

Rappresentazione JSON 
{
  "name": string,
  "force": boolean,
  "etag": string
}
Campi
name

string

Obbligatorio. Il nome della risorsa dell'agente da eliminare.
force

boolean

Facoltativo. Indica se eliminare forzatamente l'agente, anche se a cui fanno ancora riferimento altre app, altri agenti o altri esempi.

  • Se force = false, l'eliminazione non riesce se altri agenti o altri esempi fanno riferimento all'agente.
  • Se force = true, elimina l'agente e rimuovilo da tutte le app, da tutti gli agenti e da tutti gli esempi che fanno riferimento all'agente.
etag

string

Facoltativo. L'etag corrente dell'agente. Se non viene fornito un etag, l'eliminazione sovrascriverà eventuali modifiche simultanee. Se viene fornito un etag e non corrisponde all'etag corrente dell'agente, l'eliminazione verrà bloccata e verrà restituito un errore ABORTED.

Schema di output

Un messaggio vuoto generico che puoi riutilizzare per evitare di definire messaggi vuoti duplicati nelle tue API. Un esempio tipico è utilizzarlo come tipo di richiesta o di risposta di un metodo API. Ad esempio:

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

Annotazioni dello strumento

Le annotazioni dello strumento vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client tratta questi suggerimenti come non attendibili, ma possono essere utilizzati per decidere quando inviare all'utente una richiesta di conferma.

Oltre alla stringa del titolo, i seguenti suggerimenti booleani sono definiti come segue:

  • readOnlyHint: se è true, lo strumento non modifica il suo ambiente. Valore predefinito: false.
  • destructiveHint: se è true, lo strumento può eseguire azioni distruttive. Se è false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.
  • idempotentHint: se è true, la chiamata ripetuta dello strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.
  • openWorldHint: se è true, lo strumento può interagire con un "open world" di entità esterne. Se è false, lo strumento può interagire solo con entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria non lo sarebbe.

Suggerimento distruttivo: ✅ | Suggerimento idempotente: ❌ | Suggerimento di sola lettura: ❌ | Suggerimento open world: ❌