MCP Tools Reference: ces.googleapis.com

Tool: get_guardrail

Ruft Details zur angegebenen Richtlinie ab.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool get_guardrail aufrufen.

Curl-Anfrage 
                  
curl --location 'https://ces.[REGION].rep.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_guardrail",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfragenachricht für AgentService.GetGuardrail.

GetGuardrailRequest

JSON-Darstellung 
{
  "name": string
}
Felder
name

string

Erforderlich. Der Ressourcenname der abzurufenden Guardrail.

Ausgabeschema

Guardrail enthält eine Liste von Kontrollen und Sicherheitsvorkehrungen, um die Sicherheit der Agents zu gewährleisten.

Schutzmaßnahme

JSON-Darstellung 
{
  "name": string,
  "displayName": string,
  "description": string,
  "enabled": boolean,
  "action": {
    object (TriggerAction)
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,

  // Union field guardrail_type can be only one of the following:
  "contentFilter": {
    object (ContentFilter)
  },
  "llmPromptSecurity": {
    object (LlmPromptSecurity)
  },
  "llmPolicy": {
    object (LlmPolicy)
  },
  "modelSafety": {
    object (ModelSafety)
  },
  "codeCallback": {
    object (CodeCallback)
  }
  // End of list of possible types for union field guardrail_type.
}
Felder
name

string

ID. Die eindeutige ID der Richtlinie. Format: projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}
displayName

string

Erforderlich. Anzeigename der Richtlinie.
description

string

Optional. Beschreibung der Richtlinie.
enabled

boolean

Optional. Gibt an, ob die Schutzvorrichtung aktiviert ist.
action

object (TriggerAction)

Optional. Aktion, die ausgeführt werden soll, wenn die Richtlinie ausgelöst wird.
createTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel für die Erstellung der Richtlinie.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten Aktualisierung der Richtlinie.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
etag

string

Etag, das verwendet wird, um sicherzustellen, dass sich das Objekt während eines Read-Modify-Write-Vorgangs nicht geändert hat. Wenn das ETag leer ist, werden alle gleichzeitigen Änderungen durch das Update überschrieben.
Union-Feld guardrail_type. Art der Schutzmaßnahme. Für guardrail_type ist nur einer der folgenden Werte zulässig:
contentFilter

object (ContentFilter)

Optional. Guardrail, die verhindert, dass bestimmte Inhalte in der Unterhaltung verwendet werden.
llmPromptSecurity

object (LlmPromptSecurity)

Optional. Schutzvorrichtung, die die Unterhaltung blockiert, wenn der Prompt basierend auf der LLM-Klassifizierung als unsicher eingestuft wird.
llmPolicy

object (LlmPolicy)

Optional. Guardrail, die die Unterhaltung blockiert, wenn die LLM-Antwort basierend auf der LLM-Klassifizierung als Richtlinienverstoß eingestuft wird.
modelSafety

object (ModelSafety)

Optional. Guardrail, die die Unterhaltung blockiert, wenn die LLM-Antwort basierend auf den Sicherheitseinstellungen des Modells als unsicher eingestuft wird.
codeCallback

object (CodeCallback)

Optional. Guardrail, die die Unterhaltung basierend auf dem Ergebnis der Callback-Ausführung möglicherweise blockiert.

ContentFilter

JSON-Darstellung 
{
  "bannedContents": [
    string
  ],
  "bannedContentsInUserInput": [
    string
  ],
  "bannedContentsInAgentResponse": [
    string
  ],
  "matchType": enum (MatchType),
  "disregardDiacritics": boolean
}
Felder
bannedContents[]

string

Optional. Liste verbotener Ausdrücke. Gilt sowohl für Nutzereingaben als auch für Agent-Antworten.
bannedContentsInUserInput[]

string

Optional. Liste verbotener Ausdrücke. Gilt nur für Nutzereingaben.
bannedContentsInAgentResponse[]

string

Optional. Liste verbotener Ausdrücke. Gilt nur für Antworten von Kundenservicemitarbeitern.
matchType

enum (MatchType)

Erforderlich. Keyword-Option für den Inhaltsfilter.
disregardDiacritics

boolean

Optional. Wenn der Wert „true“ ist, werden diakritische Zeichen beim Abgleich ignoriert.

LlmPromptSecurity

JSON-Darstellung 
{
  "failOpen": boolean,

  // Union field security_config can be only one of the following:
  "defaultSettings": {
    object (DefaultSecuritySettings)
  },
  "customPolicy": {
    object (LlmPolicy)
  }
  // End of list of possible types for union field security_config.
}
Felder
failOpen

boolean

Optional. Bestimmt das Verhalten, wenn bei der Schutzvorrichtung ein LLM-Fehler auftritt. – Bei „true“ wird die Schutzvorrichtung umgangen. – „false“ (Standard): Die Richtlinie wird ausgelöst bzw. blockiert.

