MCP Tools Reference: ces.googleapis.com

Outil : update_deployment

Met à jour le déploiement spécifié. Veillez à toujours transmettre un masque de mise à jour dans l'entrée.

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP update_deployment.

Requête 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": "update_deployment",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schéma d'entrée

Message de requête pour AgentService.UpdateDeployment.

UpdateDeploymentRequest

Représentation JSON
{
  "deployment": {
    object (Deployment)
  },
  "updateMask": string
}
Champs
deployment

object (Deployment)

Obligatoire. Déploiement à mettre à jour.

updateMask

string (FieldMask format)

Facultatif. Liste des champs à mettre à jour.

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo".

Déploiement

Représentation 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)
}
Champs
name

string

Identifiant. Nom de ressource du déploiement. Format : projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}

displayName

string

Obligatoire. Nom à afficher du déploiement.

appVersion

string

Facultatif. Nom de ressource de la version de l'application à déployer. Format : projects/{project}/locations/{location}/apps/{app}/versions/{version} Utilisez projects/{project}/locations/{location}/apps/{app}/versions/- pour utiliser l'application brouillon.

channelProfile

object (ChannelProfile)

Obligatoire. Profil de canal utilisé dans le déploiement.

createTime

string (Timestamp format)

Uniquement en sortie. Horodatage de la création de ce déploiement.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la dernière mise à jour de ce déploiement.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

etag

string

Uniquement en sortie. Etag utilisé pour s'assurer que l'objet n'a pas été modifié lors d'une opération de lecture/modification/écriture. Si l'etag est vide, la mise à jour écrasera toutes les modifications simultanées.

experimentConfig

object (ExperimentConfig)

Facultatif. Configuration du test pour le déploiement.

whatsappCredentials

object (WhatsAppCredentials)

Facultatif. Uniquement en entrée. Des identifiants WhatsApp éphémères sont requis lors de la configuration d'un profil de canal WhatsApp.

instagramCredentials

object (InstagramCredentials)

Facultatif. Uniquement en entrée. Des identifiants Instagram éphémères sont requis lors de la configuration d'un profil de chaîne Instagram.

modelSettings

object (ModelSettings)

Facultatif. Paramètres du modèle pour le déploiement. Remplace les paramètres du modèle configurés au niveau de l'application/de l'agent. Remarque : Le remplacement des paramètres de modèle au niveau du déploiement est soumis à une liste d'autorisation. Contactez l'équipe CXAS pour activer ce champ.

modality

enum (Modality)

Facultatif. Modalité du déploiement. Remarque : Le remplacement de la modalité au niveau du déploiement est soumis à une liste d'autorisation. Contactez l'équipe CXAS pour activer ce champ.

ChannelProfile

Représentation 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.
}
Champs
profileId

string

Facultatif. Identifiant unique du profil de chaîne.

channelType

enum (ChannelType)

Facultatif. Type de profil de chaîne.

personaProperty

object (PersonaProperty)

Facultatif. Propriété "persona" du profil de la chaîne.

webWidgetConfig

object (WebWidgetConfig)

Facultatif. Configuration du widget Web.

whatsappConfig

object (WhatsAppConfig)

Facultatif. Configuration spécifique aux déploiements WhatsApp.

instagramConfig

object (InstagramConfig)

Facultatif. Configuration spécifique aux déploiements Instagram.

Champ d'union _disable_dtmf.

_disable_dtmf ne peut être qu'un des éléments suivants :

disableDtmf

boolean

Facultatif. Indique si le DTMF (double fréquence) doit être désactivé.

Champ d'union _disable_barge_in_control.

_disable_barge_in_control ne peut être qu'un des éléments suivants :

disableBargeInControl

boolean

Facultatif. Indique si le contrôle de l'interruption par l'utilisateur doit être désactivé dans la conversation. - true : les interruptions de l'utilisateur sont désactivées pendant que l'agent parle. - false : l'agent conserve le contrôle automatique sur le moment où l'utilisateur peut interrompre.

Champ d'union _noise_suppression_level.

_noise_suppression_level ne peut être qu'un des éléments suivants :

noiseSuppressionLevel

string

Facultatif. Niveau de suppression du bruit du profil de chaîne. Les valeurs disponibles sont "low", "moderate", "high" et "very_high".

