MCP Tools Reference: ces.googleapis.com

Tool: delete_agent

Löscht den angegebenen Agent.

Das folgende Codebeispiel zeigt, wie Sie curl verwenden, um das MCP-Tool delete_agent aufzurufen.

Curl-Anfrage 
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
}'

Eingabeschema

Anfragenachricht für AgentService.DeleteAgent.

DeleteAgentRequest

JSON-Darstellung 
{
  "name": string,
  "force": boolean,
  "etag": string
}
Felder
name

string

Erforderlich. Der Ressourcenname des zu löschenden Agents.
force

boolean

Optional. Gibt an, ob der Agent auch dann gelöscht werden soll, wenn andere Apps, Agents oder Beispiele noch darauf verweisen.

  • Wenn force = false, schlägt das Löschen fehl, wenn andere Agents oder Beispiele darauf verweisen.
  • Wenn force = true, wird der Agent gelöscht und aus allen verweisenden Apps, Agents und Beispielen entfernt.
etag

string

Optional. Das aktuelle ETag des Agents. Wenn kein ETag angegeben wird, werden beim Löschen alle gleichzeitigen Änderungen überschrieben. Wenn ein ETag angegeben wird, das nicht mit dem aktuellen ETag des Agents übereinstimmt, wird das Löschen blockiert und ein ABORTED-Fehler zurückgegeben.

Ausgabeschema

Eine generische leere Nachricht, die Sie wiederverwenden können, um doppelte leere Nachrichten in Ihren APIs zu vermeiden. Ein typisches Beispiel ist die Verwendung als Anfrage- oder Antworttyp einer API-Methode. Beispiel:

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

Toolanmerkungen

Toolanmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet werden soll.

Neben dem Titelstring werden die folgenden booleschen Hinweise so definiert:

  • readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: „false“.
  • destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: „true“.
  • idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf seine Umgebung. Standardeinstellung: „false“.
  • openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Entitäten interagieren. Wenn „false“, kann das Tool nur mit internen Entitäten interagieren. Ein Websuchtool wäre beispielsweise ein Tool für die offene Welt, ein Speichertool jedoch nicht.

Destruktiver Hinweis: ✅ | Idempotenter Hinweis: ❌ | Hinweis „Nur lesen“: ❌ | Hinweis „Offene Welt“: ❌