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 MCP tool 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

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

object (Deployment)

必需。要创建的部署。

部署

JSON 表示法 
{
  "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)
  }
}
字段
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)

可选。部署的实验配置。
whatsappCredentials

object (WhatsAppCredentials)

可选。仅限输入。配置 WhatsApp 渠道配置文件时需要临时 WhatsApp 凭据。
instagramCredentials

object (InstagramCredentials)

可选。仅限输入。配置 Instagram 频道个人资料时需要临时 Instagram 凭据。
modelSettings

object (ModelSettings)

可选。部署的模型设置。覆盖在应用/代理级别配置的模型设置。注意：部署级模型设置覆盖功能受许可名单限制。请与 CXAS 团队联系以启用此字段。
modality

enum (Modality)

可选。部署的模态。注意：部署级模态替换功能受许可名单限制。请与 CXAS 团队联系以启用此字段。
agentRegistryDeployment

object (AgentRegistryDeployment)

可选。将此部署部署到 Agent Registry 的配置。如果存在，此部署将发布到 Agent Registry。

ChannelProfile

JSON 表示法 
{
  "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.
}
字段
profileId

string

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

enum (ChannelType)

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

object (PersonaProperty)

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

object (WebWidgetConfig)

可选。Web widget 的配置。
whatsappConfig

object (WhatsAppConfig)

可选。特定于 WhatsApp 部署的配置。
instagramConfig

object (InstagramConfig)

可选。特定于 Instagram 部署的配置。

联合字段 _disable_dtmf。

_disable_dtmf 只能是下列其中一项：
disableDtmf

boolean

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

联合字段 _disable_barge_in_control。

_disable_barge_in_control 只能是下列其中一项：
disableBargeInControl

boolean

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

联合字段 _noise_suppression_level。

_noise_suppression_level 只能是下列其中一项：
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)

可选。网络 widget 的主题。
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 将检查加载该 widget 的网站的来源，并且仅允许在同一来源或任何允许的来源中加载该 widget。
allowedOrigins[]

string

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

boolean

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

WhatsAppConfig

JSON 表示法 
{
  "wabaId": string,
  "phoneNumberId": string,
  "phoneNumber": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
字段
wabaId

string

必需。WhatsApp Business 账号 ID。
phoneNumberId

string

必需。Meta 手机号码 ID。
phoneNumber

string

可选。采用 E.164 格式的手机号码。
displayName

string

仅限输出。提取的 Meta 企业页面名称。
thumbnailUrl

string

仅限输出。提取的 Meta 商家资料缩略图网址。
description

string

仅限输出。Meta 商家页面或资料的说明。

InstagramConfig

JSON 表示法 
{
  "instagramAccountId": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
字段
instagramAccountId

string

必需。Instagram 账号 ID。
displayName

string

仅限输出。提取的 Meta 企业页面名称。
thumbnailUrl

string

仅限输出。提取的 Meta 商家资料缩略图网址。
description

string

仅限输出。Meta 商家页面或资料的说明。

时间戳

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}

WhatsAppCredentials

JSON 表示法 
{
  "authCode": string,
  "pin": string,
  "phoneNumber": string,
  "businessAccountId": string,
  "wabaId": string,
  "conversationProfileId": string
}
字段
authCode

string

必需。嵌入式注册流程提供的 Meta 授权代码。
pin

string

必需。用户为两步验证创建的 6 位数 PIN 码。
phoneNumber

string

必需。用于注册 WhatsApp 的手机号码。
businessAccountId

string

必需。要用于手机号码的商家账号 ID。
wabaId

string

必需。WhatsApp Business 账号 ID。
conversationProfileId

string

可选。要用于部署的对话配置文件 ID。

InstagramCredentials

JSON 表示法 
{
  "authCode": string,
  "conversationProfileId": string
}
字段
authCode

string

必需。嵌入式注册流程提供的 Meta 授权代码。
conversationProfileId

string

可选。要用于部署的对话配置文件 ID。

ModelSettings

JSON 表示法 
{
  "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.
}
字段
model

string

可选。智能体应使用的 LLM 模型。如果未设置，代理将从其父智能体继承模型。
thinkingLevel

enum (ThinkingLevel)

可选。模型的思考等级。

联合字段 _temperature。

_temperature 只能是下列其中一项：
temperature

number

可选。如果设置，系统将使用此温度值来运行 LLM 模型。温度可控制模型回答的随机性。温度越低，生成的回答就越可预测。温度越高，生成的回答就越有创意。

AgentRegistryDeployment

JSON 表示法 
{
  "agentRegistryServiceName": string
}
字段
agentRegistryServiceName

string

可选。仅限输出。已部署的 Agent Registry 服务的资源名称。格式：projects/{project}/locations/{location}/services/{service}

ChannelType

渠道配置文件的类型。

枚举
UNKNOWN 未知渠道类型。
WEB_UI Web 界面渠道。
API API 渠道。
TWILIO Twilio 渠道。
GOOGLE_TELEPHONY_PLATFORM Google Telephony Platform 渠道。
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 渠道。
CONTACT_CENTER_INTEGRATION 第三方联络中心集成渠道。
WHATSAPP WhatsApp 频道。
INSTAGRAM Instagram 频道。

角色

频道的角色。

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

模态

网页 widget 的模态。

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

主题

网络 widget 的主题。

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

州

实验的状态。

枚举
STATE_UNSPECIFIED 未指定状态。
PENDING 已弃用：此状态不再使用。
RUNNING 运行状态。实验正在运行且有效。
DONE 已弃用：此状态不再使用。
EXPIRED 已弃用：此状态不再使用。

ThinkingLevel

模型的思考水平配置。

枚举
THINKING_LEVEL_UNSPECIFIED 思考等级未指定。
DEFAULT 默认思考等级。
LOW 低思考等级。
MEDIUM 中等思考等级。
HIGH 高思考等级。

模态

部署的模态。

枚举
MODALITY_UNSPECIFIED 未知模态。
MODALITY_TEXT 文本模态。
MODALITY_VOICE 语音模态。
MODALITY_VIDEO 视频模态。

输出架构

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

部署

JSON 表示法 
{
  "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)
  }
}
字段
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)