PersonaProperty

Représentation JSON
{
  "persona": enum (Persona)
}
Champs
persona

enum (Persona)

Facultatif. Personnalité de la chaîne.

WebWidgetConfig

Représentation JSON
{
  "modality": enum (Modality),
  "theme": enum (Theme),
  "webWidgetTitle": string,
  "securitySettings": {
    object (SecuritySettings)
  }
}
Champs
modality

enum (Modality)

Facultatif. Modalité du widget Web.

theme

enum (Theme)

Facultatif. Thème du widget Web.

webWidgetTitle

string

Facultatif. Titre du widget Web.

securitySettings

object (SecuritySettings)

Facultatif. Paramètres de sécurité du widget Web.

SecuritySettings

Représentation JSON
{
  "enablePublicAccess": boolean,
  "enableOriginCheck": boolean,
  "allowedOrigins": [
    string
  ],
  "enableRecaptcha": boolean
}
Champs
enablePublicAccess

boolean

Facultatif. Indique si l'accès public au widget Web est activé. Si la valeur est true, le widget Web sera accessible au public. Si la valeur est false, le widget Web doit être intégré à votre propre système d'authentification et d'autorisation pour renvoyer des identifiants valides permettant d'accéder à l'agent CES.

enableOriginCheck

boolean

Facultatif. Indique si la vérification de l'origine du widget Web est activée. Si la valeur est true, le widget Web vérifie l'origine du site Web qui charge le widget Web et n'autorise le chargement que dans la même origine ou dans l'une des origines autorisées.

allowedOrigins[]

string

Facultatif. Origines autorisées à héberger le widget Web. Une origine est définie par la norme RFC 6454. Si ce champ est vide, toutes les origines sont autorisées. Vous ne pouvez pas inclure plus de 100 origines. Exemple : "https://example.com"

enableRecaptcha

boolean

Facultatif. Indique si la validation reCAPTCHA pour le widget Web est activée.

WhatsAppConfig

