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

省略可。チャネル プロファイルの一意の識別子。
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 からの UTC 時刻の秒数を表します。-62135596800～253402300799 の範囲（両端を含む）にする必要があります（これは 0001-01-01T00:00:00Z～9999-12-31T23:59:59Z に対応します）。
nanos

integer

ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。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 Telephony Platform チャンネル。
CONTACT_CENTER_AS_A_SERVICE Contact Center as a Service（CCaaS）チャネル。
FIVE9 Five9 チャネル。
CONTACT_CENTER_INTEGRATION サードパーティのコンタクト センター統合チャネル。

ペルソナ

チャンネルのペルソナ。

列挙型
UNKNOWN UNKNOWN ペルソナ。
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

省略可。チャネル プロファイルの一意の識別子。
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 からの UTC 時刻の秒数を表します。-62135596800～253402300799 の範囲（両端を含む）にする必要があります（これは 0001-01-01T00:00:00Z～9999-12-31T23:59:59Z に対応します）。
nanos

integer

ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。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 Telephony Platform チャンネル。
CONTACT_CENTER_AS_A_SERVICE Contact Center as a Service（CCaaS）チャネル。
FIVE9 Five9 チャネル。
CONTACT_CENTER_INTEGRATION サードパーティのコンタクト センター統合チャネル。

ペルソナ

チャンネルのペルソナ。

列挙型
UNKNOWN UNKNOWN ペルソナ。
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 期限切れの状態。テストの有効期限が切れており、無効になっています。

ツールのアノテーション

破壊的ヒント: ✅ | べき等ヒント: ❌ | 読み取り専用ヒント: ❌ | オープン ワールド ヒント: ❌