MCP Tools Reference: ces.googleapis.com

Outil : create_deployment

Crée un déploiement dans l'application donnée.

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP create_deployment.

Requête curl 
                  
curl --location 'https://ces.[REGION].rep.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "create_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.CreateDeployment.

CreateDeploymentRequest

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

string

Obligatoire. Application parente. Format : projects/{project}/locations/{location}/apps/{app}
deploymentId

string

Facultatif. ID à utiliser pour le déploiement, qui constituera le composant final du nom de ressource du déploiement. Si aucun ID n'est fourni, un ID unique sera automatiquement attribué au déploiement.
deployment

object (Deployment)

Obligatoire. Déploiement à créer.

Déploiement

Représentation JSON 
{
  "name": string,
  "displayName": string,
  "appVersion": string,
  "channelProfile": {
    object (ChannelProfile)
  },
  "createTime": string,
  "updateTime": string,
  "etag": string
}
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.

ChannelProfile

Représentation JSON 
{
  "profileId": string,
  "channelType": enum (ChannelType),
  "personaProperty": {
    object (PersonaProperty)
  },
  "disableDtmf": boolean,
  "disableBargeInControl": boolean,
  "webWidgetConfig": {
    object (WebWidgetConfig)
  },
  "noiseSuppressionLevel": string
}
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é de la persona du profil de chaîne.
disableDtmf

boolean

Facultatif. Indique si le DTMF (double fréquence) doit être désactivé.
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 du moment où l'utilisateur peut interrompre.
webWidgetConfig

object (WebWidgetConfig)

Facultatif. Configuration du widget Web.
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 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.

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.

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
}
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.

ChannelProfile

Représentation JSON 
{
  "profileId": string,
  "channelType": enum (ChannelType),
  "personaProperty": {
    object (PersonaProperty)
  },
  "disableDtmf": boolean,
  "disableBargeInControl": boolean,
  "webWidgetConfig": {
    object (WebWidgetConfig)
  },
  "noiseSuppressionLevel": string
}
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é de la persona du profil de chaîne.
disableDtmf

boolean

Facultatif. Indique si le DTMF (double fréquence) doit être désactivé.
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 du moment où l'utilisateur peut interrompre.
webWidgetConfig

object (WebWidgetConfig)

Facultatif. Configuration du widget Web.
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 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.

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.

Annotations d'outils

Indication destructive : ✅ | Indication d'idempotence : ❌ | Indication de lecture seule : ❌ | Indication Open World : ❌