Représentation JSON
{
  "wabaId": string,
  "phoneNumberId": string,
  "phoneNumber": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
Champs
wabaId

string

Obligatoire. ID de compte WhatsApp Business.

phoneNumberId

string

Obligatoire. ID du numéro de téléphone Meta.

phoneNumber

string

Facultatif. Numéro de téléphone au format E.164.

displayName

string

Uniquement en sortie. Nom de la page Facebook récupérée.

thumbnailUrl

string

Uniquement en sortie. URL de la vignette de la fiche d'établissement Meta récupérée.

description

string

Uniquement en sortie. Description de la page ou du profil Meta de l'entreprise.

InstagramConfig

Représentation JSON
{
  "instagramAccountId": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
Champs
instagramAccountId

string

Obligatoire. ID du compte Instagram.

displayName

string

Uniquement en sortie. Nom de la page Facebook récupérée.

thumbnailUrl

string

Uniquement en sortie. URL de la vignette de la fiche d'établissement Meta récupérée.

description

string

Uniquement en sortie. Description de la page ou du profil Meta de l'entreprise.

Horodatage

Représentation JSON
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. La valeur doit être comprise entre -62135596800 et 253402300799 inclus (ce qui correspond à 0001-01-01T00:00:00Z et 9999-12-31T23:59:59Z).

nanos

integer

Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie en nanosecondes de la durée, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. La valeur doit être comprise entre 0 et 999 999 999 inclus.

ExperimentConfig

Représentation JSON
{
  "versionRelease": {
    object (VersionRelease)
  }
}
Champs
versionRelease

object (VersionRelease)

Facultatif. Version du test.

VersionRelease

Représentation JSON
{
  "state": enum (State),
  "trafficAllocations": [
    {
      object (TrafficAllocation)
    }
  ]
}
Champs
state

enum (State)

Facultatif. État de la version.

trafficAllocations[]

object (TrafficAllocation)

Facultatif. Répartition du trafic pour la version.

TrafficAllocation

Représentation JSON
{
  "id": string,
  "trafficPercentage": integer,
  "appVersion": string
}
Champs
id

string

Facultatif. ID de la répartition du trafic. Chaîne au format libre, jusqu'à 128 caractères.

trafficPercentage

integer

Facultatif. Pourcentage de la répartition du trafic. La valeur doit être comprise entre 0 et 100.

appVersion

string

Facultatif. Version de l'application pour la répartition du trafic. Format : projects/{project}/locations/{location}/apps/{app}/versions/{version}

WhatsAppCredentials

Représentation JSON
{
  "authCode": string,
  "pin": string,
  "phoneNumber": string,
  "businessAccountId": string,
  "wabaId": string,
  "conversationProfileId": string
}
Champs
authCode

string

Obligatoire. Code d'authentification Meta fourni par le flux d'inscription intégré.

pin

string

Obligatoire. Code à six chiffres créé par l'utilisateur pour la validation en deux étapes.

phoneNumber

string

Obligatoire. Numéro de téléphone à enregistrer sur WhatsApp.

businessAccountId

string

Obligatoire. ID du compte professionnel à utiliser pour le numéro de téléphone.

wabaId

string

Obligatoire. ID de compte WhatsApp Business.

conversationProfileId

string

Facultatif. ID du profil de conversation à utiliser pour le déploiement.

InstagramCredentials

Représentation JSON
{
  "authCode": string,
  "conversationProfileId": string
}
Champs
authCode

string

Obligatoire. Code d'authentification Meta fourni par le flux d'inscription intégré.

conversationProfileId

string

Facultatif. ID du profil de conversation à utiliser pour le déploiement.

ModelSettings

Représentation JSON
{
  "model": string,

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

string

Facultatif. Modèle LLM que l'agent doit utiliser. Si aucune valeur n'est définie, l'agent hérite du modèle de son agent parent.

Champ d'union _temperature.

_temperature ne peut être qu'un des éléments suivants :

temperature

number

Facultatif. Si cette option est définie, cette température sera utilisée pour le modèle LLM. La température contrôle le caractère aléatoire des réponses du modèle. Les températures plus basses produisent des réponses plus prévisibles. Les températures plus élevées génèrent des réponses plus créatives.

FieldMask

Représentation JSON
{
  "paths": [
    string
  ]
}
Champs
paths[]

string

Ensemble des chemins du masque de champ.

ChannelType

Type de profil de chaîne.

Enums
UNKNOWN Type de canal inconnu.
WEB_UI Canal de l'UI Web.
API Canal API.
TWILIO Canal Twilio.
GOOGLE_TELEPHONY_PLATFORM Chaîne de la plate-forme de téléphonie Google.
CONTACT_CENTER_AS_A_SERVICE Canal Contact Center as a Service (CCaaS).
CONTACT_CENTER_AS_A_SERVICE_CHAT Canal Contact Center as a Service (CCaaS Chat).
FIVE9 Canal Five9.
CONTACT_CENTER_INTEGRATION Canal d'intégration de centre de contact tiers.
WHATSAPP Canal WhatsApp.
INSTAGRAM Canal Instagram.

Persona

Personnalité de la chaîne.

Enums
UNKNOWN Persona UNKNOWN.
CONCISE L'agent fournit des réponses concises et précises.
CHATTY L'agent fournit du contexte, des explications et des détails supplémentaires.

Modalité

Modalité du widget Web.

Enums
MODALITY_UNSPECIFIED Modalité inconnue.
CHAT_AND_VOICE Le widget est compatible avec la saisie par chat et vocale.
VOICE_ONLY Le widget n'accepte que la saisie vocale.
CHAT_ONLY Le widget n'accepte que les entrées de chat.
CHAT_VOICE_AND_VIDEO Le widget accepte les entrées de chat, vocales et vidéo.

Thème

Thème du widget Web.

Enums
THEME_UNSPECIFIED Thème inconnu.
LIGHT Thème clair.
DARK le thème sombre.

État

État du test.

Enums
STATE_UNSPECIFIED État non spécifié.
PENDING Obsolète : cet état n'est plus utilisé.
RUNNING État d'exécution. Le test est en cours et valide.
DONE Obsolète : cet état n'est plus utilisé.
EXPIRED Obsolète : cet état n'est plus utilisé.

Modalité

Modalité du déploiement.

Enums
MODALITY_UNSPECIFIED Modalité inconnue.
MODALITY_TEXT Modalité textuelle.
MODALITY_VOICE Modalité vocale.
MODALITY_VIDEO Modalité vidéo

Schéma de sortie

Un déploiement représente une version immuable et interrogeable de l'application. Il est utilisé pour déployer une version de l'application avec un profil de canal spécifique.

Déploiement

Représentation 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)
}
Champs
name

string

Identifiant. Nom de ressource du déploiement. Format : projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}

