MCP Tools Reference: ces.googleapis.com

工具：create_deployment

在给定应用中创建新部署。

以下示例演示了如何使用 curl 调用 create_deployment MCP 工具。

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

输入架构

AgentService.CreateDeployment 的请求消息。

CreateDeploymentRequest

JSON 表示法 
{
  "parent": string,
  "deploymentId": string,
  "deployment": {
    object (Deployment)
  }
}
字段
parent

string

必需。父应用。格式：projects/{project}/locations/{location}/apps/{app}
deploymentId

string

可选。要用于 Deployment 的 ID，该 ID 将成为 Deployment 资源名称的最后一个组成部分。如果未提供，系统会自动为部署分配唯一 ID。
deployment

object (Deployment)

必需。要创建的部署。

部署

JSON 表示法 
{
  "name": string,
  "displayName": string,
  "appVersion": string,
  "channelProfile": {
    object (ChannelProfile)
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "experimentConfig": {
    object (ExperimentConfig)
  }
}
字段
name

string

标识符。相应部署的资源名称。格式：projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
displayName

string

必需。部署的显示名称。
appVersion

string

可选。要部署的应用版本的资源名称。格式：projects/{project}/locations/{location}/apps/{app}/versions/{version} 使用 projects/{project}/locations/{location}/apps/{app}/versions/- 可使用草稿应用。
channelProfile

object (ChannelProfile)

必需。部署中使用的渠道配置文件。
createTime

string (Timestamp format)

仅限输出。相应部署的创建时间戳。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

仅限输出。相应部署上次更新时的时间戳。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
etag

string

仅限输出。用于确保对象在读取-修改-写入操作期间未发生更改的 ETag。如果 etag 为空，则更新会覆盖任何并发更改。
experimentConfig

object (ExperimentConfig)

可选。部署的实验配置。

ChannelProfile

JSON 表示法 
{
  "profileId": string,
  "channelType": enum (ChannelType),
  "personaProperty": {
    object (PersonaProperty)
  },
  "disableDtmf": boolean,
  "disableBargeInControl": boolean,
  "webWidgetConfig": {
    object (WebWidgetConfig)
  },
  "noiseSuppressionLevel": string
}
字段
profileId

string

可选。频道配置的唯一标识符。
channelType

enum (ChannelType)

可选。渠道配置文件的类型。
personaProperty

object (PersonaProperty)

可选。频道资料的身份属性。
disableDtmf

boolean

可选。是否停用 DTMF（双音多频）。
disableBargeInControl

boolean

可选。是否在对话中停用用户抢占控制。- true：在代理说话时，系统会停用用户中断。- false：智能体保留对用户何时可以中断的自动控制权。
webWidgetConfig

object (WebWidgetConfig)

可选。Web widget 的配置。
noiseSuppressionLevel

string

可选。渠道配置文件的降噪级别。可选值为“low”“moderate”“high”“very_high”。

PersonaProperty

JSON 表示法 
{
  "persona": enum (Persona)
}
字段
persona

enum (Persona)

可选。频道的角色。

WebWidgetConfig

JSON 表示法 
{
  "modality": enum (Modality),
  "theme": enum (Theme),
  "webWidgetTitle": string,
  "securitySettings": {
    object (SecuritySettings)
  }
}
字段
modality

enum (Modality)

可选。网页 widget 的模态。
theme

enum (Theme)

可选。网络微件的主题。
webWidgetTitle

string

可选。网络 widget 的标题。
securitySettings

object (SecuritySettings)

可选。Web widget 的安全设置。

SecuritySettings

JSON 表示法 
{
  "enablePublicAccess": boolean,
  "enableOriginCheck": boolean,
  "allowedOrigins": [
    string
  ],
  "enableRecaptcha": boolean
}
字段
enablePublicAccess

boolean

可选。指示是否已启用对 Web widget 的公开访问权限。如果值为 true，则 Web widget 将可公开访问。如果为 false，则必须将 Web widget 与您自己的身份验证和授权系统集成，以返回用于访问 CES 代理的有效凭据。
enableOriginCheck

boolean

可选。指示是否为 Web widget 启用了来源检查。如果值为 true，则 Web widget 将检查加载该 Web widget 的网站的来源，并且仅允许在同一来源或任何允许的来源中加载该 Web widget。
allowedOrigins[]

string

可选。允许托管 Web widget 的来源。来源由 RFC 6454 定义。如果为空，则允许所有来源。最多允许 100 个来源。示例：“https://example.com”
enableRecaptcha

boolean

可选。指示是否已为 Web widget 启用 reCAPTCHA 验证。

时间戳

JSON 表示法 
{
  "seconds": string,
  "nanos": integer
}
字段
seconds

string (int64 format)

表示世界协调时间 (UTC) 的秒数（从 Unix 纪元 1970-01-01T00:00:00Z 开始算起）。必须介于 -62135596800 到 253402300799 之间（含边界值），对应于 0001-01-01T00:00:00Z 到 9999-12-31T23:59:59Z。
nanos

integer

秒数的非负小数部分（以纳秒为单位）。此字段是时长的纳秒部分，而不是秒的替代项。对于含小数部分的负秒数，仍必须包含按时间递升的非负纳秒值。必须在 0 到 999,999,999 之间（含边界值）。

ExperimentConfig

JSON 表示法 
{
  "versionRelease": {
    object (VersionRelease)
  }
}
字段
versionRelease

object (VersionRelease)

可选。实验的版本发布。

VersionRelease

JSON 表示法 
{
  "state": enum (State),
  "trafficAllocations": [
    {
      object (TrafficAllocation)
    }
  ]
}
字段
state

enum (State)

可选。版本发布的状态。
trafficAllocations[]

object (TrafficAllocation)

可选。版本发布的流量分配。

TrafficAllocation

JSON 表示法 
{
  "id": string,
  "trafficPercentage": integer,
  "appVersion": string
}
字段
id

string

可选。流量分配的 ID。自由格式的字符串，最多 128 个字符。
trafficPercentage

integer

可选。流量分配的流量百分比。必须介于 0 到 100 之间。
appVersion

string

可选。流量分配的应用版本。格式：projects/{project}/locations/{location}/apps/{app}/versions/{version}

ChannelType

渠道配置文件的类型。

枚举
UNKNOWN 未知渠道类型。
WEB_UI 网页界面渠道。
API API 渠道。
TWILIO Twilio 渠道。
GOOGLE_TELEPHONY_PLATFORM Google Telephony Platform 频道。
CONTACT_CENTER_AS_A_SERVICE Contact Center as a Service (CCaaS) 渠道。
FIVE9 Five9 渠道。
CONTACT_CENTER_INTEGRATION 第三方联络中心集成渠道。

角色

频道的角色。

枚举
UNKNOWN 未知角色。
CONCISE 智能体给出的回答简明扼要
CHATTY 代理会提供更多背景信息、说明和详细信息

模态

网页 widget 的模态。

枚举
MODALITY_UNSPECIFIED 未知模态。
CHAT_AND_VOICE 微件支持聊天和语音输入。
VOICE_ONLY 该 widget 仅支持语音输入。
CHAT_ONLY 微件仅支持聊天输入。
CHAT_VOICE_AND_VIDEO 微件支持聊天、语音和视频输入。

主题

网络微件的主题。

枚举
THEME_UNSPECIFIED 未知主题。
LIGHT 浅色主题。
DARK 深色主题。

州

实验的状态。

枚举
STATE_UNSPECIFIED 未指定状态。
PENDING 待处理状态。实验处于待处理状态，无效。
RUNNING 运行状态。实验正在运行且有效。
DONE 完成状态。实验已完成，不再有效。
EXPIRED 过期状态。实验已过期，不再有效。

输出架构

部署表示应用的不可变且可查询的版本。它用于部署具有特定渠道配置的应用版本。

部署

JSON 表示法 
{
  "name": string,
  "displayName": string,
  "appVersion": string,
  "channelProfile": {
    object (ChannelProfile)
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "experimentConfig": {
    object (ExperimentConfig)
  }
}
字段
name

string

标识符。相应部署的资源名称。格式：projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
displayName

string

必需。部署的显示名称。
appVersion

string

可选。要部署的应用版本的资源名称。格式：projects/{project}/locations/{location}/apps/{app}/versions/{version} 使用 projects/{project}/locations/{location}/apps/{app}/versions/- 可使用草稿应用。
channelProfile

object (ChannelProfile)

必需。部署中使用的渠道配置文件。
createTime

string (Timestamp format)

仅限输出。相应部署的创建时间戳。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

仅限输出。相应部署上次更新时的时间戳。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
etag

string

仅限输出。用于确保对象在读取-修改-写入操作期间未发生更改的 ETag。如果 etag 为空，则更新会覆盖任何并发更改。
experimentConfig

object (ExperimentConfig)

可选。部署的实验配置。

ChannelProfile

JSON 表示法 
{
  "profileId": string,
  "channelType": enum (ChannelType),
  "personaProperty": {
    object (PersonaProperty)
  },
  "disableDtmf": boolean,
  "disableBargeInControl": boolean,
  "webWidgetConfig": {
    object (WebWidgetConfig)
  },
  "noiseSuppressionLevel": string
}
字段
profileId

string

可选。频道配置的唯一标识符。
channelType

enum (ChannelType)

可选。渠道配置文件的类型。
personaProperty

object (PersonaProperty)

可选。频道资料的身份属性。
disableDtmf

boolean

可选。是否停用 DTMF（双音多频）。
disableBargeInControl

boolean

可选。是否在对话中停用用户抢占控制。- true：在代理说话时，系统会停用用户中断。- false：智能体保留对用户何时可以中断的自动控制权。
webWidgetConfig

object (WebWidgetConfig)

可选。Web widget 的配置。
noiseSuppressionLevel

string

可选。渠道配置文件的降噪级别。可选值为“low”“moderate”“high”“very_high”。

PersonaProperty

JSON 表示法 
{
  "persona": enum (Persona)
}
字段
persona

enum (Persona)

可选。频道的角色。

WebWidgetConfig

JSON 表示法 
{
  "modality": enum (Modality),
  "theme": enum (Theme),
  "webWidgetTitle": string,
  "securitySettings": {
    object (SecuritySettings)
  }
}
字段
modality

enum (Modality)

可选。网页 widget 的模态。
theme

enum (Theme)

可选。网络微件的主题。
webWidgetTitle

string

可选。网络 widget 的标题。
securitySettings

object (SecuritySettings)

可选。Web widget 的安全设置。

SecuritySettings

JSON 表示法 
{
  "enablePublicAccess": boolean,
  "enableOriginCheck": boolean,
  "allowedOrigins": [
    string
  ],
  "enableRecaptcha": boolean
}
字段
enablePublicAccess

boolean

可选。指示是否已启用对 Web widget 的公开访问权限。如果值为 true，则 Web widget 将可公开访问。如果为 false，则必须将 Web widget 与您自己的身份验证和授权系统集成，以返回用于访问 CES 代理的有效凭据。
enableOriginCheck

boolean

可选。指示是否为 Web widget 启用了来源检查。如果值为 true，则 Web widget 将检查加载该 Web widget 的网站的来源，并且仅允许在同一来源或任何允许的来源中加载该 Web widget。
allowedOrigins[]

string

可选。允许托管 Web widget 的来源。来源由 RFC 6454 定义。如果为空，则允许所有来源。最多允许 100 个来源。示例：“https://example.com”
enableRecaptcha

boolean

可选。指示是否已为 Web widget 启用 reCAPTCHA 验证。

时间戳

JSON 表示法 
{
  "seconds": string,
  "nanos": integer
}
字段
seconds

string (int64 format)

表示世界协调时间 (UTC) 的秒数（从 Unix 纪元 1970-01-01T00:00:00Z 开始算起）。必须介于 -62135596800 到 253402300799 之间（含边界值），对应于 0001-01-01T00:00:00Z 到 9999-12-31T23:59:59Z。
nanos

integer

秒数的非负小数部分（以纳秒为单位）。此字段是时长的纳秒部分，而不是秒的替代项。对于含小数部分的负秒数，仍必须包含按时间递升的非负纳秒值。必须在 0 到 999,999,999 之间（含边界值）。

ExperimentConfig

JSON 表示法 
{
  "versionRelease": {
    object (VersionRelease)
  }
}
字段
versionRelease

object (VersionRelease)

可选。实验的版本发布。

VersionRelease

JSON 表示法 
{
  "state": enum (State),
  "trafficAllocations": [
    {
      object (TrafficAllocation)
    }
  ]
}
字段
state

enum (State)

可选。版本发布的状态。
trafficAllocations[]

object (TrafficAllocation)

可选。版本发布的流量分配。

TrafficAllocation

JSON 表示法 
{
  "id": string,
  "trafficPercentage": integer,
  "appVersion": string
}
字段
id

string

可选。流量分配的 ID。自由格式的字符串，最多 128 个字符。
trafficPercentage

integer

可选。流量分配的流量百分比。必须介于 0 到 100 之间。
appVersion

string

可选。流量分配的应用版本。格式：projects/{project}/locations/{location}/apps/{app}/versions/{version}

ChannelType

渠道配置文件的类型。

枚举
UNKNOWN 未知渠道类型。
WEB_UI 网页界面渠道。
API API 渠道。
TWILIO Twilio 渠道。
GOOGLE_TELEPHONY_PLATFORM Google Telephony Platform 频道。
CONTACT_CENTER_AS_A_SERVICE Contact Center as a Service (CCaaS) 渠道。
FIVE9 Five9 渠道。
CONTACT_CENTER_INTEGRATION 第三方联络中心集成渠道。

角色

频道的角色。

枚举
UNKNOWN 未知角色。
CONCISE 智能体给出的回答简明扼要
CHATTY 代理会提供更多背景信息、说明和详细信息

模态

网页 widget 的模态。

枚举
MODALITY_UNSPECIFIED 未知模态。
CHAT_AND_VOICE 微件支持聊天和语音输入。
VOICE_ONLY 该 widget 仅支持语音输入。
CHAT_ONLY 微件仅支持聊天输入。
CHAT_VOICE_AND_VIDEO 微件支持聊天、语音和视频输入。

主题

网络微件的主题。

枚举
THEME_UNSPECIFIED 未知主题。
LIGHT 浅色主题。
DARK 深色主题。

州

实验的状态。

枚举
STATE_UNSPECIFIED 未指定状态。
PENDING 待处理状态。实验处于待处理状态，无效。
RUNNING 运行状态。实验正在运行且有效。
DONE 完成状态。实验已完成，不再有效。
EXPIRED 过期状态。实验已过期，不再有效。

工具注释

破坏性提示：✅ | 等幂性提示：❌ | 只读提示：❌ | 开放世界提示：❌