MCP Tools Reference: ces.googleapis.com

Tool: list_deployments

Listet Bereitstellungen in der angegebenen App auf.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool list_deployments 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": "list_deployments",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfragenachricht für AgentService.ListDeployments.

ListDeploymentsRequest

JSON-Darstellung 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "orderBy": string
}
Felder
parent

string

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

integer

Optional. Die maximale Anzahl der zurückzugebenden Deployments. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Bereitstellungen zurückgegeben. Der Höchstwert liegt bei 1.000. Alle Werte darüber werden implizit in 1.000 umgewandelt.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen ListDeployments-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListDeployments bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
orderBy

string

Optional. Feld, nach dem sortiert werden soll. Nur „name“ und „create_time“ werden unterstützt. Weitere Informationen finden Sie unter https://google.aip.dev/132#ordering.

Ausgabeschema

Antwortnachricht für AgentService.ListDeployments.

ListDeploymentsResponse

JSON-Darstellung 
{
  "deployments": [
    {
      object (Deployment)
    }
  ],
  "nextPageToken": string
}
Felder
deployments[]

object (Deployment)

Die Liste der Bereitstellungen.
nextPageToken

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Bereitstellung

JSON-Darstellung 
{
  "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)
  }
}
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 in der Bereitstellung verwendete Channel-Profil.
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, mit dem sichergestellt wird, dass sich das Objekt während eines Read-Modify-Write-Vorgangs nicht geändert hat. Wenn das ETag leer ist, werden durch das Update alle gleichzeitigen Änderungen überschrieben.
experimentConfig

object (ExperimentConfig)

Optional. Testkonfiguration für die Bereitstellung.
whatsappCredentials

object (WhatsAppCredentials)

Optional. Nur Eingabe. Beim Konfigurieren eines WhatsApp-Channelprofils sind temporäre WhatsApp-Anmeldedaten erforderlich.
instagramCredentials

object (InstagramCredentials)

Optional. Nur Eingabe. Beim Konfigurieren eines Instagram-Kanalprofils sind flüchtige Instagram-Anmeldedaten erforderlich.
modelSettings

object (ModelSettings)

Optional. Modelleinstellungen für die Bereitstellung. Überschreibt die auf App-/Agent-Ebene konfigurierten Modelleinstellungen. Hinweis: Das Überschreiben von Modelleinstellungen auf Bereitstellungsebene ist nur über eine Zulassungsliste möglich. Wenden Sie sich an das CXAS-Team, um dieses Feld zu aktivieren.
modality

enum (Modality)

Optional. Die Modalität der Bereitstellung. Hinweis: Das Überschreiben von Modalitäten auf Bereitstellungsebene ist nur mit einer Zulassungsliste möglich. Wenden Sie sich an das CXAS-Team, um dieses Feld zu aktivieren.
agentRegistryDeployment

object (AgentRegistryDeployment)

Optional. Konfiguration für die Bereitstellung dieser Bereitstellung in Agent Registry. Falls vorhanden, wird diese Bereitstellung in Agent Registry veröffentlicht.

ChannelProfile

JSON-Darstellung 
{
  "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.
}
Felder
profileId

string

Optional. Die eindeutige Kennung des Channelprofils.
channelType

enum (ChannelType)

Optional. Der Typ des Channelprofils.
personaProperty

object (PersonaProperty)

Optional. Das Persona-Attribut des Kanalprofils.
webWidgetConfig

object (WebWidgetConfig)

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

object (WhatsAppConfig)

Optional. Konfiguration speziell für WhatsApp-Bereitstellungen.
instagramConfig

object (InstagramConfig)

Optional. Konfiguration speziell für Instagram-Bereitstellungen.

Union-Feld _disable_dtmf.

Für _disable_dtmf ist nur einer der folgenden Werte zulässig:
disableDtmf

boolean

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

Union-Feld _disable_barge_in_control.

Für _disable_barge_in_control ist nur einer der folgenden Werte zulässig:
disableBargeInControl

boolean

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

Union-Feld _noise_suppression_level.

Für _noise_suppression_level ist nur einer der folgenden Werte zulässig:
noiseSuppressionLevel

string

Optional. Der Grad der Geräuschunterdrückung des Kanalprofils. Mögliche 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 das Feld leer ist, 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.

WhatsAppConfig