displayName

string

Obligatoire. Nom à afficher du déploiement.

appVersion

string

Facultatif. Nom de ressource de la version de l'application à déployer. Format : projects/{project}/locations/{location}/apps/{app}/versions/{version} Utilisez projects/{project}/locations/{location}/apps/{app}/versions/- pour utiliser l'application brouillon.

channelProfile

object (ChannelProfile)

Obligatoire. Profil de canal utilisé dans le déploiement.

createTime

string (Timestamp format)

Uniquement en sortie. Horodatage de la création de ce déploiement.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la dernière mise à jour de ce déploiement.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

etag

string

Uniquement en sortie. Etag utilisé pour s'assurer que l'objet n'a pas été modifié lors d'une opération de lecture/modification/écriture. Si l'etag est vide, la mise à jour écrasera toutes les modifications simultanées.

experimentConfig

object (ExperimentConfig)

Facultatif. Configuration du test pour le déploiement.

whatsappCredentials

object (WhatsAppCredentials)

Facultatif. Uniquement en entrée. Des identifiants WhatsApp éphémères sont requis lors de la configuration d'un profil de canal WhatsApp.

instagramCredentials

object (InstagramCredentials)

Facultatif. Uniquement en entrée. Des identifiants Instagram éphémères sont requis lors de la configuration d'un profil de chaîne Instagram.

modelSettings

object (ModelSettings)

Facultatif. Paramètres du modèle pour le déploiement. Remplace les paramètres du modèle configurés au niveau de l'application/de l'agent. Remarque : Le remplacement des paramètres de modèle au niveau du déploiement est soumis à une liste d'autorisation. Contactez l'équipe CXAS pour activer ce champ.

modality

enum (Modality)

Facultatif. Modalité du déploiement. Remarque : Le remplacement de la modalité au niveau du déploiement est soumis à une liste d'autorisation. Contactez l'équipe CXAS pour activer ce champ.

ChannelProfile

Représentation 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.
}
Champs
profileId

string

Facultatif. Identifiant unique du profil de chaîne.

channelType

enum (ChannelType)

Facultatif. Type de profil de chaîne.

personaProperty

object (PersonaProperty)

Facultatif. Propriété "persona" du profil de la chaîne.

webWidgetConfig

object (WebWidgetConfig)

Facultatif. Configuration du widget Web.

whatsappConfig

object (WhatsAppConfig)

Facultatif. Configuration spécifique aux déploiements WhatsApp.

instagramConfig

object (InstagramConfig)

Facultatif. Configuration spécifique aux déploiements Instagram.

Champ d'union _disable_dtmf.

_disable_dtmf ne peut être qu'un des éléments suivants :

disableDtmf

boolean

Facultatif. Indique si le DTMF (double fréquence) doit être désactivé.

Champ d'union _disable_barge_in_control.

_disable_barge_in_control ne peut être qu'un des éléments suivants :

disableBargeInControl

boolean

Facultatif. Indique si le contrôle de l'interruption par l'utilisateur doit être désactivé dans la conversation. - true : les interruptions de l'utilisateur sont désactivées pendant que l'agent parle. - false : l'agent conserve le contrôle automatique sur le moment où l'utilisateur peut interrompre.

Champ d'union _noise_suppression_level.

_noise_suppression_level ne peut être qu'un des éléments suivants :

noiseSuppressionLevel

string

Facultatif. Niveau de suppression du bruit du profil de chaîne. Les valeurs disponibles sont "low", "moderate", "high" et "very_high".

PersonaProperty

Représentation JSON
{
  "persona": enum (Persona)
}
Champs
persona

enum (Persona)

Facultatif. Personnalité de la chaîne.

WebWidgetConfig

Représentation JSON
{
  "modality": enum (Modality),
  "theme": enum (Theme),
  "webWidgetTitle": string,
  "securitySettings": {
    object (SecuritySettings)
  }
}
Champs
modality

enum (Modality)

Facultatif. Modalité du widget Web.

theme

