MCP Tools Reference: ces.googleapis.com

Strumento: create_deployment

Crea un nuovo deployment nell'app specificata.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP create_deployment.

Curl Request 
                  
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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Messaggio di richiesta per AgentService.CreateDeployment.

CreateDeploymentRequest

Rappresentazione JSON 
{
  "parent": string,
  "deploymentId": string,
  "deployment": {
    object (Deployment)
  }
}
Campi
parent

string

Obbligatorio. L'app genitore. Formato: projects/{project}/locations/{location}/apps/{app}
deploymentId

string

Facoltativo. L'ID da utilizzare per il deployment, che diventerà il componente finale del nome della risorsa del deployment. Se non viene fornito, verrà assegnato automaticamente un ID univoco per il deployment.
deployment

object (Deployment)

Obbligatorio. Il deployment da creare.

Deployment

Rappresentazione JSON 
{
  "name": string,
  "displayName": string,
  "appVersion": string,
  "channelProfile": {
    object (ChannelProfile)
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "experimentConfig": {
    object (ExperimentConfig)
  }
}
Campi
name

string

Identificatore. Il nome della risorsa del deployment. Formato: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
displayName

string

Obbligatorio. Il nome visualizzato del deployment.
appVersion

string

Facoltativo. Il nome risorsa della versione dell'app di cui eseguire il deployment. Formato: projects/{project}/locations/{location}/apps/{app}/versions/{version} utilizza projects/{project}/locations/{location}/apps/{app}/versions/- per utilizzare l'app bozza.
channelProfile

object (ChannelProfile)

Obbligatorio. Il profilo del canale utilizzato nel deployment.
createTime

string (Timestamp format)

Solo output. Timestamp di creazione di questo deployment.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento di questo deployment.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
etag

string

Solo output. Etag utilizzato per garantire che l'oggetto non sia stato modificato durante un'operazione di lettura, modifica e scrittura. Se l'etag è vuoto, l'aggiornamento sovrascriverà eventuali modifiche simultanee.
experimentConfig

object (ExperimentConfig)

Facoltativo. Configurazione dell'esperimento per il deployment.

ChannelProfile

Rappresentazione JSON 
{
  "profileId": string,
  "channelType": enum (ChannelType),
  "personaProperty": {
    object (PersonaProperty)
  },
  "disableDtmf": boolean,
  "disableBargeInControl": boolean,
  "webWidgetConfig": {
    object (WebWidgetConfig)
  },
  "noiseSuppressionLevel": string
}
Campi
profileId

string

Facoltativo. L'identificatore univoco del profilo del canale.
channelType

enum (ChannelType)

Facoltativo. Il tipo di profilo del canale.
personaProperty

object (PersonaProperty)

Facoltativo. La proprietà della persona del profilo del canale.
disableDtmf

boolean

Facoltativo. Indica se disattivare il DTMF (multi-frequenza a due toni).
disableBargeInControl

boolean

Facoltativo. Se disattivare il controllo dell'interruzione da parte dell'utente nella conversazione. - true: le interruzioni dell'utente sono disattivate mentre l'agente parla. - false: l'agente mantiene il controllo automatico su quando l'utente può interrompere.
webWidgetConfig

object (WebWidgetConfig)

Facoltativo. La configurazione del widget web.
noiseSuppressionLevel

string

Facoltativo. Il livello di eliminazione del rumore del profilo del canale. I valori disponibili sono "low", "moderate", "high", "very_high".

PersonaProperty

Rappresentazione JSON 
{
  "persona": enum (Persona)
}
Campi
persona

enum (Persona)

Facoltativo. La personalità del canale.

WebWidgetConfig

Rappresentazione JSON 
{
  "modality": enum (Modality),
  "theme": enum (Theme),
  "webWidgetTitle": string,
  "securitySettings": {
    object (SecuritySettings)
  }
}
Campi
modality

enum (Modality)

Facoltativo. La modalità del widget web.
theme

enum (Theme)

Facoltativo. Il tema del widget web.
webWidgetTitle

string

Facoltativo. Il titolo del widget web.
securitySettings

object (SecuritySettings)

Facoltativo. Le impostazioni di sicurezza del widget web.

SecuritySettings

Rappresentazione JSON 
{
  "enablePublicAccess": boolean,
  "enableOriginCheck": boolean,
  "allowedOrigins": [
    string
  ],
  "enableRecaptcha": boolean
}
Campi
enablePublicAccess

boolean

Facoltativo. Indica se l'accesso pubblico al widget web è abilitato. Se true, il widget web sarà accessibile pubblicamente. Se false, il widget web deve essere integrato con il tuo sistema di autenticazione e autorizzazione per restituire credenziali valide per l'accesso all'agente CES.
enableOriginCheck

boolean

Facoltativo. Indica se il controllo dell'origine per il widget web è abilitato. Se true, il widget web controllerà l'origine del sito web che lo carica e ne consentirà il caricamento solo nella stessa origine o in una delle origini consentite.
allowedOrigins[]

string

Facoltativo. Le origini autorizzate a ospitare il widget web. Un'origine è definita dalla RFC 6454. Se vuoto, tutte le origini sono consentite. Sono consentite massimo 100 origini. Esempio: "https://example.com"
enableRecaptcha

boolean

Facoltativo. Indica se la verifica reCAPTCHA per il widget web è abilitata.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi del tempo UTC a partire dall'epoca Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la porzione di nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

ExperimentConfig

Rappresentazione JSON 
{
  "versionRelease": {
    object (VersionRelease)
  }
}
Campi
versionRelease

object (VersionRelease)

Facoltativo. Versione rilasciata per l'esperimento.

VersionRelease

Rappresentazione JSON 
{
  "state": enum (State),
  "trafficAllocations": [
    {
      object (TrafficAllocation)
    }
  ]
}
Campi
state

enum (State)

Facoltativo. Lo stato del rilascio della versione.
trafficAllocations[]

object (TrafficAllocation)

Facoltativo. Allocazioni del traffico per il rilascio della versione.

TrafficAllocation

Rappresentazione JSON 
{
  "id": string,
  "trafficPercentage": integer,
  "appVersion": string
}
Campi
id

string

Facoltativo. ID dell'assegnazione del traffico. Stringa in formato libero, fino a 128 caratteri.
trafficPercentage

integer

Facoltativo. Percentuale di traffico dell'assegnazione del traffico. Deve essere compreso tra 0 e 100.
appVersion

string

Facoltativo. Versione dell'app dell'assegnazione del traffico. Formato: projects/{project}/locations/{location}/apps/{app}/versions/{version}

ChannelType

Il tipo di profilo del canale.

Enum
UNKNOWN Tipo di canale sconosciuto.
WEB_UI Canale UI web.
API Canale API.
TWILIO Canale Twilio.
GOOGLE_TELEPHONY_PLATFORM Canale della piattaforma di telefonia Google.
CONTACT_CENTER_AS_A_SERVICE Canale Contact Center as a Service (CCaaS).
FIVE9 Canale Five9.
CONTACT_CENTER_INTEGRATION Canale di integrazione del contact center di terze parti.

Utente tipo

La personalità del canale.

Enum
UNKNOWN Utente tipo SCONOSCIUTO.
CONCISE L'agente mantiene le risposte concise e pertinenti
CHATTY L'agente fornisce contesto, spiegazioni e dettagli aggiuntivi

Modalità

Modalità del widget web.

Enum
MODALITY_UNSPECIFIED Modalità sconosciuta.
CHAT_AND_VOICE Il widget supporta sia l'input vocale che quello tramite chat.
VOICE_ONLY Il widget supporta solo l'input vocale.
CHAT_ONLY Il widget supporta solo l'input della chat.
CHAT_VOICE_AND_VIDEO Il widget supporta l'input di chat, voce e video.

Tema

Il tema del widget web.

Enum
THEME_UNSPECIFIED Tema sconosciuto.
LIGHT Tema chiaro.
DARK Tema scuro.

Stato

Stato dell'esperimento.

Enum
STATE_UNSPECIFIED Stato non specificato.
PENDING Stato in attesa. L'esperimento è in attesa e non è valido.
RUNNING Stato di esecuzione. L'esperimento è in corso ed è valido.
DONE Stato completato. L'esperimento è terminato e non è più valido.
EXPIRED Stato scaduto. L'esperimento è scaduto e non è più valido.

Schema di output

Un deployment rappresenta una versione immutabile e interrogabile dell'app. Viene utilizzato per eseguire il deployment di una versione dell'app con un profilo del canale specifico.

Deployment

Rappresentazione JSON 
{
  "name": string,
  "displayName": string,
  "appVersion": string,
  "channelProfile": {
    object (ChannelProfile)
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "experimentConfig": {
    object (ExperimentConfig)
  }
}
Campi
name

string

Identificatore. Il nome della risorsa del deployment. Formato: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
displayName

string

Obbligatorio. Il nome visualizzato del deployment.
appVersion

string

Facoltativo. Il nome risorsa della versione dell'app di cui eseguire il deployment. Formato: projects/{project}/locations/{location}/apps/{app}/versions/{version} utilizza projects/{project}/locations/{location}/apps/{app}/versions/- per utilizzare l'app bozza.
channelProfile

object (ChannelProfile)

Obbligatorio. Il profilo del canale utilizzato nel deployment.
createTime

string (Timestamp format)

Solo output. Timestamp di creazione di questo deployment.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento di questo deployment.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
etag

string

Solo output. Etag utilizzato per garantire che l'oggetto non sia stato modificato durante un'operazione di lettura, modifica e scrittura. Se l'etag è vuoto, l'aggiornamento sovrascriverà eventuali modifiche simultanee.
experimentConfig

object (ExperimentConfig)

Facoltativo. Configurazione dell'esperimento per il deployment.

ChannelProfile

Rappresentazione JSON 
{
  "profileId": string,
  "channelType": enum (ChannelType),
  "personaProperty": {
    object (PersonaProperty)
  },
  "disableDtmf": boolean,
  "disableBargeInControl": boolean,
  "webWidgetConfig": {
    object (WebWidgetConfig)
  },
  "noiseSuppressionLevel": string
}
Campi
profileId

string

Facoltativo. L'identificatore univoco del profilo del canale.
channelType

enum (ChannelType)

Facoltativo. Il tipo di profilo del canale.
personaProperty

object (PersonaProperty)

Facoltativo. La proprietà della persona del profilo del canale.
disableDtmf

boolean

Facoltativo. Indica se disattivare il DTMF (multi-frequenza a due toni).
disableBargeInControl

boolean

Facoltativo. Se disattivare il controllo dell'interruzione da parte dell'utente nella conversazione. - true: le interruzioni dell'utente sono disattivate mentre l'agente parla. - false: l'agente mantiene il controllo automatico su quando l'utente può interrompere.
webWidgetConfig

object (WebWidgetConfig)

Facoltativo. La configurazione del widget web.
noiseSuppressionLevel

string

Facoltativo. Il livello di eliminazione del rumore del profilo del canale. I valori disponibili sono "low", "moderate", "high", "very_high".

PersonaProperty

Rappresentazione JSON 
{
  "persona": enum (Persona)
}
Campi
persona

enum (Persona)

Facoltativo. La personalità del canale.

WebWidgetConfig

Rappresentazione JSON 
{
  "modality": enum (Modality),
  "theme": enum (Theme),
  "webWidgetTitle": string,
  "securitySettings": {
    object (SecuritySettings)
  }
}
Campi
modality

enum (Modality)

Facoltativo. La modalità del widget web.
theme

enum (Theme)

Facoltativo. Il tema del widget web.
webWidgetTitle

string

Facoltativo. Il titolo del widget web.
securitySettings

object (SecuritySettings)

Facoltativo. Le impostazioni di sicurezza del widget web.

SecuritySettings

Rappresentazione JSON 
{
  "enablePublicAccess": boolean,
  "enableOriginCheck": boolean,
  "allowedOrigins": [
    string
  ],
  "enableRecaptcha": boolean
}
Campi
enablePublicAccess

boolean

Facoltativo. Indica se l'accesso pubblico al widget web è abilitato. Se true, il widget web sarà accessibile pubblicamente. Se false, il widget web deve essere integrato con il tuo sistema di autenticazione e autorizzazione per restituire credenziali valide per l'accesso all'agente CES.
enableOriginCheck

boolean

Facoltativo. Indica se il controllo dell'origine per il widget web è abilitato. Se true, il widget web controllerà l'origine del sito web che lo carica e ne consentirà il caricamento solo nella stessa origine o in una delle origini consentite.
allowedOrigins[]

string

Facoltativo. Le origini autorizzate a ospitare il widget web. Un'origine è definita dalla RFC 6454. Se vuoto, tutte le origini sono consentite. Sono consentite massimo 100 origini. Esempio: "https://example.com"
enableRecaptcha

boolean

Facoltativo. Indica se la verifica reCAPTCHA per il widget web è abilitata.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi del tempo UTC a partire dall'epoca Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la porzione di nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

ExperimentConfig

Rappresentazione JSON 
{
  "versionRelease": {
    object (VersionRelease)
  }
}
Campi
versionRelease

object (VersionRelease)

Facoltativo. Versione rilasciata per l'esperimento.

VersionRelease

Rappresentazione JSON 
{
  "state": enum (State),
  "trafficAllocations": [
    {
      object (TrafficAllocation)
    }
  ]
}
Campi
state

enum (State)

Facoltativo. Lo stato del rilascio della versione.
trafficAllocations[]

object (TrafficAllocation)

Facoltativo. Allocazioni del traffico per il rilascio della versione.

TrafficAllocation

Rappresentazione JSON 
{
  "id": string,
  "trafficPercentage": integer,
  "appVersion": string
}
Campi
id

string

Facoltativo. ID dell'assegnazione del traffico. Stringa in formato libero, fino a 128 caratteri.
trafficPercentage

integer

Facoltativo. Percentuale di traffico dell'assegnazione del traffico. Deve essere compreso tra 0 e 100.
appVersion

string

Facoltativo. Versione dell'app dell'assegnazione del traffico. Formato: projects/{project}/locations/{location}/apps/{app}/versions/{version}

ChannelType

Il tipo di profilo del canale.

Enum
UNKNOWN Tipo di canale sconosciuto.
WEB_UI Canale UI web.
API Canale API.
TWILIO Canale Twilio.
GOOGLE_TELEPHONY_PLATFORM Canale della piattaforma di telefonia Google.
CONTACT_CENTER_AS_A_SERVICE Canale Contact Center as a Service (CCaaS).
FIVE9 Canale Five9.
CONTACT_CENTER_INTEGRATION Canale di integrazione del contact center di terze parti.

Utente tipo

La personalità del canale.

Enum
UNKNOWN Utente tipo SCONOSCIUTO.
CONCISE L'agente mantiene le risposte concise e pertinenti
CHATTY L'agente fornisce contesto, spiegazioni e dettagli aggiuntivi

Modalità

Modalità del widget web.

Enum
MODALITY_UNSPECIFIED Modalità sconosciuta.
CHAT_AND_VOICE Il widget supporta sia l'input vocale che quello tramite chat.
VOICE_ONLY Il widget supporta solo l'input vocale.
CHAT_ONLY Il widget supporta solo l'input della chat.
CHAT_VOICE_AND_VIDEO Il widget supporta l'input di chat, voce e video.

Tema

Il tema del widget web.

Enum
THEME_UNSPECIFIED Tema sconosciuto.
LIGHT Tema chiaro.
DARK Tema scuro.

Stato

Stato dell'esperimento.

Enum
STATE_UNSPECIFIED Stato non specificato.
PENDING Stato in attesa. L'esperimento è in attesa e non è valido.
RUNNING Stato di esecuzione. L'esperimento è in corso ed è valido.
DONE Stato completato. L'esperimento è terminato e non è più valido.
EXPIRED Stato scaduto. L'esperimento è scaduto e non è più valido.

Annotazioni dello strumento

Suggerimento distruttivo: ✅ | Suggerimento idempotente: ❌ | Suggerimento di sola lettura: ❌ | Suggerimento open world: ❌