JSON-Darstellung 
{
  "wabaId": string,
  "phoneNumberId": string,
  "phoneNumber": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
Felder
wabaId

string

Erforderlich. Die WhatsApp Business-Konto-ID.
phoneNumberId

string

Erforderlich. Die Meta-Telefonnummer-ID.
phoneNumber

string

Optional. Die Telefonnummer im E.164-Format.
displayName

string

Nur Ausgabe. Der abgerufene Name der Meta-Unternehmensseite.
thumbnailUrl

string

Nur Ausgabe. Die abgerufene Miniaturansicht-URL des Meta-Unternehmensprofils.
description

string

Nur Ausgabe. Die Beschreibung der Meta-Unternehmensseite oder des Meta-Unternehmensprofils.

InstagramConfig

JSON-Darstellung 
{
  "instagramAccountId": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
Felder
instagramAccountId

string

Erforderlich. Die Instagram-Konto-ID.
displayName

string

Nur Ausgabe. Der abgerufene Name der Meta-Unternehmensseite.
thumbnailUrl

string

Nur Ausgabe. Die abgerufene Miniaturansicht-URL des Meta-Unternehmensprofils.
description

string

Nur Ausgabe. Die Beschreibung der Meta-Unternehmensseite oder des Meta-Unternehmensprofils.

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 zwischen -62135596800 und 253402300799 liegen (einschließlich), was dem Zeitraum vom 01.01.0001 00:00:00 UTC bis zum 31.12.9999 23:59:59 UTC entspricht.
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 (einschließlich) liegen.

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 Version.
trafficAllocations[]

object (TrafficAllocation)

Optional. Traffic-Zuweisungen für das Release der Version.

TrafficAllocation

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

string

Optional. ID der Traffic-Zuordnung. String im freien Format mit bis zu 128 Zeichen.
trafficPercentage

integer

Optional. Prozentsatz des Traffics für die 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}

WhatsAppCredentials

JSON-Darstellung 
{
  "authCode": string,
  "pin": string,
  "phoneNumber": string,
  "businessAccountId": string,
  "wabaId": string,
  "conversationProfileId": string
}
Felder
authCode

string

Erforderlich. Der Meta-Autorisierungscode, der vom eingebetteten Registrierungsvorgang bereitgestellt wird.
pin

string

Erforderlich. Die 6‑stellige PIN, die vom Nutzer für die Bestätigung in zwei Schritten erstellt wurde.
phoneNumber

string

Erforderlich. Die Telefonnummer, mit der Sie sich bei WhatsApp registrieren.
businessAccountId

string

Erforderlich. Die Geschäfts-Konto-ID, die für die Telefonnummer verwendet werden soll.
wabaId

string

Erforderlich. Die WhatsApp Business-Konto-ID.
conversationProfileId

string

Optional. Die Konversationsprofil-ID, die für die Bereitstellung verwendet werden soll.

InstagramCredentials

JSON-Darstellung 
{
  "authCode": string,
  "conversationProfileId": string
}
Felder
authCode

string

Erforderlich. Der Meta-Autorisierungscode, der vom eingebetteten Registrierungsvorgang bereitgestellt wird.
conversationProfileId

string

Optional. Die Konversationsprofil-ID, die für die Bereitstellung verwendet werden soll.

ModelSettings

JSON-Darstellung 
{
  "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.
}
Felder
model

string

Optional. Das LLM-Modell, das der Agent verwenden soll. Wenn nicht festgelegt, übernimmt der Agent das Modell von seinem übergeordneten Agent.
thinkingLevel

enum (ThinkingLevel)

Optional. Der Denkaufwand des Modells.

Union-Feld _temperature.

Für _temperature ist nur einer der folgenden Werte zulässig:
temperature

number

Optional. Wenn festgelegt, wird diese Temperatur für das LLM-Modell verwendet. Die Temperatur steuert die Zufälligkeit der Antworten des Modells. Niedrigere Temperaturen führen zu vorhersagbareren Antworten. Höhere Temperaturen führen zu kreativeren Antworten.

AgentRegistryDeployment

JSON-Darstellung 
{
  "agentRegistryServiceName": string
}
Felder
agentRegistryServiceName

string

Optional. Nur Ausgabe. Der Ressourcenname des bereitgestellten Agent Registry-Dienstes. Format: projects/{project}/locations/{location}/services/{service}

ChannelType

Der Typ des Channelprofils.

Enums
UNKNOWN Unbekannter Kanaltyp.
WEB_UI Webbenutzeroberflächen-Channel
API API-Channel.
TWILIO Twilio-Channel
GOOGLE_TELEPHONY_PLATFORM Google Telephony Platform-Kanal.
CONTACT_CENTER_AS_A_SERVICE Contact Center as a Service (CCaaS)
CONTACT_CENTER_AS_A_SERVICE_CHAT Contact Center as a Service (CCaaS Chat)
FIVE9 Five9-Channel.
CONTACT_CENTER_INTEGRATION Kanal für die Contact-Center-Integration von Drittanbietern.
WHATSAPP WhatsApp-Kanal.
INSTAGRAM Instagram-Kanal

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 Chateingaben.
CHAT_VOICE_AND_VIDEO Das Widget unterstützt Chat-, Sprach- und Videoeingaben.

Design

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 Eingestellt: Dieser Status wird nicht mehr verwendet.
RUNNING Ausführungsstatus. Der Test wird ausgeführt und ist gültig.
DONE Eingestellt: Dieser Status wird nicht mehr verwendet.
EXPIRED Eingestellt: Dieser Status wird nicht mehr verwendet.

ThinkingLevel

Konfiguration des Denkaufwands für das Modell.

Enums
THINKING_LEVEL_UNSPECIFIED Der Denkaufwand ist nicht angegeben.
DEFAULT Standardmäßiger Denkaufwand.
LOW Geringer Denkaufwand.
MEDIUM Mittlerer Denkaufwand
HIGH Hoher Denkaufwand

Modalität

Die Modalität der Bereitstellung.

Enums
MODALITY_UNSPECIFIED Unbekannte Modalität.
MODALITY_TEXT Textmodalität.
MODALITY_VOICE Sprachmodalität
MODALITY_VIDEO Videomodalität

Tool-Annotationen

Tool-Anmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann ein Bestätigungs-Prompt an einen Nutzer gesendet werden soll.

Zusammen mit dem Titelstring werden die folgenden booleschen Hinweise so definiert:

  • readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: false.
  • destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: true.
  • idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: false.
  • openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Einheiten interagieren. Wenn „false“, kann das Tool nur mit internen Einheiten interagieren. Ein Tool für die Websuche wäre beispielsweise Open World, ein Tool für das Gedächtnis nicht.

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