Hinweis: Wenn eine benutzerdefinierte Richtlinie angegeben wird, wird dieses Feld zugunsten der „fail_open“-Konfiguration der Richtlinie ignoriert.
Union-Feld security_config. Definiert den Modus für die Sicherheitskonfiguration. Der Nutzer muss eine der folgenden Konfigurationen auswählen. Für security_config ist nur einer der folgenden Werte zulässig:
defaultSettings

object (DefaultSecuritySettings)

Optional. Verwenden Sie die vordefinierten Standardsicherheitseinstellungen des Systems. Wenn Sie diesen Modus auswählen möchten, fügen Sie der Anfrage eine leere „default_settings“-Nachricht hinzu. Das Feld „default_prompt_template“ wird vom Server in der Antwort ausgefüllt.
customPolicy

object (LlmPolicy)

Optional. Verwenden Sie eine benutzerdefinierte LlmPolicy, um den Sicherheitsmechanismus zu konfigurieren.

DefaultSecuritySettings

JSON-Darstellung 
{
  "defaultPromptTemplate": string
}
Felder
defaultPromptTemplate

string

Nur Ausgabe. Die vom System verwendete Standardvorlage für Prompts. Dieses Feld dient dazu, dem Nutzer anzuzeigen, welchen Prompt das System standardmäßig verwendet. Es ist OUTPUT_ONLY.

LlmPolicy

JSON-Darstellung 
{
  "maxConversationMessages": integer,
  "modelSettings": {
    object (ModelSettings)
  },
  "prompt": string,
  "policyScope": enum (PolicyScope),
  "failOpen": boolean,
  "allowShortUtterance": boolean
}
Felder
maxConversationMessages

integer

Optional. Bei der Überprüfung dieser Richtlinie werden die letzten „n“ Nachrichten in der Unterhaltung berücksichtigt. Wenn kein Wert festgelegt ist, wird der Standardwert 10 verwendet.
modelSettings

object (ModelSettings)

Optional. Modelleinstellungen.
prompt

string

Erforderlich. Richtlinien-Prompt.
policyScope

enum (PolicyScope)

Erforderlich. Definiert, wann die Richtlinienprüfung während der Unterhaltung angewendet werden soll. Wenn die Richtlinie auf „POLICY_SCOPE_UNSPECIFIED“ gesetzt ist, wird sie auf die Nutzereingabe angewendet. Wenn die Richtlinie auf die Antwort des Agents angewendet wird, kommt es zu einer zusätzlichen Latenz, bevor der Agent antworten kann.
failOpen

boolean

Optional. Wenn während der Richtlinienprüfung ein Fehler auftritt, wird die Anfrage nicht blockiert und die Schutzmaßnahme wird nicht ausgelöst.
allowShortUtterance

boolean

Optional. Standardmäßig wird die LLM-Richtlinienprüfung bei kurzen Äußerungen umgangen. Wenn Sie diese Einstellung aktivieren, wird die Richtlinienprüfung auf alle Äußerungen angewendet, auch auf solche, die normalerweise übersprungen würden.

ModelSettings

JSON-Darstellung 
{
  "model": string,

  // Union field _temperature can be only one of the following:
  "temperature": number
  // End of list of possible types for union field _temperature.
}
Felder
model

string

Optional. Das LLM-Modell, das der Agent verwenden soll. Wenn nicht festgelegt, übernimmt der Agent das Modell vom übergeordneten Agent.

Union-Feld _temperature.

Für _temperature ist nur einer der folgenden Werte zulässig:
temperature

number

Optional. Wenn festgelegt, wird diese Temperatur für das LLM-Modell verwendet. Die Temperatur steuert die Zufälligkeit der Antworten des Modells. Niedrigere Temperaturen führen zu vorhersagbareren Antworten. Höhere Temperaturen führen zu kreativeren Antworten.

ModelSafety

JSON-Darstellung 
{
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ]
}
Felder
safetySettings[]

object (SafetySetting)

Erforderlich. Liste der Sicherheitseinstellungen.

SafetySetting

JSON-Darstellung 
{
  "category": enum (HarmCategory),
  "threshold": enum (HarmBlockThreshold)
}
Felder
category

enum (HarmCategory)

Erforderlich. Die Schadenskategorie.
threshold

enum (HarmBlockThreshold)

Erforderlich. Der Schwellenwert für die Schadensblockierung

CodeCallback

JSON-Darstellung 
{
  "beforeAgentCallback": {
    object (Callback)
  },
  "afterAgentCallback": {
    object (Callback)
  },
  "beforeModelCallback": {
    object (Callback)
  },
  "afterModelCallback": {
    object (Callback)
  }
}
Felder
beforeAgentCallback

object (Callback)

Optional. Der Callback, der vor dem Aufrufen des Agents ausgeführt werden soll. Jede Callback-Funktion muss eine Struktur (z.B. ein Dictionary oder Objekt) mit mindestens folgenden Elementen zurückgeben: – „decision“: entweder „OK“ oder „TRIGGER“. – „reason“: Ein String, der die Entscheidung erläutert. Eine Entscheidung vom Typ „TRIGGER“ kann die weitere Verarbeitung stoppen.
afterAgentCallback

object (Callback)

