MCP Tools Reference: ces.googleapis.com

Tool: delete_tool

Löscht das angegebene Tool.

Das folgende Codebeispiel zeigt, wie Sie curl verwenden, um das MCP-Tool delete_tool 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_tool",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfragenachricht für AgentService.DeleteTool.

DeleteToolRequest

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

string

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

boolean

Optional. Gibt an, ob das Tool auch dann gelöscht werden soll, wenn noch von Agents/Beispielen darauf verwiesen wird.

  • Wenn force = false ist, schlägt das Löschen fehl, wenn noch Agents auf das Tool verweisen.
  • Wenn force = true ist, werden alle vorhandenen Verweise von Agents entfernt und das Tool wird gelöscht.
etag

string

Optional. Das aktuelle ETag des Tools. 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 Tools ü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 sind die folgenden booleschen Hinweise definiert:

  • readOnlyHint: Wenn „true“ (wahr), ändert das Tool seine Umgebung nicht. Standardeinstellung: „false“ (falsch).
  • destructiveHint: Wenn „true“ (wahr), kann das Tool destruktive Aktionen ausführen. Wenn „false“ (falsch), kann das Tool nur additive Aktionen ausführen. Standardeinstellung: „true“ (wahr).
  • idempotentHint: Wenn „true“ (wahr), hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf seine Umgebung. Standardeinstellung: „false“ (falsch).
  • openWorldHint: Wenn „true“ (wahr), kann das Tool mit einer „offenen Welt“ externer Entitäten interagieren. Wenn „false“ (falsch), 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“: ❌