MCP Tools Reference: ces.googleapis.com

Tool: create_deployment

Erstellt ein neues Deployment in der angegebenen App.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool create_deployment aufrufen.

Curl-Anfrage 
                  
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
}'

Eingabeschema

Anfragenachricht für AgentService.CreateDeployment.

CreateDeploymentRequest

JSON-Darstellung 
{
  "parent": string,
  "deploymentId": string,
  "deployment": {
    object (Deployment)
  }
}
Felder
parent

string

Erforderlich. Die übergeordnete App. Format: projects/{project}/locations/{location}/apps/{app}
deploymentId

string

Optional. Die für die Bereitstellung zu verwendende ID, die als letzte Komponente des Ressourcennamens der Bereitstellung verwendet wird. Wenn nicht angegeben, wird für die Bereitstellung automatisch eine eindeutige ID zugewiesen.
deployment

object (Deployment)

Erforderlich. Die zu erstellende Bereitstellung.

Bereitstellung

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

string

ID. Der Ressourcenname der Bereitstellung. Format: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
displayName

string

Erforderlich. Der Anzeigename der Bereitstellung.
appVersion

string

Optional. Der Ressourcenname der bereitzustellenden App-Version. Format: projects/{project}/locations/{location}/apps/{app}/versions/{version} Verwenden Sie projects/{project}/locations/{location}/apps/{app}/versions/-, um die App-Version zu verwenden.
channelProfile

object (ChannelProfile)

Erforderlich. Das im Einsatz verwendete Kanalprofil.
createTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel für die Erstellung dieser Bereitstellung.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten Aktualisierung dieser Bereitstellung.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
etag

string

Nur Ausgabe. Etag, das verwendet wird, um sicherzustellen, dass sich das Objekt während eines Read-Modify-Write-Vorgangs nicht geändert hat. Wenn das ETag leer ist, werden alle gleichzeitigen Änderungen durch das Update überschrieben.
experimentConfig

object (ExperimentConfig)

Optional. Testkonfiguration für die Bereitstellung.

ChannelProfile

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

string

Optional. Die eindeutige ID des Channelprofils.
channelType

enum (ChannelType)

Optional. Der Typ des Channelprofils.
personaProperty

object (PersonaProperty)

Optional. Die Persona-Eigenschaft des Kanalprofils.
disableDtmf

boolean

Optional. Gibt an, ob DTMF (Dual-Tone Multi-Frequency) deaktiviert werden soll.
disableBargeInControl

boolean

Optional. Gibt an, ob die Funktion zum Unterbrechen von Nutzern in der Unterhaltung deaktiviert werden soll. – true: Nutzerunterbrechungen sind deaktiviert, während der Agent spricht. – false: Der KI-Agent behält die automatische Kontrolle darüber, wann der Nutzer unterbrechen kann.
webWidgetConfig

object (WebWidgetConfig)

Optional. Die Konfiguration für das Web-Widget.
noiseSuppressionLevel

string

Optional. Der Grad der Geräuschunterdrückung des Kanalprofils. Verfügbare Werte sind „low“, „moderate“, „high“ und „very_high“.

PersonaProperty

JSON-Darstellung 
{
  "persona": enum (Persona)
}
Felder
persona

enum (Persona)

Optional. Die Persona des Kanals.

WebWidgetConfig

JSON-Darstellung 
{
  "modality": enum (Modality),
  "theme": enum (Theme),
  "webWidgetTitle": string,
  "securitySettings": {
    object (SecuritySettings)
  }
}
Felder
modality

enum (Modality)

Optional. Die Modalität des Web-Widgets.
theme

enum (Theme)

Optional. Das Design des Web-Widgets.
webWidgetTitle

string

Optional. Der Titel des Web-Widgets.
securitySettings

object (SecuritySettings)

Optional. Die Sicherheitseinstellungen des Web-Widgets.

SecuritySettings

JSON-Darstellung 
{
  "enablePublicAccess": boolean,
  "enableOriginCheck": boolean,
  "allowedOrigins": [
    string
  ],
  "enableRecaptcha": boolean
}
Felder
enablePublicAccess