enum (Theme)

Facultatif. Thème du widget Web.

webWidgetTitle

string

Facultatif. Titre du widget Web.

securitySettings

object (SecuritySettings)

Facultatif. Paramètres de sécurité du widget Web.

SecuritySettings

Représentation JSON
{
  "enablePublicAccess": boolean,
  "enableOriginCheck": boolean,
  "allowedOrigins": [
    string
  ],
  "enableRecaptcha": boolean
}
Champs
enablePublicAccess

boolean

Facultatif. Indique si l'accès public au widget Web est activé. Si la valeur est true, le widget Web sera accessible au public. Si la valeur est false, le widget Web doit être intégré à votre propre système d'authentification et d'autorisation pour renvoyer des identifiants valides permettant d'accéder à l'agent CES.

enableOriginCheck

boolean

Facultatif. Indique si la vérification de l'origine du widget Web est activée. Si la valeur est true, le widget Web vérifie l'origine du site Web qui charge le widget Web et n'autorise le chargement que dans la même origine ou dans l'une des origines autorisées.

allowedOrigins[]

string

Facultatif. Origines autorisées à héberger le widget Web. Une origine est définie par la norme RFC 6454. Si ce champ est vide, toutes les origines sont autorisées. Vous ne pouvez pas inclure plus de 100 origines. Exemple : "https://example.com"

enableRecaptcha

boolean

Facultatif. Indique si la validation reCAPTCHA pour le widget Web est activée.

WhatsAppConfig

