MCP Tools Reference: ces.googleapis.com

Tool: delete_toolset

Löscht das angegebene Toolset.

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

Eingabeschema

Anfragenachricht für AgentService.DeleteToolset.

DeleteToolsetRequest

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

string

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

boolean

Optional. Gibt an, ob das Toolset auch dann gelöscht werden soll, wenn es noch von Apps/Agents referenziert wird.

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

string

Optional. Das aktuelle ETag des Toolsets. 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 Toolsets ü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“, ä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 „offene Welt“, ein Speichertool nicht.

Destruktiver Hinweis: ✅ | Idempotenter Hinweis: ❌ | Nur-Lese-Hinweis: ❌ | Hinweis zur offenen Welt: ❌