boolean

Optional. Gibt an, ob der öffentliche Zugriff auf das Web-Widget aktiviert ist. Wenn true, ist das Web-Widget öffentlich zugänglich. Wenn false, muss das Web-Widget in Ihr eigenes Authentifizierungs- und Autorisierungssystem integriert werden, um gültige Anmeldedaten für den Zugriff auf den CES-Agent zurückzugeben.
enableOriginCheck

boolean

Optional. Gibt an, ob die Ursprungsprüfung für das Web-Widget aktiviert ist. Wenn true, prüft das Web-Widget den Ursprung der Website, auf der das Web-Widget geladen wird. Das Laden ist nur für denselben Ursprung oder einen der zulässigen Ursprünge zulässig.
allowedOrigins[]

string

Optional. Die Ursprünge, die das Web-Widget hosten dürfen. Ein Ursprung wird durch RFC 6454 definiert. Wenn leer, sind alle Ursprünge zulässig. Es sind maximal 100 Ursprünge zulässig. Beispiel: „https://beispiel.de“
enableRecaptcha

boolean

Optional. Gibt an, ob die reCAPTCHA-Überprüfung für das Web-Widget aktiviert ist.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

ExperimentConfig

JSON-Darstellung 
{
  "versionRelease": {
    object (VersionRelease)
  }
}
Felder
versionRelease

object (VersionRelease)

Optional. Version für den Test.

VersionRelease

JSON-Darstellung 
{
  "state": enum (State),
  "trafficAllocations": [
    {
      object (TrafficAllocation)
    }
  ]
}
Felder
state

enum (State)

Optional. Status der Versionsveröffentlichung.
trafficAllocations[]

object (TrafficAllocation)

Optional. Traffic-Zuweisungen für die Versionsveröffentlichung.

TrafficAllocation

JSON-Darstellung 
{
  "id": string,
  "trafficPercentage": integer,
  "appVersion": string
}
Felder
id

string

Optional. ID der Traffic-Zuordnung. Freiformatierter String mit bis zu 128 Zeichen.
trafficPercentage

integer

Optional. Traffic-Prozentsatz der Traffic-Zuordnung. muss zwischen 0 und 100 liegen.
appVersion

string

Optional. App-Version der Traffic-Zuordnung. Format: projects/{project}/locations/{location}/apps/{app}/versions/{version}

ChannelType

Der Typ des Channelprofils.

Enums
UNKNOWN Unbekannter Kanaltyp.
WEB_UI Web-UI-Channel
API API-Channel.
TWILIO Twilio-Kanal
GOOGLE_TELEPHONY_PLATFORM Google Telephony Platform-Kanal.
CONTACT_CENTER_AS_A_SERVICE Contact Center as a Service (CCaaS) Channel.
FIVE9 Five9-Kanal.
CONTACT_CENTER_INTEGRATION Drittanbieter-Channel für die Integration von Contact Centern.

Persona

Die Persona des Kanals.

Enums
UNKNOWN UNKNOWN-Persona.
CONCISE Der Agent hält die Antworten kurz und prägnant.
CHATTY Der KI-Agent liefert zusätzlichen Kontext, Erklärungen und Details.

Modalität

Modalität des Web-Widgets.

Enums
MODALITY_UNSPECIFIED Unbekannte Modalität.
CHAT_AND_VOICE Das Widget unterstützt sowohl Chat- als auch Spracheingabe.
VOICE_ONLY Das Widget unterstützt nur Spracheingabe.
CHAT_ONLY Das Widget unterstützt nur die Chateingabe.
CHAT_VOICE_AND_VIDEO Das Widget unterstützt Chat-, Sprach- und Videoeingabe.

Design

Das Design des Web-Widgets.

Enums
THEME_UNSPECIFIED Unbekanntes Thema.
LIGHT Helles Design
DARK Dunkles Design

Bundesland

Status des Tests.

