MCP Tools Reference: ces.googleapis.com

Herramienta: create_deployment

Crea una implementación nueva en la app especificada.

En la siguiente muestra de código, se muestra cómo usar curl para llamar a la herramienta de MCP create_deployment.

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_deployment",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensaje de solicitud para AgentService.CreateDeployment.

CreateDeploymentRequest

Representación JSON 
{
  "parent": string,
  "deploymentId": string,
  "deployment": {
    object (Deployment)
  }
}
Campos
parent

string

Obligatorio. Es la app principal. El formato es projects/{project}/locations/{location}/apps/{app}.
deploymentId

string

Es opcional. Es el ID que se usará para la implementación, que se convertirá en el componente final del nombre del recurso de la implementación. Si no se proporciona, se asignará automáticamente un ID único para la implementación.
deployment

object (Deployment)

Obligatorio. Es la implementación que se creará.

Implementación

Representación JSON 
{
  "name": string,
  "displayName": string,
  "appVersion": string,
  "channelProfile": {
    object (ChannelProfile)
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "experimentConfig": {
    object (ExperimentConfig)
  },
  "whatsappCredentials": {
    object (WhatsAppCredentials)
  },
  "instagramCredentials": {
    object (InstagramCredentials)
  },
  "modelSettings": {
    object (ModelSettings)
  },
  "modality": enum (Modality),
  "agentRegistryDeployment": {
    object (AgentRegistryDeployment)
  }
}
Campos
name

string

Es el identificador. Es el nombre del recurso de la implementación. Formato: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
displayName

string

Obligatorio. Es el nombre visible de la implementación.
appVersion

string

Es opcional. Es el nombre del recurso de la versión de la app que se implementará. Formato: projects/{project}/locations/{location}/apps/{app}/versions/{version} Usa projects/{project}/locations/{location}/apps/{app}/versions/- para usar la app en borrador.
channelProfile

object (ChannelProfile)

Obligatorio. Es el perfil del canal que se usa en la implementación.
createTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la creación de esta implementación.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la última actualización de esta implementación.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
etag

string

Solo salida. Es el ETag que se usa para garantizar que el objeto no haya cambiado durante una operación de lectura-modificación-escritura. Si el ETag está vacío, la actualización reemplazará cualquier cambio simultáneo.
experimentConfig

object (ExperimentConfig)

Es opcional. Es la configuración del experimento para la implementación.
whatsappCredentials

object (WhatsAppCredentials)

Es opcional. Solo entrada. Se requieren credenciales efímeras de WhatsApp cuando se configura un perfil de canal de WhatsApp.
instagramCredentials

object (InstagramCredentials)

Es opcional. Solo entrada. Se requieren credenciales efímeras de Instagram cuando se configura un perfil de canal de Instagram.
modelSettings

object (ModelSettings)

Es opcional. Es la configuración del modelo para la implementación. Anula la configuración del modelo establecida a nivel de la app o del agente. Nota: El reemplazo de la configuración del modelo a nivel de la Deployment está restringido por una lista de entidades permitidas. Comunícate con el equipo de CXAS para habilitar este campo.
modality

enum (Modality)

Es opcional. Es la modalidad de la implementación. Nota: La anulación de la modalidad a nivel de la Deployment está controlada por una lista de entidades permitidas. Comunícate con el equipo de CXAS para habilitar este campo.
agentRegistryDeployment

object (AgentRegistryDeployment)

Es opcional. Es la configuración para implementar esta implementación en Agent Registry. Si está presente, esta implementación se publicará en Agent Registry.

ChannelProfile

Representación JSON 
{
  "profileId": string,
  "channelType": enum (ChannelType),
  "personaProperty": {
    object (PersonaProperty)
  },
  "webWidgetConfig": {
    object (WebWidgetConfig)
  },
  "whatsappConfig": {
    object (WhatsAppConfig)
  },
  "instagramConfig": {
    object (InstagramConfig)
  },

  // Union field _disable_dtmf can be only one of the following:
  "disableDtmf": boolean
  // End of list of possible types for union field _disable_dtmf.

  // Union field _disable_barge_in_control can be only one of the following:
  "disableBargeInControl": boolean
  // End of list of possible types for union field _disable_barge_in_control.

  // Union field _noise_suppression_level can be only one of the following:
  "noiseSuppressionLevel": string
  // End of list of possible types for union field _noise_suppression_level.
}
Campos
profileId

string

Es opcional. Es el identificador único del perfil del canal.
channelType

enum (ChannelType)

Es opcional. Es el tipo de perfil del canal.
personaProperty

object (PersonaProperty)

Es opcional. Es la propiedad de arquetipo del perfil del canal.
webWidgetConfig

object (WebWidgetConfig)

Es opcional. Es la configuración del widget web.
whatsappConfig

object (WhatsAppConfig)

Es opcional. Es la configuración específica de las implementaciones de WhatsApp.
instagramConfig

object (InstagramConfig)

Es opcional. Es la configuración específica de las implementaciones de Instagram.

Campo de unión _disable_dtmf.

_disable_dtmf puede ser una de las siguientes opciones:
disableDtmf

boolean

Es opcional. Indica si se debe inhabilitar el DTMF (multifrecuencia de dos tonos).

Campo de unión _disable_barge_in_control.

_disable_barge_in_control puede ser una de las siguientes opciones:
disableBargeInControl

boolean

Es opcional. Indica si se debe inhabilitar el control de interrupción del usuario en la conversación. - true: Las interrupciones del usuario están inhabilitadas mientras el agente habla. - false: El agente conserva el control automático sobre cuándo puede interrumpir el usuario.

Campo de unión _noise_suppression_level.

_noise_suppression_level puede ser una de las siguientes opciones:
noiseSuppressionLevel

string

Es opcional. Es el nivel de reducción de ruido del perfil del canal. Los valores disponibles son "low", "moderate", "high" y "very_high".

PersonaProperty

Representación JSON 
{
  "persona": enum (Persona)
}
Campos
persona

enum (Persona)

Es opcional. Es el arquetipo del canal.

WebWidgetConfig

Representación JSON 
{
  "modality": enum (Modality),
  "theme": enum (Theme),
  "webWidgetTitle": string,
  "securitySettings": {
    object (SecuritySettings)
  }
}
Campos
modality

enum (Modality)

Es opcional. Es la modalidad del widget web.
theme

enum (Theme)

Es opcional. Es el tema del widget web.
webWidgetTitle

string

Es opcional. Es el título del widget web.
securitySettings

object (SecuritySettings)

Es opcional. Es la configuración de seguridad del widget web.

SecuritySettings

Representación JSON 
{
  "enablePublicAccess": boolean,
  "enableOriginCheck": boolean,
  "allowedOrigins": [
    string
  ],
  "enableRecaptcha": boolean
}
Campos
enablePublicAccess

boolean

Es opcional. Indica si está habilitado el acceso público al widget web. Si es true, el widget web será de acceso público. Si es false, el widget web debe integrarse con tu propio sistema de autenticación y autorización para devolver credenciales válidas para acceder al agente de CES.
enableOriginCheck

boolean

Es opcional. Indica si está habilitada la verificación de origen para el widget web. Si es true, el widget web verificará el origen del sitio web que carga el widget web y solo permitirá que se cargue en el mismo origen o en cualquiera de los orígenes permitidos.
allowedOrigins[]

string

Es opcional. Son los orígenes que pueden alojar el widget web. Un origen se define en el RFC 6454. Si está vacío, se permiten todos los orígenes. Se permite un máximo de 100 orígenes. Ejemplo: "https://example.com"
enableRecaptcha

boolean

Es opcional. Indica si está habilitada la verificación de reCAPTCHA para el widget web.

WhatsAppConfig

Representación JSON 
{
  "wabaId": string,
  "phoneNumberId": string,
  "phoneNumber": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
Campos
wabaId

string

Obligatorio. Es el ID de la cuenta de WhatsApp Business.
phoneNumberId

string

Obligatorio. Es el ID del número de teléfono de Meta.
phoneNumber

string

Es opcional. Número de teléfono en formato E.164.
displayName

string

Solo salida. Es el nombre de la página comercial de Meta recuperada.
thumbnailUrl

string

Solo salida. Es la URL de la miniatura del perfil de la empresa de Meta recuperada.
description

string

Solo salida. Es la descripción de la página o el perfil comercial de Meta.

InstagramConfig

Representación JSON 
{
  "instagramAccountId": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
Campos
instagramAccountId

string

Obligatorio. Es el ID de la cuenta de Instagram.
displayName

string

Solo salida. Es el nombre de la página comercial de Meta recuperada.
thumbnailUrl

string

Solo salida. Es la URL de la miniatura del perfil de la empresa de Meta recuperada.
description

string

Solo salida. Es la descripción de la página o el perfil comercial de Meta.

Marca de tiempo

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

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

integer

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. Debe ser un valor entre 0 y 999,999,999, inclusive.

ExperimentConfig

Representación JSON 
{
  "versionRelease": {
    object (VersionRelease)
  }
}
Campos
versionRelease

object (VersionRelease)

Es opcional. Es la versión de lanzamiento del experimento.

VersionRelease

Representación JSON 
{
  "state": enum (State),
  "trafficAllocations": [
    {
      object (TrafficAllocation)
    }
  ]
}
Campos
state

enum (State)

Es opcional. Es el estado de la versión.
trafficAllocations[]

object (TrafficAllocation)

Es opcional. Son las asignaciones de tráfico para el lanzamiento de la versión.

TrafficAllocation

Representación JSON 
{
  "id": string,
  "trafficPercentage": integer,
  "appVersion": string
}
Campos
id

string

Es opcional. Es el ID de la asignación de tráfico. Es una cadena de formato libre de hasta 128 caracteres.
trafficPercentage

integer

Es opcional. Es el porcentaje de tráfico de la asignación de tráfico. Debe estar entre 0 y 100.
appVersion

string

Es opcional. Es la versión de la app de la asignación de tráfico. Formato: projects/{project}/locations/{location}/apps/{app}/versions/{version}

WhatsAppCredentials

Representación JSON 
{
  "authCode": string,
  "pin": string,
  "phoneNumber": string,
  "businessAccountId": string,
  "wabaId": string,
  "conversationProfileId": string
}
Campos
authCode

string

Obligatorio. Es el código de autorización de Meta que proporciona el flujo de registro integrado.
pin

string

Obligatorio. Es el PIN de 6 dígitos que creó el usuario para la verificación en dos pasos.
phoneNumber

string

Obligatorio. Número de teléfono con el que se registrará en WhatsApp.
businessAccountId

string

Obligatorio. Es el ID de la cuenta comercial que se usará para el número de teléfono.
wabaId

string

Obligatorio. Es el ID de la cuenta de WhatsApp Business.
conversationProfileId

string

Es opcional. Es el ID del perfil de conversación que se usará para la implementación.

InstagramCredentials

Representación JSON 
{
  "authCode": string,
  "conversationProfileId": string
}
Campos
authCode

string

Obligatorio. Es el código de autorización de Meta que proporciona el flujo de registro integrado.
conversationProfileId

string

Es opcional. Es el ID del perfil de conversación que se usará para la implementación.

ModelSettings

Representación JSON 
{
  "model": string,
  "thinkingLevel": enum (ThinkingLevel),

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

string

Es opcional. Es el modelo LLM que debe usar el agente. Si no se configura, el agente heredará el modelo de su agente superior.
thinkingLevel

enum (ThinkingLevel)

Es opcional. Es el nivel de razonamiento del modelo.

Campo de unión _temperature.

_temperature puede ser una de las siguientes opciones:
temperature

number

Es opcional. Si se configura, esta temperatura se usará 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.

AgentRegistryDeployment

Representación JSON 
{
  "agentRegistryServiceName": string
}
Campos
agentRegistryServiceName

string

Es opcional. Solo salida. Es el nombre del recurso del servicio de Agent Registry implementado. Formato: projects/{project}/locations/{location}/services/{service}

ChannelType

Es el tipo de perfil del canal.

Enums
UNKNOWN Tipo de canal desconocido.
WEB_UI Es el canal de la IU web.
API Canal de API
TWILIO Canal de Twilio.
GOOGLE_TELEPHONY_PLATFORM Canal de la Plataforma de Telefonía de Google.
CONTACT_CENTER_AS_A_SERVICE Canal de centro de contacto como servicio (CCaaS).
CONTACT_CENTER_AS_A_SERVICE_CHAT Canal de centro de contacto como servicio (CCaaS Chat).
FIVE9 Canal de Five9.
CONTACT_CENTER_INTEGRATION Canal de integración de centros de contacto de terceros.
WHATSAPP Canal de WhatsApp
INSTAGRAM Canal de Instagram

Personificación

Es el arquetipo del canal.

Enums
UNKNOWN Arquetipo DESCONOCIDO.
CONCISE El agente mantiene las respuestas concisas y específicas.
CHATTY El agente proporciona contexto, explicaciones y detalles adicionales.

Modalidad

Es la modalidad del widget web.

Enums
MODALITY_UNSPECIFIED Modalidad desconocida.
CHAT_AND_VOICE El widget admite la entrada de voz y chat.
VOICE_ONLY El widget solo admite entrada de voz.
CHAT_ONLY El widget solo admite la entrada de chat.
CHAT_VOICE_AND_VIDEO El widget admite entradas de chat, voz y video.

Tema

Es el tema del widget web.

Enums
THEME_UNSPECIFIED Tema desconocido.
LIGHT Tema claro
DARK Tema oscuro

Estado

Es el estado del experimento.

Enums
STATE_UNSPECIFIED Significa que el estado no se especificó.
PENDING Obsoleto: Este estado ya no se usa.
RUNNING Estado de ejecución. El experimento se está ejecutando y es válido.
DONE Obsoleto: Este estado ya no se usa.
EXPIRED Obsoleto: Este estado ya no se usa.

ThinkingLevel

Es la configuración del nivel de razonamiento del modelo.

Enums
THINKING_LEVEL_UNSPECIFIED El nivel de pensamiento no está especificado.
DEFAULT Es el nivel de razonamiento predeterminado.
LOW Nivel de razonamiento bajo.
MEDIUM Nivel de razonamiento medio.
HIGH Nivel de razonamiento alto.

Modalidad

Es la modalidad de la implementación.

Enums
MODALITY_UNSPECIFIED Modalidad desconocida.
MODALITY_TEXT Modalidad de texto.
MODALITY_VOICE Modalidad de voz.
MODALITY_VIDEO Modalidad de video.

Esquema de salida

Una implementación representa una versión inmutable de la app que se puede consultar. Se usa para implementar una versión de la app con un perfil de canal específico.

Implementación

Representación JSON 
{
  "name": string,
  "displayName": string,
  "appVersion": string,
  "channelProfile": {
    object (ChannelProfile)
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "experimentConfig": {
    object (ExperimentConfig)
  },
  "whatsappCredentials": {
    object (WhatsAppCredentials)
  },
  "instagramCredentials": {
    object (InstagramCredentials)
  },
  "modelSettings": {
    object (ModelSettings)
  },
  "modality": enum (Modality),
  "agentRegistryDeployment": {
    object (AgentRegistryDeployment)
  }
}
Campos
name

string

Es el identificador. Es el nombre del recurso de la implementación. Formato: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
displayName

string

Obligatorio. Es el nombre visible de la implementación.
appVersion

string

Es opcional. Es el nombre del recurso de la versión de la app que se implementará. Formato: projects/{project}/locations/{location}/apps/{app}/versions/{version} Usa projects/{project}/locations/{location}/apps/{app}/versions/- para usar la app en borrador.
channelProfile

object (ChannelProfile)

Obligatorio. Es el perfil del canal que se usa en la implementación.
createTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la creación de esta implementación.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la última actualización de esta implementación.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
etag

string

Solo salida. Es el ETag que se usa para garantizar que el objeto no haya cambiado durante una operación de lectura-modificación-escritura. Si el ETag está vacío, la actualización reemplazará cualquier cambio simultáneo.
experimentConfig

object (ExperimentConfig)

Es opcional. Es la configuración del experimento para la implementación.
whatsappCredentials

object (WhatsAppCredentials)

Es opcional. Solo entrada. Se requieren credenciales efímeras de WhatsApp cuando se configura un perfil de canal de WhatsApp.
instagramCredentials

object (InstagramCredentials)

Es opcional. Solo entrada. Se requieren credenciales efímeras de Instagram cuando se configura un perfil de canal de Instagram.
modelSettings

object (ModelSettings)

Es opcional. Es la configuración del modelo para la implementación. Anula la configuración del modelo establecida a nivel de la app o del agente. Nota: El reemplazo de la configuración del modelo a nivel de la Deployment está restringido por una lista de entidades permitidas. Comunícate con el equipo de CXAS para habilitar este campo.
modality

enum (Modality)

Es opcional. Es la modalidad de la implementación. Nota: La anulación de la modalidad a nivel de la Deployment está controlada por una lista de entidades permitidas. Comunícate con el equipo de CXAS para habilitar este campo.
agentRegistryDeployment

object (AgentRegistryDeployment)

Es opcional. Es la configuración para implementar esta implementación en Agent Registry. Si está presente, esta implementación se publicará en Agent Registry.

ChannelProfile

Representación JSON 
{
  "profileId": string,
  "channelType": enum (ChannelType),
  "personaProperty": {
    object (PersonaProperty)
  },
  "webWidgetConfig": {
    object (WebWidgetConfig)
  },
  "whatsappConfig": {
    object (WhatsAppConfig)
  },
  "instagramConfig": {
    object (InstagramConfig)
  },

  // Union field _disable_dtmf can be only one of the following:
  "disableDtmf": boolean
  // End of list of possible types for union field _disable_dtmf.

  // Union field _disable_barge_in_control can be only one of the following:
  "disableBargeInControl": boolean
  // End of list of possible types for union field _disable_barge_in_control.

  // Union field _noise_suppression_level can be only one of the following:
  "noiseSuppressionLevel": string
  // End of list of possible types for union field _noise_suppression_level.
}
Campos
profileId

string

Es opcional. Es el identificador único del perfil del canal.
channelType

enum (ChannelType)

Es opcional. Es el tipo de perfil del canal.
personaProperty

object (PersonaProperty)

Es opcional. Es la propiedad de arquetipo del perfil del canal.
webWidgetConfig

object (WebWidgetConfig)

Es opcional. Es la configuración del widget web.
whatsappConfig

object (WhatsAppConfig)

Es opcional. Es la configuración específica de las implementaciones de WhatsApp.
instagramConfig

object (InstagramConfig)

Es opcional. Es la configuración específica de las implementaciones de Instagram.

Campo de unión _disable_dtmf.

_disable_dtmf puede ser una de las siguientes opciones:
disableDtmf

boolean

Es opcional. Indica si se debe inhabilitar el DTMF (multifrecuencia de dos tonos).

Campo de unión _disable_barge_in_control.

_disable_barge_in_control puede ser una de las siguientes opciones:
disableBargeInControl

boolean

Es opcional. Indica si se debe inhabilitar el control de interrupción del usuario en la conversación. - true: Las interrupciones del usuario están inhabilitadas mientras el agente habla. - false: El agente conserva el control automático sobre cuándo puede interrumpir el usuario.

Campo de unión _noise_suppression_level.

_noise_suppression_level puede ser una de las siguientes opciones:
noiseSuppressionLevel

string

Es opcional. Es el nivel de reducción de ruido del perfil del canal. Los valores disponibles son "low", "moderate", "high" y "very_high".

PersonaProperty

Representación JSON 
{
  "persona": enum (Persona)
}
Campos
persona

enum (Persona)

Es opcional. Es el arquetipo del canal.

WebWidgetConfig

Representación JSON 
{
  "modality": enum (Modality),
  "theme": enum (Theme),
  "webWidgetTitle": string,
  "securitySettings": {
    object (SecuritySettings)
  }
}
Campos
modality

enum (Modality)

Es opcional. Es la modalidad del widget web.
theme

enum (Theme)

Es opcional. Es el tema del widget web.
webWidgetTitle

string

Es opcional. Es el título del widget web.
securitySettings

object (SecuritySettings)

Es opcional. Es la configuración de seguridad del widget web.

SecuritySettings

Representación JSON 
{
  "enablePublicAccess": boolean,
  "enableOriginCheck": boolean,
  "allowedOrigins": [
    string
  ],
  "enableRecaptcha": boolean
}
Campos
enablePublicAccess

boolean

Es opcional. Indica si está habilitado el acceso público al widget web. Si es true, el widget web será de acceso público. Si es false, el widget web debe integrarse con tu propio sistema de autenticación y autorización para devolver credenciales válidas para acceder al agente de CES.
enableOriginCheck

boolean

Es opcional. Indica si está habilitada la verificación de origen para el widget web. Si es true, el widget web verificará el origen del sitio web que carga el widget web y solo permitirá que se cargue en el mismo origen o en cualquiera de los orígenes permitidos.
allowedOrigins[]

string

Es opcional. Son los orígenes que pueden alojar el widget web. Un origen se define en el RFC 6454. Si está vacío, se permiten todos los orígenes. Se permite un máximo de 100 orígenes. Ejemplo: "https://example.com"
enableRecaptcha

boolean

Es opcional. Indica si está habilitada la verificación de reCAPTCHA para el widget web.

WhatsAppConfig

Representación JSON 
{
  "wabaId": string,
  "phoneNumberId": string,
  "phoneNumber": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
Campos
wabaId

string

Obligatorio. Es el ID de la cuenta de WhatsApp Business.
phoneNumberId

string

Obligatorio. Es el ID del número de teléfono de Meta.
phoneNumber

string

Es opcional. Número de teléfono en formato E.164.
displayName

string

Solo salida. Es el nombre de la página comercial de Meta recuperada.
thumbnailUrl

string

Solo salida. Es la URL de la miniatura del perfil de la empresa de Meta recuperada.
description

string

Solo salida. Es la descripción de la página o el perfil comercial de Meta.

InstagramConfig

Representación JSON 
{
  "instagramAccountId": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
Campos
instagramAccountId

string

Obligatorio. Es el ID de la cuenta de Instagram.
displayName

string

Solo salida. Es el nombre de la página comercial de Meta recuperada.
thumbnailUrl

string

Solo salida. Es la URL de la miniatura del perfil de la empresa de Meta recuperada.
description

string

Solo salida. Es la descripción de la página o el perfil comercial de Meta.

Marca de tiempo

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

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

integer

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. Debe ser un valor entre 0 y 999,999,999, inclusive.

ExperimentConfig

Representación JSON 
{
  "versionRelease": {
    object (VersionRelease)
  }
}
Campos
versionRelease

object (VersionRelease)

Es opcional. Es la versión de lanzamiento del experimento.

VersionRelease

Representación JSON 
{
  "state": enum (State),
  "trafficAllocations": [
    {
      object (TrafficAllocation)
    }
  ]
}
Campos
state

enum (State)

Es opcional. Es el estado de la versión.
trafficAllocations[]

object (TrafficAllocation)

Es opcional. Son las asignaciones de tráfico para el lanzamiento de la versión.

TrafficAllocation

Representación JSON 
{
  "id": string,
  "trafficPercentage": integer,
  "appVersion": string
}
Campos
id

string

Es opcional. Es el ID de la asignación de tráfico. Es una cadena de formato libre de hasta 128 caracteres.
trafficPercentage

integer

Es opcional. Es el porcentaje de tráfico de la asignación de tráfico. Debe estar entre 0 y 100.
appVersion

string

Es opcional. Es la versión de la app de la asignación de tráfico. Formato: projects/{project}/locations/{location}/apps/{app}/versions/{version}

WhatsAppCredentials

Representación JSON 
{
  "authCode": string,
  "pin": string,
  "phoneNumber": string,
  "businessAccountId": string,
  "wabaId": string,
  "conversationProfileId": string
}
Campos
authCode

string

Obligatorio. Es el código de autorización de Meta que proporciona el flujo de registro integrado.
pin

string

Obligatorio. Es el PIN de 6 dígitos que creó el usuario para la verificación en dos pasos.
phoneNumber

string

Obligatorio. Número de teléfono con el que se registrará en WhatsApp.
businessAccountId

string

Obligatorio. Es el ID de la cuenta comercial que se usará para el número de teléfono.
wabaId

string

Obligatorio. Es el ID de la cuenta de WhatsApp Business.
conversationProfileId

string

Es opcional. Es el ID del perfil de conversación que se usará para la implementación.

InstagramCredentials

Representación JSON 
{
  "authCode": string,
  "conversationProfileId": string
}
Campos
authCode

string

Obligatorio. Es el código de autorización de Meta que proporciona el flujo de registro integrado.
conversationProfileId

string

Es opcional. Es el ID del perfil de conversación que se usará para la implementación.

ModelSettings

Representación JSON 
{
  "model": string,
  "thinkingLevel": enum (ThinkingLevel),

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

string

Es opcional. Es el modelo LLM que debe usar el agente. Si no se configura, el agente heredará el modelo de su agente superior.
thinkingLevel

enum (ThinkingLevel)

Es opcional. Es el nivel de razonamiento del modelo.

Campo de unión _temperature.

_temperature puede ser una de las siguientes opciones:
temperature

number

Es opcional. Si se configura, esta temperatura se usará 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.

AgentRegistryDeployment

Representación JSON 
{
  "agentRegistryServiceName": string
}
Campos
agentRegistryServiceName

string

Es opcional. Solo salida. Es el nombre del recurso del servicio de Agent Registry implementado. Formato: projects/{project}/locations/{location}/services/{service}

ChannelType

Es el tipo de perfil del canal.

Enums
UNKNOWN Tipo de canal desconocido.
WEB_UI Es el canal de la IU web.
API Canal de API
TWILIO Canal de Twilio.
GOOGLE_TELEPHONY_PLATFORM Canal de la Plataforma de Telefonía de Google.
CONTACT_CENTER_AS_A_SERVICE Canal de centro de contacto como servicio (CCaaS).
CONTACT_CENTER_AS_A_SERVICE_CHAT Canal de centro de contacto como servicio (CCaaS Chat).
FIVE9 Canal de Five9.
CONTACT_CENTER_INTEGRATION Canal de integración de centros de contacto de terceros.
WHATSAPP Canal de WhatsApp
INSTAGRAM Canal de Instagram

Personificación

Es el arquetipo del canal.

Enums
UNKNOWN Arquetipo DESCONOCIDO.
CONCISE El agente mantiene las respuestas concisas y específicas.
CHATTY El agente proporciona contexto, explicaciones y detalles adicionales.

Modalidad

Es la modalidad del widget web.

Enums
MODALITY_UNSPECIFIED Modalidad desconocida.
CHAT_AND_VOICE El widget admite la entrada de voz y chat.
VOICE_ONLY El widget solo admite entrada de voz.
CHAT_ONLY El widget solo admite la entrada de chat.
CHAT_VOICE_AND_VIDEO El widget admite entradas de chat, voz y video.

Tema

Es el tema del widget web.

Enums
THEME_UNSPECIFIED Tema desconocido.
LIGHT Tema claro
DARK Tema oscuro

Estado

Es el estado del experimento.

Enums
STATE_UNSPECIFIED Significa que el estado no se especificó.
PENDING Obsoleto: Este estado ya no se usa.
RUNNING Estado de ejecución. El experimento se está ejecutando y es válido.
DONE Obsoleto: Este estado ya no se usa.
EXPIRED Obsoleto: Este estado ya no se usa.

ThinkingLevel

Es la configuración del nivel de razonamiento del modelo.

Enums
THINKING_LEVEL_UNSPECIFIED El nivel de pensamiento no está especificado.
DEFAULT Es el nivel de razonamiento predeterminado.
LOW Nivel de razonamiento bajo.
MEDIUM Nivel de razonamiento medio.
HIGH Nivel de razonamiento alto.

Modalidad

Es la modalidad de la implementación.

Enums
MODALITY_UNSPECIFIED Modalidad desconocida.
MODALITY_TEXT Modalidad de texto.
MODALITY_VOICE Modalidad de voz.
MODALITY_VIDEO Modalidad de video.

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 le puede enviar un mensaje de confirmación a un usuario.

Junto con la cadena de título, se definen las siguientes sugerencias booleanas:

  • 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 varias veces 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: ❌