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 個部署作業。許可的最大值為 1000；超出的數值將一律指定為 1000。
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

ID。部署作業的資源名稱。格式：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 正規化，並使用 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 正規化，並使用 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

選用。頻道設定檔的專屬 ID。
channelType

enum (ChannelType)

選用。頻道設定檔類型。
personaProperty

object (PersonaProperty)

選用。頻道個人資料的目標對象屬性。
disableDtmf

boolean

選用。是否停用 DTMF (雙音多頻)。
disableBargeInControl

boolean

選用。是否要在對話中停用使用者插話控制項。- true：代理程式說話時，系統會停用使用者中斷功能。- false：代理程式會保留自動控制權，決定使用者何時可以中斷。
webWidgetConfig

object (WebWidgetConfig)

選用。網頁小工具的設定。
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)

選用。網頁小工具的模式。
theme

enum (Theme)

選用。網頁小工具的主題。
webWidgetTitle

string

選用。網頁小工具的標題。
securitySettings

object (SecuritySettings)

選用。網頁小工具的安全設定。

SecuritySettings

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

boolean

選用。指出是否已啟用網頁小工具的公開存取權。如果設為 true，網頁小工具就會公開。如為 false，網頁小工具必須與您自己的驗證和授權系統整合，才能傳回存取 CES 服務專員的有效憑證。
enableOriginCheck

boolean

選用。指出是否已啟用網頁小工具的來源檢查。如果 true，網頁小工具會檢查載入網頁小工具的網站來源，只允許在相同來源或任何允許的來源中載入。
allowedOrigins[]

string

選用。允許託管網頁小工具的來源。來源的定義請參閱 RFC 6454。如果留空，系統會允許所有來源。最多只能加入 100 個來源。例如：「https://example.com」
enableRecaptcha

boolean

選用。指出是否已啟用網頁小工具的 reCAPTCHA 驗證。

時間戳記

JSON 表示法 
{
  "seconds": string,
  "nanos": integer
}
欄位
seconds

string (int64 format)

代表自 Unix 紀元 1970-01-01T00:00:00Z 起算的世界標準時間秒數。必須介於 -62135596800 和 253402300799 之間 (含)，對應至 0001-01-01T00:00:00Z 至 9999-12-31T23:59:59Z。
nanos

integer

以奈秒為單位的非負秒數小數。這個欄位是時間長度的奈秒部分，並非秒數的替代值。如果第二個值為負數，且包含分數，奈秒值仍須為非負數，且會向前計時。必須介於 0 至 999,999,999 之間 (含)。

工具註解

破壞性提示：❌ | 等冪提示：✅ | 唯讀提示：✅ | 開放世界提示：❌