可选。部署的实验配置。
whatsappCredentials

object (WhatsAppCredentials)

可选。仅限输入。配置 WhatsApp 渠道配置文件时需要临时 WhatsApp 凭据。
instagramCredentials

object (InstagramCredentials)

可选。仅限输入。配置 Instagram 频道个人资料时需要临时 Instagram 凭据。
modelSettings

object (ModelSettings)

可选。部署的模型设置。覆盖在应用/代理级别配置的模型设置。注意：部署级模型设置覆盖功能受许可名单限制。请与 CXAS 团队联系以启用此字段。
modality

enum (Modality)

可选。部署的模态。注意：部署级模态替换功能受许可名单限制。请与 CXAS 团队联系以启用此字段。
agentRegistryDeployment

object (AgentRegistryDeployment)

可选。将此部署部署到 Agent Registry 的配置。如果存在，此部署将发布到 Agent Registry。

ChannelProfile

JSON 表示法 
{
  "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.
}
字段
profileId

string

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

enum (ChannelType)

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

object (PersonaProperty)

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

object (WebWidgetConfig)

可选。Web widget 的配置。
whatsappConfig

object (WhatsAppConfig)

可选。特定于 WhatsApp 部署的配置。
instagramConfig

object (InstagramConfig)

可选。特定于 Instagram 部署的配置。

联合字段 _disable_dtmf。

_disable_dtmf 只能是下列其中一项：
disableDtmf

boolean

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

联合字段 _disable_barge_in_control。

_disable_barge_in_control 只能是下列其中一项：
disableBargeInControl

boolean

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

联合字段 _noise_suppression_level。

_noise_suppression_level 只能是下列其中一项：
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)

可选。网络 widget 的主题。
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 将检查加载该 widget 的网站的来源，并且仅允许在同一来源或任何允许的来源中加载该 widget。
allowedOrigins[]

string

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

boolean

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

WhatsAppConfig