Enums
STATE_UNSPECIFIED Nicht angegebener Zustand.
PENDING Status „Ausstehend“ Der Test steht noch aus und ist nicht gültig.
RUNNING Ausführungsstatus. Der Test läuft und ist gültig.
DONE Status „Erledigt“. Der Test ist abgeschlossen und nicht mehr gültig.
EXPIRED Status „Abgelaufen“. Der Test ist abgelaufen und nicht mehr gültig.

Ausgabeschema

Ein Deployment ist eine unveränderliche, abfragbare Version der App. Es wird verwendet, um eine App-Version mit einem bestimmten Channel-Profil bereitzustellen.

Bereitstellung

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

string

ID. Der Ressourcenname der Bereitstellung. Format: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
displayName

string

Erforderlich. Der Anzeigename der Bereitstellung.
appVersion

string

Optional. Der Ressourcenname der bereitzustellenden App-Version. Format: projects/{project}/locations/{location}/apps/{app}/versions/{version} Verwenden Sie projects/{project}/locations/{location}/apps/{app}/versions/-, um die App-Version zu verwenden.
channelProfile

object (ChannelProfile)

Erforderlich. Das im Einsatz verwendete Kanalprofil.
createTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel für die Erstellung dieser Bereitstellung.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten Aktualisierung dieser Bereitstellung.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
etag

string

Nur Ausgabe. Etag, das verwendet wird, um sicherzustellen, dass sich das Objekt während eines Read-Modify-Write-Vorgangs nicht geändert hat. Wenn das ETag leer ist, werden alle gleichzeitigen Änderungen durch das Update überschrieben.
experimentConfig

object (ExperimentConfig)

Optional. Testkonfiguration für die Bereitstellung.

ChannelProfile

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

string

Optional. Die eindeutige ID des Channelprofils.
channelType

enum (ChannelType)

Optional. Der Typ des Channelprofils.
personaProperty

object (PersonaProperty)

Optional. Die Persona-Eigenschaft des Kanalprofils.
disableDtmf

boolean

Optional. Gibt an, ob DTMF (Dual-Tone Multi-Frequency) deaktiviert werden soll.
disableBargeInControl

boolean

Optional. Gibt an, ob die Funktion zum Unterbrechen von Nutzern in der Unterhaltung deaktiviert werden soll. – true: Nutzerunterbrechungen sind deaktiviert, während der Agent spricht. – false: Der KI-Agent behält die automatische Kontrolle darüber, wann der Nutzer unterbrechen kann.
webWidgetConfig

object (WebWidgetConfig)

Optional. Die Konfiguration für das Web-Widget.
noiseSuppressionLevel

string

Optional. Der Grad der Geräuschunterdrückung des Kanalprofils. Verfügbare Werte sind „low“, „moderate“, „high“ und „very_high“.

PersonaProperty

JSON-Darstellung 
{
  "persona": enum (Persona)
}
Felder
persona

enum (Persona)

Optional. Die Persona des Kanals.

WebWidgetConfig

JSON-Darstellung 
{
  "modality": enum (Modality),
  "theme": enum (Theme),
  "webWidgetTitle": string,
  "securitySettings": {
    object (SecuritySettings)
  }
}
Felder
modality

enum (Modality)

Optional. Die Modalität des Web-Widgets.
theme

enum (Theme)

Optional. Das Design des Web-Widgets.
webWidgetTitle

string

Optional. Der Titel des Web-Widgets.
securitySettings

object (SecuritySettings)

Optional. Die Sicherheitseinstellungen des Web-Widgets.

SecuritySettings

JSON-Darstellung 
{
  "enablePublicAccess": boolean,
  "enableOriginCheck": boolean,
  "allowedOrigins": [
    string
  ],
  "enableRecaptcha": boolean
}
Felder
enablePublicAccess

boolean

Optional. Gibt an, ob der öffentliche Zugriff auf das Web-Widget aktiviert ist. Wenn true, ist das Web-Widget öffentlich zugänglich. Wenn false, muss das Web-Widget in Ihr eigenes Authentifizierungs- und Autorisierungssystem integriert werden, um gültige Anmeldedaten für den Zugriff auf den CES-Agent zurückzugeben.
enableOriginCheck

boolean

