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

選用。部署作業要使用的 ID，會成為部署作業資源名稱的最終元件。如未提供，系統會自動為部署作業指派專屬 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

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 為空，更新作業會覆寫任何並行變更。
experimentConfig

object (ExperimentConfig)

選用。部署作業的實驗設定。

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 之間 (含)。

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 網頁版 UI 管道。
API API 管道。
TWILIO Twilio 管道。
GOOGLE_TELEPHONY_PLATFORM Google 電話平台頻道。
CONTACT_CENTER_AS_A_SERVICE Contact Center as a Service (CCaaS) 管道。
FIVE9 Five9 頻道。
CONTACT_CENTER_INTEGRATION 第三方客服中心整合管道。

角色

頻道的角色。

列舉
UNKNOWN UNKNOWN persona。
CONCISE 代理會提供簡潔扼要的回覆
CHATTY 服務專員提供額外背景資訊、說明和詳細資料

模態

網頁小工具的模式。

列舉
MODALITY_UNSPECIFIED 不明模式。
CHAT_AND_VOICE 小工具支援即時通訊和語音輸入。
VOICE_ONLY 小工具僅支援語音輸入。
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

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 為空，更新作業會覆寫任何並行變更。
experimentConfig

object (ExperimentConfig)

選用。部署作業的實驗設定。

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 之間 (含)。

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 網頁版 UI 管道。
API API 管道。
TWILIO Twilio 管道。
GOOGLE_TELEPHONY_PLATFORM Google 電話平台頻道。
CONTACT_CENTER_AS_A_SERVICE Contact Center as a Service (CCaaS) 管道。
FIVE9 Five9 頻道。
CONTACT_CENTER_INTEGRATION 第三方客服中心整合管道。

角色

頻道的角色。

列舉
UNKNOWN UNKNOWN persona。
CONCISE 代理會提供簡潔扼要的回覆
CHATTY 服務專員提供額外背景資訊、說明和詳細資料

模態

網頁小工具的模式。

列舉
MODALITY_UNSPECIFIED 不明模式。
CHAT_AND_VOICE 小工具支援即時通訊和語音輸入。
VOICE_ONLY 小工具僅支援語音輸入。
CHAT_ONLY 小工具僅支援輸入文字。
CHAT_VOICE_AND_VIDEO 小工具支援即時通訊、語音和視訊輸入。

主題

網頁小工具的主題。

列舉
THEME_UNSPECIFIED 不明主題。
LIGHT 淺色主題。
DARK 深色主題。

狀態

實驗狀態。

列舉
STATE_UNSPECIFIED 未指定狀態。
PENDING 待處理狀態。實驗處於待處理狀態，因此無效。
RUNNING 執行狀態。實驗正在執行中，且有效。
DONE 完成狀態。實驗已完成，不再有效。
EXPIRED 過期狀態。實驗已過期，不再有效。

工具註解

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