JSON 表示法 
{
  "wabaId": string,
  "phoneNumberId": string,
  "phoneNumber": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
字段
wabaId

string

必需。WhatsApp Business 账号 ID。
phoneNumberId

string

必需。Meta 手机号码 ID。
phoneNumber

string

可选。采用 E.164 格式的手机号码。
displayName

string

仅限输出。提取的 Meta 企业页面名称。
thumbnailUrl

string

仅限输出。提取的 Meta 商家资料缩略图网址。
description

string

仅限输出。Meta 商家页面或资料的说明。

InstagramConfig

JSON 表示法 
{
  "instagramAccountId": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
字段
instagramAccountId

string

必需。Instagram 账号 ID。
displayName

string

仅限输出。提取的 Meta 企业页面名称。
thumbnailUrl

string

仅限输出。提取的 Meta 商家资料缩略图网址。
description

string

仅限输出。Meta 商家页面或资料的说明。

时间戳

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}

WhatsAppCredentials

JSON 表示法 
{
  "authCode": string,
  "pin": string,
  "phoneNumber": string,
  "businessAccountId": string,
  "wabaId": string,
  "conversationProfileId": string
}
字段
authCode

string

必需。嵌入式注册流程提供的 Meta 授权代码。
pin

string

必需。用户为两步验证创建的 6 位数 PIN 码。
phoneNumber

string

必需。用于注册 WhatsApp 的手机号码。
businessAccountId

string

必需。要用于手机号码的商家账号 ID。
wabaId

string

必需。WhatsApp Business 账号 ID。
conversationProfileId

string

可选。要用于部署的对话配置文件 ID。

InstagramCredentials

JSON 表示法 
{
  "authCode": string,
  "conversationProfileId": string
}
字段
authCode

string

必需。嵌入式注册流程提供的 Meta 授权代码。
conversationProfileId

string

可选。要用于部署的对话配置文件 ID。

ModelSettings

JSON 表示法 
{
  "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.
}
字段
model

string

可选。智能体应使用的 LLM 模型。如果未设置，代理将从其父智能体继承模型。
thinkingLevel

enum (ThinkingLevel)

可选。模型的思考等级。

联合字段 _temperature。

_temperature 只能是下列其中一项：
temperature

number

可选。如果设置，系统将使用此温度值来运行 LLM 模型。温度可控制模型回答的随机性。温度越低，生成的回答就越可预测。温度越高，生成的回答就越有创意。

AgentRegistryDeployment

JSON 表示法 
{
  "agentRegistryServiceName": string
}
字段
agentRegistryServiceName

string

可选。仅限输出。已部署的 Agent Registry 服务的资源名称。格式：projects/{project}/locations/{location}/services/{service}

ChannelType

渠道配置文件的类型。

枚举
UNKNOWN 未知渠道类型。
WEB_UI Web 界面渠道。
API API 渠道。
TWILIO Twilio 渠道。
GOOGLE_TELEPHONY_PLATFORM Google Telephony Platform 渠道。
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 渠道。
CONTACT_CENTER_INTEGRATION 第三方联络中心集成渠道。
WHATSAPP WhatsApp 频道。
INSTAGRAM Instagram 频道。

角色

频道的角色。

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

模态

网页 widget 的模态。

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

主题

网络 widget 的主题。

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

州

实验的状态。

枚举
STATE_UNSPECIFIED 未指定状态。
PENDING 已弃用：此状态不再使用。
RUNNING 运行状态。实验正在运行且有效。
DONE 已弃用：此状态不再使用。
EXPIRED 已弃用：此状态不再使用。

ThinkingLevel

模型的思考水平配置。

枚举
THINKING_LEVEL_UNSPECIFIED 思考等级未指定。
DEFAULT 默认思考等级。
LOW 低思考等级。
MEDIUM 中等思考等级。
HIGH 高思考等级。

模态

部署的模态。

枚举
MODALITY_UNSPECIFIED 未知模态。
MODALITY_TEXT 文本模态。
MODALITY_VOICE 语音模态。
MODALITY_VIDEO 视频模态。

工具注释

工具注释会发送给 MCP 客户端，用于描述指定工具的基本风险。大多数客户端会将这些提示视为不受信任的，但它们可用于确定何时向用户发送确认提示。

除了标题字符串之外，还定义了以下布尔值提示：

  • readOnlyHint：如果为 true，则工具不会修改其环境。默认值：false。
  • destructiveHint：如果为 true，则工具可以执行破坏性操作。如果为 false，则该工具只能执行添加操作。默认值：true。
  • idempotentHint：如果为 true，则使用相同实参重复调用该工具不会对其环境产生任何额外影响。默认值：false。
  • openWorldHint：如果为 true，则工具可以与外部实体的“开放世界”进行交互。如果为 false，则该工具只能与内部实体互动。例如，网络搜索工具是开放世界，而内存工具不是开放世界。

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