MCP Tools Reference: ces.googleapis.com

工具：list_deployments

列出给定应用中的部署。

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

Curl 请求 
                  
curl --location 'https://ces.[REGION].rep.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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

输入架构

AgentService.ListDeployments 的请求消息。

ListDeploymentsRequest

JSON 表示法 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "orderBy": string
}
字段
parent

string

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

integer

可选。要返回的部署数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 50 个部署。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
pageToken

string

可选。从之前的 ListDeployments 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时，提供给 ListDeployments 的所有其他参数必须与提供页面令牌的调用匹配。
orderBy

string

可选。要排序的字段。仅支持“name”和“create_time”。如需了解详情，请参阅 https://google.aip.dev/132#ordering。

输出架构

AgentService.ListDeployments 的响应消息。

ListDeploymentsResponse

JSON 表示法 
{
  "deployments": [
    {
      object (Deployment)
    }
  ],
  "nextPageToken": string
}
字段
deployments[]

object (Deployment)

部署列表。
nextPageToken

string

可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

部署

JSON 表示法 
{
  "name": string,
  "displayName": string,
  "appVersion": string,
  "channelProfile": {
    object (ChannelProfile)
  },
  "createTime": string,
  "updateTime": string,
  "etag": string
}
字段
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 为空，则更新会覆盖任何并发更改。

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 之间（含边界值）。

工具注释

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