Herramienta: create_guardrail
Crea una nueva barandilla en la app determinada.
En la siguiente muestra de código, se indica cómo usar curl para llamar a la herramienta de MCP create_guardrail.
| Solicitud de curl |
|---|
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": "create_guardrail", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
Esquema de entrada
Mensaje de solicitud para AgentService.CreateGuardrail.
CreateGuardrailRequest
| Representación JSON |
|---|
{
"parent": string,
"guardrailId": string,
"guardrail": {
object ( |
| Campos | |
|---|---|
parent |
Obligatorio. Es el nombre del recurso de la app en la que se creará una barandilla. |
guardrailId |
Es opcional. Es el ID que se usará para la barandilla, que se convertirá en el componente final del nombre del recurso de la barandilla. Si no se proporciona, se asignará automáticamente un ID único para la protección. |
guardrail |
Obligatorio. La protección que se creará. |
Barrera de protección
| Representación JSON |
|---|
{ "name": string, "displayName": string, "description": string, "enabled": boolean, "action": { object ( |
| Campos | |
|---|---|
name |
Es el identificador. Es el identificador único de la barandilla de seguridad. Formato: |
displayName |
Obligatorio. Es el nombre visible de la barandilla. |
description |
Es opcional. Descripción de la barrera de seguridad. |
enabled |
Es opcional. Indica si la barandilla está habilitada. |
action |
Es opcional. Es la acción que se debe realizar cuando se activa la barrera de protección. |
createTime |
Solo salida. Es la marca de tiempo de la creación de la barandilla de seguridad. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
updateTime |
Solo salida. Marca de tiempo de la última actualización de la barandilla. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
etag |
Es la etiqueta de entidad que se usa para garantizar que el objeto no haya cambiado durante una operación de lectura, modificación y escritura. Si la etag está vacía, la actualización reemplazará cualquier cambio simultáneo. |
Campo de unión guardrail_type. Es el tipo de barrera de seguridad. guardrail_type puede ser solo uno de los parámetros siguientes: |
|
contentFilter |
Es opcional. Es una barrera que prohíbe que se use cierto contenido en la conversación. |
llmPromptSecurity |
Es opcional. Es una protección que bloquea la conversación si la instrucción se considera no segura según la clasificación del LLM. |
llmPolicy |
Es opcional. Es la barrera que bloquea la conversación si se considera que la respuesta del LLM incumple la política según la clasificación del LLM. |
modelSafety |
Es opcional. Es una protección que bloquea la conversación si la respuesta del LLM se considera no segura según la configuración de seguridad del modelo. |
codeCallback |
Es opcional. Es una barrera de protección que puede bloquear la conversación según el resultado de la ejecución de la devolución de llamada. |
supervisor |
Es opcional. Es la protección que ejecuta la intervención del supervisor. |
ContentFilter
| Representación JSON |
|---|
{
"bannedContents": [
string
],
"bannedContentsInUserInput": [
string
],
"bannedContentsInAgentResponse": [
string
],
"matchType": enum ( |
| Campos | |
|---|---|
bannedContents[] |
Es opcional. Lista de frases prohibidas. Se aplica tanto a las entradas del usuario como a las respuestas del agente. |
bannedContentsInUserInput[] |
Es opcional. Lista de frases prohibidas. Solo se aplica a las entradas de los usuarios. |
bannedContentsInAgentResponse[] |
Es opcional. Lista de frases prohibidas. Solo se aplica a las respuestas del agente. |
matchType |
Obligatorio. Es el tipo de concordancia del filtro de contenido. |
disregardDiacritics |
Es opcional. Si es verdadero, se ignoran los signos diacríticos durante la coincidencia. |
sensitiveWordsExemptions[] |
Es opcional. Son las entradas de la lista de palabras sensibles que permite esta barandilla de seguridad. Solo es válido cuando match_type es SENSITIVE_WORDS. Cada valor debe ser igual a una entrada de la lista (no distingue mayúsculas de minúsculas, se ignoran los espacios en blanco circundantes); los demás valores no tienen efecto. Se aplica solo a esta barandilla de seguridad. Un máximo de 1,000 entradas de hasta 256 caracteres cada una. |
LlmPromptSecurity
| Representación JSON |
|---|
{ "failOpen": boolean, // Union field |
| Campos | |
|---|---|
failOpen |
Es opcional. Determina el comportamiento cuando la barrera de seguridad encuentra un error de LLM. - Si es verdadero, se omite la barrera de protección. - Si es falso (predeterminado), la barandilla se activa o bloquea. Nota: Si se proporciona una política personalizada, este campo se ignora en favor de la configuración "fail_open" de la política. |
Campo de unión security_config. Define el modo de configuración de seguridad. El usuario debe elegir una de las siguientes opciones de configuración. security_config puede ser solo uno de los parámetros siguientes: |
|
defaultSettings |
Es opcional. Usa la configuración de seguridad predeterminada del sistema. Para seleccionar este modo, incluye un mensaje "default_settings" vacío en la solicitud. El servidor completará el campo "default_prompt_template" en la respuesta. |
customPolicy |
Es opcional. Usa una LlmPolicy definida por el usuario para configurar la barrera de seguridad. |
DefaultSecuritySettings
| Representación JSON |
|---|
{ "defaultPromptTemplate": string } |
| Campos | |
|---|---|
defaultPromptTemplate |
Solo salida. Es la plantilla de instrucciones predeterminada que usa el sistema. Este campo tiene fines de visualización para mostrarle al usuario qué instrucción usa el sistema de forma predeterminada. Es OUTPUT_ONLY. |
LlmPolicy
| Representación JSON |
|---|
{ "maxConversationMessages": integer, "modelSettings": { object ( |
| Campos | |
|---|---|
maxConversationMessages |
Es opcional. Cuando verifiques esta política, considera los últimos "n" mensajes de la conversación. Si no se establece, se usará un valor predeterminado de 10. |
modelSettings |
Es opcional. Configuración del modelo |
prompt |
Obligatorio. Mensaje de política. Admite marcadores de posición de variables de sesión ( |
policyScope |
Obligatorio. Define cuándo aplicar la verificación de la política durante la conversación. Si se establece en |
failOpen |
Es opcional. Si se produce un error durante la verificación de la política, se produce un error de apertura y no se activa la barandilla. |
allowShortUtterance |
Es opcional. De forma predeterminada, la verificación de la política de LLM se omite para las expresiones cortas. Si habilitas este parámetro de configuración, se aplicará la verificación de políticas a todas las expresiones, incluidas las que normalmente se omitirían. |
ModelSettings
| Representación JSON |
|---|
{ "model": string, "thinkingLevel": enum ( |
| Campos | |
|---|---|
model |
Es opcional. Es el modelo de LLM que debe usar el agente. Si no se establece, el agente heredará el modelo de su agente superior. |
thinkingLevel |
Es opcional. Es el nivel de razonamiento del modelo. |
Campo de unión
|
|
temperature |
Es opcional. Si se establece, se usará esta temperatura para el modelo de LLM. La temperatura controla la aleatoriedad de las respuestas del modelo. Las temperaturas más bajas producen respuestas más predecibles. Las temperaturas más altas producen respuestas más creativas. |
ModelSafety
| Representación JSON |
|---|
{
"safetySettings": [
{
object ( |
| Campos | |
|---|---|
safetySettings[] |
Obligatorio. Lista de parámetros de configuración de seguridad. |
SafetySetting
| Representación JSON |
|---|
{ "category": enum ( |
| Campos | |
|---|---|
category |
Obligatorio. La categoría de daño. |
threshold |
Obligatorio. El umbral de bloqueo de daño. |
CodeCallback
| Representación JSON |
|---|
{ "beforeAgentCallback": { object ( |
| Campos | |
|---|---|
beforeAgentCallback |
Es opcional. Es la devolución de llamada que se ejecutará antes de que se llame al agente. Se espera que cada función de devolución de llamada devuelva una estructura (p.ej., un diccionario o un objeto) que contenga, al menos, lo siguiente: - 'decision': 'OK' o 'TRIGGER'. - "reason": Una cadena que explica la decisión. Una decisión de "ACTIVACIÓN" puede detener el procesamiento posterior. |
afterAgentCallback |
Es opcional. Es la devolución de llamada que se ejecutará después de que se llame al agente. Se espera que cada función de devolución de llamada devuelva una estructura (p.ej., un diccionario o un objeto) que contenga, al menos, lo siguiente: - 'decision': 'OK' o 'TRIGGER'. - "reason": Una cadena que explica la decisión. Una decisión de "ACTIVACIÓN" puede detener el procesamiento posterior. |
beforeModelCallback |
Es opcional. Es la devolución de llamada que se ejecutará antes de que se llame al modelo. Si hay varias llamadas al modelo, la devolución de llamada se ejecutará varias veces. Se espera que cada función de devolución de llamada devuelva una estructura (p.ej., un diccionario o un objeto) que contenga, al menos, lo siguiente: - 'decision': 'OK' o 'TRIGGER'. - "reason": Una cadena que explica la decisión. Una decisión de "ACTIVACIÓN" puede detener el procesamiento posterior. |
afterModelCallback |
Es opcional. Es la devolución de llamada que se ejecutará después de que se llame al modelo. Si hay varias llamadas al modelo, la devolución de llamada se ejecutará varias veces. Se espera que cada función de devolución de llamada devuelva una estructura (p.ej., un diccionario o un objeto) que contenga, al menos, lo siguiente: - 'decision': 'OK' o 'TRIGGER'. - "reason": Una cadena que explica la decisión. Una decisión de "ACTIVACIÓN" puede detener el procesamiento posterior. |
Devolución de llamada
| Representación JSON |
|---|
{ "description": string, "disabled": boolean, "proactiveExecutionEnabled": boolean, // Union field |
| Campos | |
|---|---|
description |
Es opcional. Es una descripción legible por humanos de la devolución de llamada. |
disabled |
Es opcional. Indica si la devolución de llamada está inhabilitada. El agente ignora las devoluciones de llamada inhabilitadas. |
proactiveExecutionEnabled |
Es opcional. Si se habilita, la devolución de llamada también se ejecutará en los resultados intermedios del modelo. Este parámetro de configuración solo afecta a la devolución de llamada posterior al modelo. HABILITA CON PRECAUCIÓN. Por lo general, la devolución de llamada After model solo debe ejecutarse después de recibir todas las respuestas del modelo. Habilitar la ejecución proactiva puede tener implicaciones negativas en el costo y la latencia de la ejecución, y solo debe habilitarse en situaciones excepcionales. |
Campo de unión callback. Es la devolución de llamada que se ejecutará. callback puede ser solo uno de los parámetros siguientes: |
|
pythonCode |
Obligatorio. Es el código de Python que se ejecutará para la devolución de llamada. |
Supervisor
| Representación JSON |
|---|
{ "type": enum ( |
| Campos | |
|---|---|
type |
Es opcional. Es el tipo de supervisor. |
detectionMode |
Es opcional. Es el modo de detección del supervisor. |
TriggerAction
| Representación JSON |
|---|
{ // Union field |
| Campos | |
|---|---|
Campo de unión action. La acción por realizar. action puede ser solo uno de los parámetros siguientes: |
|
respondImmediately |
Es opcional. Responde de inmediato con una respuesta preconfigurada. |
transferAgent |
Es opcional. Transferir la conversación a otro agente |
generativeAnswer |
Es opcional. Responder con una respuesta generativa |
RespondImmediately
| Representación JSON |
|---|
{
"responses": [
{
object ( |
| Campos | |
|---|---|
responses[] |
Obligatorio. Son las respuestas estándares entre las que puede elegir el agente. La respuesta se elige de forma aleatoria. |
Respuesta
| Representación JSON |
|---|
{ "text": string, "disabled": boolean } |
| Campos | |
|---|---|
text |
Obligatorio. Es el texto con el que debe responder el agente. |
disabled |
Es opcional. Indica si la respuesta está inhabilitada. El agente no usa las respuestas inhabilitadas. |
TransferAgent
| Representación JSON |
|---|
{ "agent": string } |
| Campos | |
|---|---|
agent |
Obligatorio. Es el nombre del agente al que se transferirá la conversación. El agente debe estar en la misma app que el agente actual. Formato: |
GenerativeAnswer
| Representación JSON |
|---|
{ "prompt": string } |
| Campos | |
|---|---|
prompt |
Obligatorio. Es la instrucción que se usará para la respuesta generativa. |
Marca de tiempo
| Representación JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Campos | |
|---|---|
seconds |
Representa los segundos del horario UTC desde el tiempo Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799 inclusive (lo que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z). |
nanos |
Fracciones no negativas de un segundo a una resolución de nanosegundos. Este campo es la parte de nanosegundos de la duración, no una alternativa a los segundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Deben ser valores de 0 a 999,999,999 inclusive. |
MatchType
Es el tipo de concordancia del filtro de contenido.
| Enums | |
|---|---|
MATCH_TYPE_UNSPECIFIED |
No se especificó el tipo de concordancia. |
SIMPLE_STRING_MATCH |
El contenido se compara con las subcadenas carácter por carácter. |
WORD_BOUNDARY_STRING_MATCH |
El contenido solo coincide si el patrón que se encuentra en el texto está rodeado de delimitadores de palabras. Las frases prohibidas también pueden contener delimitadores de palabras. |
REGEXP_MATCH |
El contenido se compara con la sintaxis de expresiones regulares. |
SENSITIVE_WORDS |
El contenido se compara con una lista de palabras y frases sensibles administrada por el sistema. Si adjuntas una barandilla con este tipo de coincidencia a una app o un agente, se reemplazará el filtro predeterminado de palabras sensibles para los agentes afectados. Inhabilita la barandilla para inhabilitar el filtro predeterminado. |
ThinkingLevel
Es la configuración del nivel de razonamiento del modelo.
| Enums | |
|---|---|
THINKING_LEVEL_UNSPECIFIED |
No se especificó el nivel de pensamiento. |
DEFAULT |
Nivel de razonamiento predeterminado. |
LOW |
Nivel de razonamiento bajo. |
MEDIUM |
Nivel de razonamiento medio. |
HIGH |
Nivel de razonamiento alto. |
PolicyScope
Define cuándo aplicar la verificación de la política durante la conversación.
| Enums | |
|---|---|
POLICY_SCOPE_UNSPECIFIED |
No se especificó el permiso de la política. |
USER_QUERY |
La verificación de políticas se activa con la entrada del usuario. |
AGENT_RESPONSE |
La verificación de políticas se activa en la respuesta del agente. Aplicar este permiso de política generará latencia adicional antes de que el agente pueda responder. |
USER_QUERY_AND_AGENT_RESPONSE |
La verificación de políticas se activa tanto en la entrada del usuario como en la respuesta del agente. Aplicar este permiso de política generará latencia adicional antes de que el agente pueda responder. |
HarmCategory
Categoría de daño.
| Enums | |
|---|---|
HARM_CATEGORY_UNSPECIFIED |
No se especifica la categoría de daño. |
HARM_CATEGORY_HATE_SPEECH |
La categoría de daño es la incitación al odio o a la violencia. |
HARM_CATEGORY_DANGEROUS_CONTENT |
La categoría de daño es el contenido peligroso. |
HARM_CATEGORY_HARASSMENT |
La categoría de daño es el hostigamiento. |
HARM_CATEGORY_SEXUALLY_EXPLICIT |
La categoría de daño es el contenido sexual explícito. |
HARM_CATEGORY_PROFANITY |
La categoría de daño es el lenguaje obsceno. |
HARM_CATEGORY_TOXIC |
La categoría de daño es tóxica. |
HarmBlockThreshold
Niveles de umbral basados en la probabilidad para el bloqueo.
| Enums | |
|---|---|
HARM_BLOCK_THRESHOLD_UNSPECIFIED |
Umbral de bloqueo de daño no especificado. |
BLOCK_LOW_AND_ABOVE |
Bloquea el umbral bajo y superior (es decir, bloquea más). |
BLOCK_MEDIUM_AND_ABOVE |
Bloquea el umbral medio y superior. |
BLOCK_ONLY_HIGH |
Bloquea solo el umbral alto (es decir, bloquea menos). |
BLOCK_NONE |
No bloquear. |
OFF |
Desactiva el filtro de seguridad. |
Tipo
Es el tipo de supervisor.
| Enums | |
|---|---|
TYPE_UNSPECIFIED |
El tipo no está especificado. |
INVALID_TEXT |
Tipo de problema de texto no válido. |
LANGUAGE_SHIFT |
Es el tipo de problema de cambio de idioma. |
SPEAKER_SHIFT |
Es el tipo de problema de cambio de interlocutor. |
AUDIO_MISMATCH |
Tipo de problema de discrepancia de audio. |
MISSING_TOOL_CALL |
Falta el tipo de problema de llamada a la herramienta. |
CUSTOM |
Tipo de problema personalizado. |
CHOPPY_AUDIO |
Tipo de problema de audio entrecortado. |
PROFANITY |
Es el tipo de problema de lenguaje obsceno del agente. |
DetectionMode
Es el modo de detección del supervisor.
| Enums | |
|---|---|
DETECTION_MODE_UNSPECIFIED |
No se especificó el modo de detección. El valor predeterminado es NON_BLOCKING. |
NON_BLOCKING |
Modo de detección sin bloqueo. La respuesta no se bloquea cuando la detección del supervisor está en curso. |
BLOCKING |
Modo de detección de bloqueo. La respuesta se bloquea cuando la detección del supervisor está en curso. |
Esquema de salida
La barrera de seguridad contiene una lista de verificaciones y balances para mantener a los agentes seguros.
Barrera de protección
| Representación JSON |
|---|
{ "name": string, "displayName": string, "description": string, "enabled": boolean, "action": { object ( |
| Campos | |
|---|---|
name |
Es el identificador. Es el identificador único de la barandilla de seguridad. Formato: |
displayName |
Obligatorio. Es el nombre visible de la barandilla. |
description |
Es opcional. Descripción de la barrera de seguridad. |
enabled |
Es opcional. Indica si la barandilla está habilitada. |
action |
Es opcional. Es la acción que se debe realizar cuando se activa la barrera de protección. |
createTime |
Solo salida. Es la marca de tiempo de la creación de la barandilla de seguridad. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
updateTime |
Solo salida. Marca de tiempo de la última actualización de la barandilla. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
etag |
Es la etiqueta de entidad que se usa para garantizar que el objeto no haya cambiado durante una operación de lectura, modificación y escritura. Si la etag está vacía, la actualización reemplazará cualquier cambio simultáneo. |
Campo de unión guardrail_type. Es el tipo de barrera de seguridad. guardrail_type puede ser solo uno de los parámetros siguientes: |
|
contentFilter |
Es opcional. Es una barrera que prohíbe que se use cierto contenido en la conversación. |
llmPromptSecurity |
Es opcional. Es una protección que bloquea la conversación si la instrucción se considera no segura según la clasificación del LLM. |
llmPolicy |
Es opcional. Es la barrera que bloquea la conversación si se considera que la respuesta del LLM incumple la política según la clasificación del LLM. |
modelSafety |
Es opcional. Es una protección que bloquea la conversación si la respuesta del LLM se considera no segura según la configuración de seguridad del modelo. |
codeCallback |
Es opcional. Es una barrera de protección que puede bloquear la conversación según el resultado de la ejecución de la devolución de llamada. |
supervisor |
Es opcional. Es la protección que ejecuta la intervención del supervisor. |
ContentFilter
| Representación JSON |
|---|
{
"bannedContents": [
string
],
"bannedContentsInUserInput": [
string
],
"bannedContentsInAgentResponse": [
string
],
"matchType": enum ( |
| Campos | |
|---|---|
bannedContents[] |
Es opcional. Lista de frases prohibidas. Se aplica tanto a las entradas del usuario como a las respuestas del agente. |
bannedContentsInUserInput[] |
Es opcional. Lista de frases prohibidas. Solo se aplica a las entradas de los usuarios. |
bannedContentsInAgentResponse[] |
Es opcional. Lista de frases prohibidas. Solo se aplica a las respuestas del agente. |
matchType |
Obligatorio. Es el tipo de concordancia del filtro de contenido. |
disregardDiacritics |
Es opcional. Si es verdadero, se ignoran los signos diacríticos durante la coincidencia. |
sensitiveWordsExemptions[] |
Es opcional. Son las entradas de la lista de palabras sensibles que permite esta barandilla de seguridad. Solo es válido cuando match_type es SENSITIVE_WORDS. Cada valor debe ser igual a una entrada de la lista (no distingue mayúsculas de minúsculas, se ignoran los espacios en blanco circundantes); los demás valores no tienen efecto. Se aplica solo a esta barandilla de seguridad. Un máximo de 1,000 entradas de hasta 256 caracteres cada una. |
LlmPromptSecurity
| Representación JSON |
|---|
{ "failOpen": boolean, // Union field |
| Campos | |
|---|---|
failOpen |
Es opcional. Determina el comportamiento cuando la barrera de seguridad encuentra un error de LLM. - Si es verdadero, se omite la barrera de protección. - Si es falso (predeterminado), la barandilla se activa o bloquea. Nota: Si se proporciona una política personalizada, este campo se ignora en favor de la configuración "fail_open" de la política. |
Campo de unión security_config. Define el modo de configuración de seguridad. El usuario debe elegir una de las siguientes opciones de configuración. security_config puede ser solo uno de los parámetros siguientes: |
|
defaultSettings |
Es opcional. Usa la configuración de seguridad predeterminada del sistema. Para seleccionar este modo, incluye un mensaje "default_settings" vacío en la solicitud. El servidor completará el campo "default_prompt_template" en la respuesta. |
customPolicy |
Es opcional. Usa una LlmPolicy definida por el usuario para configurar la barrera de seguridad. |
DefaultSecuritySettings
| Representación JSON |
|---|
{ "defaultPromptTemplate": string } |
| Campos | |
|---|---|
defaultPromptTemplate |
Solo salida. Es la plantilla de instrucciones predeterminada que usa el sistema. Este campo tiene fines de visualización para mostrarle al usuario qué instrucción usa el sistema de forma predeterminada. Es OUTPUT_ONLY. |
LlmPolicy
| Representación JSON |
|---|
{ "maxConversationMessages": integer, "modelSettings": { object ( |
| Campos | |
|---|---|
maxConversationMessages |
Es opcional. Cuando verifiques esta política, considera los últimos "n" mensajes de la conversación. Si no se establece, se usará un valor predeterminado de 10. |
modelSettings |
Es opcional. Configuración del modelo |
prompt |
Obligatorio. Mensaje de política. Admite marcadores de posición de variables de sesión ( |
policyScope |
Obligatorio. Define cuándo aplicar la verificación de la política durante la conversación. Si se establece en |
failOpen |
Es opcional. Si se produce un error durante la verificación de la política, se produce un error de apertura y no se activa la barandilla. |
allowShortUtterance |
Es opcional. De forma predeterminada, la verificación de la política de LLM se omite para las expresiones cortas. Si habilitas este parámetro de configuración, se aplicará la verificación de políticas a todas las expresiones, incluidas las que normalmente se omitirían. |
ModelSettings
| Representación JSON |
|---|
{ "model": string, "thinkingLevel": enum ( |
| Campos | |
|---|---|
model |
Es opcional. Es el modelo de LLM que debe usar el agente. Si no se establece, el agente heredará el modelo de su agente superior. |
thinkingLevel |
Es opcional. Es el nivel de razonamiento del modelo. |
Campo de unión
|
|
temperature |
Es opcional. Si se establece, se usará esta temperatura para el modelo de LLM. La temperatura controla la aleatoriedad de las respuestas del modelo. Las temperaturas más bajas producen respuestas más predecibles. Las temperaturas más altas producen respuestas más creativas. |
ModelSafety
| Representación JSON |
|---|
{
"safetySettings": [
{
object ( |
| Campos | |
|---|---|
safetySettings[] |
Obligatorio. Lista de parámetros de configuración de seguridad. |
SafetySetting
| Representación JSON |
|---|
{ "category": enum ( |
| Campos | |
|---|---|
category |
Obligatorio. La categoría de daño. |
threshold |
Obligatorio. El umbral de bloqueo de daño. |
CodeCallback
| Representación JSON |
|---|
{ "beforeAgentCallback": { object ( |
| Campos | |
|---|---|
beforeAgentCallback |
Es opcional. Es la devolución de llamada que se ejecutará antes de que se llame al agente. Se espera que cada función de devolución de llamada devuelva una estructura (p.ej., un diccionario o un objeto) que contenga, al menos, lo siguiente: - 'decision': 'OK' o 'TRIGGER'. - "reason": Una cadena que explica la decisión. Una decisión de "ACTIVACIÓN" puede detener el procesamiento posterior. |
afterAgentCallback |
Es opcional. Es la devolución de llamada que se ejecutará después de que se llame al agente. Se espera que cada función de devolución de llamada devuelva una estructura (p.ej., un diccionario o un objeto) que contenga, al menos, lo siguiente: - 'decision': 'OK' o 'TRIGGER'. - "reason": Una cadena que explica la decisión. Una decisión de "ACTIVACIÓN" puede detener el procesamiento posterior. |
beforeModelCallback |
Es opcional. Es la devolución de llamada que se ejecutará antes de que se llame al modelo. Si hay varias llamadas al modelo, la devolución de llamada se ejecutará varias veces. Se espera que cada función de devolución de llamada devuelva una estructura (p.ej., un diccionario o un objeto) que contenga, al menos, lo siguiente: - 'decision': 'OK' o 'TRIGGER'. - "reason": Una cadena que explica la decisión. Una decisión de "ACTIVACIÓN" puede detener el procesamiento posterior. |
afterModelCallback |
Es opcional. Es la devolución de llamada que se ejecutará después de que se llame al modelo. Si hay varias llamadas al modelo, la devolución de llamada se ejecutará varias veces. Se espera que cada función de devolución de llamada devuelva una estructura (p.ej., un diccionario o un objeto) que contenga, al menos, lo siguiente: - 'decision': 'OK' o 'TRIGGER'. - "reason": Una cadena que explica la decisión. Una decisión de "ACTIVACIÓN" puede detener el procesamiento posterior. |
Devolución de llamada
| Representación JSON |
|---|
{ "description": string, "disabled": boolean, "proactiveExecutionEnabled": boolean, // Union field |
| Campos | |
|---|---|
description |
Es opcional. Es una descripción legible por humanos de la devolución de llamada. |
disabled |
Es opcional. Indica si la devolución de llamada está inhabilitada. El agente ignora las devoluciones de llamada inhabilitadas. |
proactiveExecutionEnabled |
Es opcional. Si se habilita, la devolución de llamada también se ejecutará en los resultados intermedios del modelo. Este parámetro de configuración solo afecta a la devolución de llamada posterior al modelo. HABILITA CON PRECAUCIÓN. Por lo general, la devolución de llamada After model solo debe ejecutarse después de recibir todas las respuestas del modelo. Habilitar la ejecución proactiva puede tener implicaciones negativas en el costo y la latencia de la ejecución, y solo debe habilitarse en situaciones excepcionales. |
Campo de unión callback. Es la devolución de llamada que se ejecutará. callback puede ser solo uno de los parámetros siguientes: |
|
pythonCode |
Obligatorio. Es el código de Python que se ejecutará para la devolución de llamada. |
Supervisor
| Representación JSON |
|---|
{ "type": enum ( |
| Campos | |
|---|---|
type |
Es opcional. Es el tipo de supervisor. |
detectionMode |
Es opcional. Es el modo de detección del supervisor. |
TriggerAction
| Representación JSON |
|---|
{ // Union field |
| Campos | |
|---|---|
Campo de unión action. La acción por realizar. action puede ser solo uno de los parámetros siguientes: |
|
respondImmediately |
Es opcional. Responde de inmediato con una respuesta preconfigurada. |
transferAgent |
Es opcional. Transferir la conversación a otro agente |
generativeAnswer |
Es opcional. Responder con una respuesta generativa |
RespondImmediately
| Representación JSON |
|---|
{
"responses": [
{
object ( |
| Campos | |
|---|---|
responses[] |
Obligatorio. Son las respuestas estándares entre las que puede elegir el agente. La respuesta se elige de forma aleatoria. |
Respuesta
| Representación JSON |
|---|
{ "text": string, "disabled": boolean } |
| Campos | |
|---|---|
text |
Obligatorio. Es el texto con el que debe responder el agente. |
disabled |
Es opcional. Indica si la respuesta está inhabilitada. El agente no usa las respuestas inhabilitadas. |
TransferAgent
| Representación JSON |
|---|
{ "agent": string } |
| Campos | |
|---|---|
agent |
Obligatorio. Es el nombre del agente al que se transferirá la conversación. El agente debe estar en la misma app que el agente actual. Formato: |
GenerativeAnswer
| Representación JSON |
|---|
{ "prompt": string } |
| Campos | |
|---|---|
prompt |
Obligatorio. Es la instrucción que se usará para la respuesta generativa. |
Marca de tiempo
| Representación JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Campos | |
|---|---|
seconds |
Representa los segundos del horario UTC desde el tiempo Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799 inclusive (lo que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z). |
nanos |
Fracciones no negativas de un segundo a una resolución de nanosegundos. Este campo es la parte de nanosegundos de la duración, no una alternativa a los segundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Deben ser valores de 0 a 999,999,999 inclusive. |
MatchType
Es el tipo de concordancia del filtro de contenido.
| Enums | |
|---|---|
MATCH_TYPE_UNSPECIFIED |
No se especificó el tipo de concordancia. |
SIMPLE_STRING_MATCH |
El contenido se compara con las subcadenas carácter por carácter. |
WORD_BOUNDARY_STRING_MATCH |
El contenido solo coincide si el patrón que se encuentra en el texto está rodeado de delimitadores de palabras. Las frases prohibidas también pueden contener delimitadores de palabras. |
REGEXP_MATCH |
El contenido se compara con la sintaxis de expresiones regulares. |
SENSITIVE_WORDS |
El contenido se compara con una lista de palabras y frases sensibles administrada por el sistema. Si adjuntas una barandilla con este tipo de coincidencia a una app o un agente, se reemplazará el filtro predeterminado de palabras sensibles para los agentes afectados. Inhabilita la barandilla para inhabilitar el filtro predeterminado. |
ThinkingLevel
Es la configuración del nivel de razonamiento del modelo.
| Enums | |
|---|---|
THINKING_LEVEL_UNSPECIFIED |
No se especificó el nivel de pensamiento. |
DEFAULT |
Nivel de razonamiento predeterminado. |
LOW |
Nivel de razonamiento bajo. |
MEDIUM |
Nivel de razonamiento medio. |
HIGH |
Nivel de razonamiento alto. |
PolicyScope
Define cuándo aplicar la verificación de la política durante la conversación.
| Enums | |
|---|---|
POLICY_SCOPE_UNSPECIFIED |
No se especificó el permiso de la política. |
USER_QUERY |
La verificación de políticas se activa con la entrada del usuario. |
AGENT_RESPONSE |
La verificación de políticas se activa en la respuesta del agente. Aplicar este permiso de política generará latencia adicional antes de que el agente pueda responder. |
USER_QUERY_AND_AGENT_RESPONSE |
La verificación de políticas se activa tanto en la entrada del usuario como en la respuesta del agente. Aplicar este permiso de política generará latencia adicional antes de que el agente pueda responder. |
HarmCategory
Categoría de daño.
| Enums | |
|---|---|
HARM_CATEGORY_UNSPECIFIED |
No se especifica la categoría de daño. |
HARM_CATEGORY_HATE_SPEECH |
La categoría de daño es la incitación al odio o a la violencia. |
HARM_CATEGORY_DANGEROUS_CONTENT |
La categoría de daño es el contenido peligroso. |
HARM_CATEGORY_HARASSMENT |
La categoría de daño es el hostigamiento. |
HARM_CATEGORY_SEXUALLY_EXPLICIT |
La categoría de daño es el contenido sexual explícito. |
HARM_CATEGORY_PROFANITY |
La categoría de daño es el lenguaje obsceno. |
HARM_CATEGORY_TOXIC |
La categoría de daño es tóxica. |
HarmBlockThreshold
Niveles de umbral basados en la probabilidad para el bloqueo.
| Enums | |
|---|---|
HARM_BLOCK_THRESHOLD_UNSPECIFIED |
Umbral de bloqueo de daño no especificado. |
BLOCK_LOW_AND_ABOVE |
Bloquea el umbral bajo y superior (es decir, bloquea más). |
BLOCK_MEDIUM_AND_ABOVE |
Bloquea el umbral medio y superior. |
BLOCK_ONLY_HIGH |
Bloquea solo el umbral alto (es decir, bloquea menos). |
BLOCK_NONE |
No bloquear. |
OFF |
Desactiva el filtro de seguridad. |
Tipo
Es el tipo de supervisor.
| Enums | |
|---|---|
TYPE_UNSPECIFIED |
El tipo no está especificado. |
INVALID_TEXT |
Tipo de problema de texto no válido. |
LANGUAGE_SHIFT |
Es el tipo de problema de cambio de idioma. |
SPEAKER_SHIFT |
Es el tipo de problema de cambio de interlocutor. |
AUDIO_MISMATCH |
Tipo de problema de discrepancia de audio. |
MISSING_TOOL_CALL |
Falta el tipo de problema de llamada a la herramienta. |
CUSTOM |
Tipo de problema personalizado. |
CHOPPY_AUDIO |
Tipo de problema de audio entrecortado. |
PROFANITY |
Es el tipo de problema de lenguaje obsceno del agente. |
DetectionMode
Es el modo de detección del supervisor.
| Enums | |
|---|---|
DETECTION_MODE_UNSPECIFIED |
No se especificó el modo de detección. El valor predeterminado es NON_BLOCKING. |
NON_BLOCKING |
Modo de detección sin bloqueo. La respuesta no se bloquea cuando la detección del supervisor está en curso. |
BLOCKING |
Modo de detección de bloqueo. La respuesta se bloquea cuando la detección del supervisor está en curso. |
Anotaciones de herramientas
Las anotaciones de herramientas se envían a los clientes de MCP para describir el riesgo básico de una herramienta determinada. La mayoría de los clientes tratan estas sugerencias como no confiables, pero se pueden usar para decidir cuándo se puede enviar un mensaje de confirmación a un usuario.
Junto con la cadena de título, las siguientes sugerencias booleanas se definen de la siguiente manera:
readOnlyHint: Si es verdadero, la herramienta no modifica su entorno. Valor predeterminado: false.destructiveHint: Si es verdadero, la herramienta puede realizar acciones destructivas. Si es falso, la herramienta solo puede realizar acciones aditivas. Valor predeterminado: true.idempotentHint: Si es verdadero, llamar a la herramienta de forma repetida con los mismos argumentos no tendrá ningún efecto adicional en su entorno. Valor predeterminado: false.openWorldHint: Si es verdadero, la herramienta puede interactuar con un "mundo abierto" de entidades externas. Si es falso, la herramienta solo puede interactuar con entidades internas. Por ejemplo, una herramienta de búsqueda web sería de mundo abierto, mientras que una herramienta de memoria no lo sería.
Sugerencia destructiva: ✅ | Sugerencia idempotente: ❌ | Sugerencia de solo lectura: ❌ | Sugerencia de mundo abierto: ❌