Optional. Der Callback, der nach dem Aufrufen des Agenten ausgeführt werden soll. Jede Callback-Funktion muss eine Struktur (z.B. ein Dictionary oder Objekt) mit mindestens folgenden Elementen zurückgeben: – „decision“: entweder „OK“ oder „TRIGGER“. – „reason“: Ein String, der die Entscheidung erläutert. Eine Entscheidung vom Typ „TRIGGER“ kann die weitere Verarbeitung stoppen.
beforeModelCallback

object (Callback)

Optional. Der Callback, der vor dem Aufrufen des Modells ausgeführt werden soll. Wenn das Modell mehrmals aufgerufen wird, wird der Callback mehrmals ausgeführt. Jede Callback-Funktion muss eine Struktur (z.B. ein Dictionary oder Objekt) mit mindestens folgenden Elementen zurückgeben: – „decision“: entweder „OK“ oder „TRIGGER“. – „reason“: Ein String, der die Entscheidung erläutert. Eine Entscheidung vom Typ „TRIGGER“ kann die weitere Verarbeitung stoppen.
afterModelCallback

object (Callback)

Optional. Der Callback, der nach dem Aufrufen des Modells ausgeführt werden soll. Wenn das Modell mehrmals aufgerufen wird, wird der Callback mehrmals ausgeführt. Jede Callback-Funktion muss eine Struktur (z.B. ein Dictionary oder Objekt) mit mindestens folgenden Elementen zurückgeben: – „decision“: entweder „OK“ oder „TRIGGER“. – „reason“: Ein String, der die Entscheidung erläutert. Eine Entscheidung vom Typ „TRIGGER“ kann die weitere Verarbeitung stoppen.

Rückruf

JSON-Darstellung 
{
  "description": string,
  "disabled": boolean,
  "proactiveExecutionEnabled": boolean,

  // Union field callback can be only one of the following:
  "pythonCode": string
  // End of list of possible types for union field callback.
}
Felder
description

string

Optional. Eine menschenlesbare Beschreibung des Rückrufs.
disabled

boolean

Optional. Gibt an, ob der Rückruf deaktiviert ist. Deaktivierte Rückrufe werden vom Kundenservicemitarbeiter ignoriert.
proactiveExecutionEnabled

boolean

Optional. Wenn aktiviert, wird der Callback auch für Zwischenausgaben des Modells ausgeführt. Diese Einstellung wirkt sich nur auf den After-Model-Callback aus. MIT VORSICHT AKTIVIEREN. Normalerweise muss „after_model_callback“ erst nach dem Empfang aller Modellantworten ausgeführt werden. Die Aktivierung der proaktiven Ausführung kann sich negativ auf die Ausführungskosten und die Latenz auswirken und sollte nur in seltenen Fällen aktiviert werden.
Union-Feld callback. Der auszuführende Callback. Für callback ist nur einer der folgenden Werte zulässig:
pythonCode

string

Erforderlich. Der Python-Code, der für den Callback ausgeführt werden soll.

TriggerAction

JSON-Darstellung 
{

  // Union field action can be only one of the following:
  "respondImmediately": {
    object (RespondImmediately)
  },
  "transferAgent": {
    object (TransferAgent)
  },
  "generativeAnswer": {
    object (GenerativeAnswer)
  }
  // End of list of possible types for union field action.
}
Felder
Union-Feld action. Die erforderliche Aktion. Für action ist nur einer der folgenden Werte zulässig:
respondImmediately

object (RespondImmediately)

Optional. Sofort mit einer vorkonfigurierten Antwort reagieren
transferAgent

object (TransferAgent)

Optional. Leiten Sie die Unterhaltung an einen anderen Kundenservicemitarbeiter weiter.
generativeAnswer

object (GenerativeAnswer)

Optional. Mit einer generativen Antwort antworten.

RespondImmediately

JSON-Darstellung 
{
  "responses": [
    {
      object (Response)
    }
  ]
}
Felder
responses[]

object (Response)

Erforderlich. Die Antwortvorlagen, aus denen der Kundenservicemitarbeiter auswählen kann. Die Antwort wird zufällig ausgewählt.

Antwort

JSON-Darstellung 
{
  "text": string,
  "disabled": boolean
}
Felder
text

string

Erforderlich. Text, mit dem der Kundenservicemitarbeiter antworten soll.
disabled

boolean

Optional. Gibt an, ob die Antwort deaktiviert ist. Deaktivierte Antworten werden vom Agent nicht verwendet.

TransferAgent

JSON-Darstellung 
{
  "agent": string
}
Felder
agent

string

Erforderlich. Der Name des Agents, an den die Unterhaltung übertragen werden soll. Der Agent muss sich in derselben App wie der aktuelle Agent befinden. Format: projects/{project}/locations/{location}/apps/{app}/agents/{agent}

GenerativeAnswer

JSON-Darstellung 
{
  "prompt": string
}
Felder
prompt

string

Erforderlich. Der Prompt, der für die generative Antwort verwendet werden soll.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen.

Tool-Annotationen

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