Optional. Gibt an, ob die Ursprungsprüfung für das Web-Widget aktiviert ist. Wenn true, prüft das Web-Widget den Ursprung der Website, auf der das Web-Widget geladen wird. Das Laden ist nur für denselben Ursprung oder einen der zulässigen Ursprünge zulässig.
allowedOrigins[]

string

Optional. Die Ursprünge, die das Web-Widget hosten dürfen. Ein Ursprung wird durch RFC 6454 definiert. Wenn leer, sind alle Ursprünge zulässig. Es sind maximal 100 Ursprünge zulässig. Beispiel: „https://beispiel.de“
enableRecaptcha

boolean

Optional. Gibt an, ob die reCAPTCHA-Überprüfung für das Web-Widget aktiviert ist.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

ExperimentConfig

JSON-Darstellung 
{
  "versionRelease": {
    object (VersionRelease)
  }
}
Felder
versionRelease

object (VersionRelease)

Optional. Version für den Test.

VersionRelease

JSON-Darstellung 
{
  "state": enum (State),
  "trafficAllocations": [
    {
      object (TrafficAllocation)
    }
  ]
}
Felder
state

enum (State)

Optional. Status der Versionsveröffentlichung.
trafficAllocations[]

object (TrafficAllocation)

Optional. Traffic-Zuweisungen für die Versionsveröffentlichung.

TrafficAllocation

JSON-Darstellung 
{
  "id": string,
  "trafficPercentage": integer,
  "appVersion": string
}
Felder
id

string

Optional. ID der Traffic-Zuordnung. Freiformatierter String mit bis zu 128 Zeichen.
trafficPercentage

integer

Optional. Traffic-Prozentsatz der Traffic-Zuordnung. muss zwischen 0 und 100 liegen.
appVersion

string

Optional. App-Version der Traffic-Zuordnung. Format: projects/{project}/locations/{location}/apps/{app}/versions/{version}

ChannelType

Der Typ des Channelprofils.

Enums
UNKNOWN Unbekannter Kanaltyp.
WEB_UI Web-UI-Channel
API API-Channel.
TWILIO Twilio-Kanal
GOOGLE_TELEPHONY_PLATFORM Google Telephony Platform-Kanal.
CONTACT_CENTER_AS_A_SERVICE Contact Center as a Service (CCaaS) Channel.
FIVE9 Five9-Kanal.
CONTACT_CENTER_INTEGRATION Drittanbieter-Channel für die Integration von Contact Centern.

Persona

Die Persona des Kanals.

Enums
UNKNOWN UNKNOWN-Persona.
CONCISE Der Agent hält die Antworten kurz und prägnant.
CHATTY Der KI-Agent liefert zusätzlichen Kontext, Erklärungen und Details.

Modalität

Modalität des Web-Widgets.

Enums
MODALITY_UNSPECIFIED Unbekannte Modalität.
CHAT_AND_VOICE Das Widget unterstützt sowohl Chat- als auch Spracheingabe.
VOICE_ONLY Das Widget unterstützt nur Spracheingabe.
CHAT_ONLY Das Widget unterstützt nur die Chateingabe.
CHAT_VOICE_AND_VIDEO Das Widget unterstützt Chat-, Sprach- und Videoeingabe.

Design

Das Design des Web-Widgets.

Enums
THEME_UNSPECIFIED Unbekanntes Thema.
LIGHT Helles Design
DARK Dunkles Design

Bundesland

Status des Tests.

Enums
STATE_UNSPECIFIED Nicht angegebener Zustand.
PENDING Status „Ausstehend“ Der Test steht noch aus und ist nicht gültig.
RUNNING Ausführungsstatus. Der Test läuft und ist gültig.
DONE Status „Erledigt“. Der Test ist abgeschlossen und nicht mehr gültig.
EXPIRED Status „Abgelaufen“. Der Test ist abgelaufen und nicht mehr gültig.

Tool-Annotationen

Destruktiver Hinweis: ✅ | Idempotenter Hinweis: ❌ | Nur-Lese-Hinweis: ❌ | Open-World-Hinweis: ❌