MCP Tools Reference: ces.googleapis.com

Tool: delete_guardrail

Löscht die angegebene Guardrail.

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

Eingabeschema

Anfragenachricht für AgentService.DeleteGuardrail.

DeleteGuardrailRequest

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

string

Erforderlich. Der Ressourcenname der zu löschenden Guardrail.
force

boolean

Optional. Gibt an, ob die Guardrail auch dann gelöscht werden soll, wenn sie noch von Apps/Agents referenziert wird.

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

string

Optional. Das aktuelle ETag der Guardrail. Wenn kein ETag angegeben wird, werden beim Löschen alle gleichzeitigen Änderungen überschrieben. Wenn ein ETag angegeben wird, das nicht mit dem aktuellen ETag der Guardrail ü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 „Open World“, ein Speichertool nicht.

Destruktiver Hinweis: ✅ | Idempotenter Hinweis: ❌ | Nur-Lese-Hinweis: ❌ | Open-World-Hinweis: ❌