Représentation JSON
{
  "wabaId": string,
  "phoneNumberId": string,
  "phoneNumber": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
Champs
wabaId

string

Obligatoire. ID de compte WhatsApp Business.

phoneNumberId

string

Obligatoire. ID du numéro de téléphone Meta.

phoneNumber

string

Facultatif. Numéro de téléphone au format E.164.

displayName

string

Uniquement en sortie. Nom de la page Facebook récupérée.

thumbnailUrl

string

Uniquement en sortie. URL de la vignette de la fiche d'établissement Meta récupérée.

description

string

Uniquement en sortie. Description de la page ou du profil Meta de l'entreprise.

InstagramConfig

Représentation JSON
{
  "instagramAccountId": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
Champs
instagramAccountId

string

Obligatoire. ID du compte Instagram.

displayName

string

Uniquement en sortie. Nom de la page Facebook récupérée.

thumbnailUrl

string

Uniquement en sortie. URL de la vignette de la fiche d'établissement Meta récupérée.

description

string

Uniquement en sortie. Description de la page ou du profil Meta de l'entreprise.

Horodatage

Représentation JSON
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. La valeur doit être comprise entre -62135596800 et 253402300799 inclus (ce qui correspond à 0001-01-01T00:00:00Z et 9999-12-31T23:59:59Z).

nanos

integer

Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie en nanosecondes de la durée, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. La valeur doit être comprise entre 0 et 999 999 999 inclus.

ExperimentConfig

Représentation JSON
{
  "versionRelease": {
    object (VersionRelease)
  }
}
Champs
versionRelease

object (VersionRelease)

Facultatif. Version du test.

VersionRelease

Représentation JSON
{
  "state": enum (State),
  "trafficAllocations": [
    {
      object (TrafficAllocation)
    }
  ]
}
Champs
state

enum (State)

Facultatif. État de la version.

trafficAllocations[]

object (TrafficAllocation)

Facultatif. Répartition du trafic pour la version.

TrafficAllocation

Représentation JSON
{
  "id": string,
  "trafficPercentage": integer,
  "appVersion": string
}
Champs
id

string

Facultatif. ID de la répartition du trafic. Chaîne au format libre, jusqu'à 128 caractères.

trafficPercentage

integer

Facultatif. Pourcentage de la répartition du trafic. La valeur doit être comprise entre 0 et 100.

appVersion

string

Facultatif. Version de l'application pour la répartition du trafic. Format : projects/{project}/locations/{location}/apps/{app}/versions/{version}

WhatsAppCredentials

Représentation JSON
{
  "authCode": string,
  "pin": string,
  "phoneNumber": string,
  "businessAccountId": string,
  "wabaId": string,
  "conversationProfileId": string
}
Champs
authCode

string

Obligatoire. Code d'authentification Meta fourni par le flux d'inscription intégré.

pin

string

Obligatoire. Code à six chiffres créé par l'utilisateur pour la validation en deux étapes.

phoneNumber

string

Obligatoire. Numéro de téléphone à enregistrer sur WhatsApp.

businessAccountId

string

Obligatoire. ID du compte professionnel à utiliser pour le numéro de téléphone.

wabaId

string

Obligatoire. ID de compte WhatsApp Business.

conversationProfileId

string

Facultatif. ID du profil de conversation à utiliser pour le déploiement.

InstagramCredentials

Représentation JSON
{
  "authCode": string,
  "conversationProfileId": string
}
Champs
authCode

string

Obligatoire. Code d'authentification Meta fourni par le flux d'inscription intégré.

conversationProfileId

string

Facultatif. ID du profil de conversation à utiliser pour le déploiement.

ModelSettings

Représentation JSON
{
  "model": string,

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

string

Facultatif. Modèle LLM que l'agent doit utiliser. Si aucune valeur n'est définie, l'agent hérite du modèle de son agent parent.

Champ d'union _temperature.

_temperature ne peut être qu'un des éléments suivants :

temperature

number

Facultatif. Si cette option est définie, cette température sera utilisée pour le modèle LLM. La température contrôle le caractère aléatoire des réponses du modèle. Les températures plus basses produisent des réponses plus prévisibles. Les températures plus élevées génèrent des réponses plus créatives.

ChannelType

Type de profil de chaîne.

Enums
UNKNOWN Type de canal inconnu.
WEB_UI Canal de l'UI Web.
API Canal API.
TWILIO Canal Twilio.
GOOGLE_TELEPHONY_PLATFORM Chaîne de la plate-forme de téléphonie Google.
CONTACT_CENTER_AS_A_SERVICE Canal Contact Center as a Service (CCaaS).
CONTACT_CENTER_AS_A_SERVICE_CHAT Canal Contact Center as a Service (CCaaS Chat).
FIVE9 Canal Five9.
CONTACT_CENTER_INTEGRATION Canal d'intégration de centre de contact tiers.
WHATSAPP Canal WhatsApp.
INSTAGRAM Canal Instagram.

Persona

Personnalité de la chaîne.

Enums
UNKNOWN Persona UNKNOWN.
CONCISE L'agent fournit des réponses concises et précises.
CHATTY L'agent fournit du contexte, des explications et des détails supplémentaires.

Modalité

Modalité du widget Web.

Enums
MODALITY_UNSPECIFIED Modalité inconnue.
CHAT_AND_VOICE Le widget est compatible avec la saisie par chat et vocale.
VOICE_ONLY Le widget n'accepte que la saisie vocale.
CHAT_ONLY Le widget n'accepte que les entrées de chat.
CHAT_VOICE_AND_VIDEO Le widget accepte les entrées de chat, vocales et vidéo.

Thème

Thème du widget Web.

Enums
THEME_UNSPECIFIED Thème inconnu.
LIGHT Thème clair.
DARK le thème sombre.

État

État du test.

Enums
STATE_UNSPECIFIED État non spécifié.
PENDING Obsolète : cet état n'est plus utilisé.
RUNNING État d'exécution. Le test est en cours et valide.
DONE Obsolète : cet état n'est plus utilisé.
EXPIRED Obsolète : cet état n'est plus utilisé.

Modalité

Modalité du déploiement.

Enums
MODALITY_UNSPECIFIED Modalité inconnue.
MODALITY_TEXT Modalité textuelle.
MODALITY_VOICE Modalité vocale.
MODALITY_VIDEO Modalité vidéo

Annotations d'outils

Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients traitent ces indices comme non fiables, mais ils peuvent être utilisés pour déterminer quand un message de confirmation peut être envoyé à un utilisateur.

En plus de la chaîne de titre, les indications booléennes suivantes sont définies comme suit :

  • readOnlyHint : si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".
  • destructiveHint : si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions d'ajout. Valeur par défaut : "true".
  • idempotentHint : si la valeur est "true", appeler l'outil à plusieurs reprises avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".
  • openWorldHint : si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.

Indication de destruction : ✅ | Indication d'idempotence : ❌ | Indication de lecture seule : ❌ | Indication de monde ouvert : ❌