MCP Tools Reference: ces.googleapis.com

ツール: get_deployment

指定されたデプロイの詳細を取得します。

次のコードサンプルは、curl を使用して get_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": "get_deployment",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

AgentService.GetDeployment のリクエスト メッセージです。

GetDeploymentRequest

JSON 表現 
{
  "name": string
}
フィールド
name

string

必須。デプロイの名前。形式: projects/{project}/locations/{location}/apps/{app}/deployments/{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)
}
フィールド
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)

省略可。デプロイのテスト構成。
whatsappCredentials

object (WhatsAppCredentials)

省略可。入力専用。WhatsApp チャンネル プロファイルを構成するときに、一時的な WhatsApp 認証情報が必要です。
instagramCredentials

object (InstagramCredentials)

省略可。入力専用。Instagram チャンネル プロファイルを設定する際に、一時的な Instagram 認証情報が必要になります。
modelSettings

object (ModelSettings)

省略可。デプロイのモデル設定。アプリレベルまたはエージェント レベルで構成されたモデル設定をオーバーライドします。注: デプロイレベルのモデル設定のオーバーライドは、許可リストで制御されます。このフィールドを有効にするには、CXAS チームにお問い合わせください。
modality

enum (Modality)

省略可。デプロイのモダリティ。注: デプロイレベルのモダリティのオーバーライドは、許可リストで制御されています。このフィールドを有効にするには、CXAS チームにお問い合わせください。

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)

省略可。ウェブ ウィジェットの構成。
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)

省略可。ウェブ ウィジェットのモダリティ。
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 による確認が有効かどうかを示します。

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 ビジネス プロフィールのサムネイル URL。
description

string

出力専用。Meta のビジネス ページまたはプロフィールの説明。

InstagramConfig

JSON 表現 
{
  "instagramAccountId": string,
  "displayName": string,
  "thumbnailUrl": string,
  "description": string
}
フィールド
instagramAccountId

string

必須。Instagram のアカウント ID。
displayName

string

出力専用。取得した Meta のビジネス ページ名。
thumbnailUrl

string

出力専用。取得した Meta ビジネス プロフィールのサムネイル URL。
description

string

出力専用。Meta のビジネス ページまたはプロフィールの説明。

タイムスタンプ

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}

WhatsAppCredentials

JSON 表現 
{
  "authCode": string,
  "pin": string,
  "phoneNumber": string,
  "businessAccountId": string,
  "wabaId": string,
  "conversationProfileId": string
}
フィールド
authCode

string

必須。埋め込み登録フローによって提供される Meta 認証コード。
pin

string

必須。2 段階認証プロセス用にユーザーが作成した 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,

  // 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 モデル。設定されていない場合、エージェントは親エージェントからモデルを継承します。

共用体フィールド _temperature。

_temperature は次のいずれかになります。
temperature

number

省略可。設定すると、この Temperature が LLM モデルに使用されます。Temperature は、モデルのレスポンスのランダム性を制御します。温度が低いほど、予測しやすい回答が生成されます。温度が高いほど、より創造的な回答が生成されます。

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）チャネル。
CONTACT_CENTER_AS_A_SERVICE_CHAT Contact Center as a Service（CCaaS Chat）チャネル。
FIVE9 Five9 チャネル。
CONTACT_CENTER_INTEGRATION サードパーティのコンタクト センター統合チャネル。
WHATSAPP WhatsApp チャンネル。
INSTAGRAM Instagram チャンネル。

ペルソナ

チャンネルのペルソナ。

列挙型
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 非推奨: この状態は使用されなくなりました。

モダリティ

デプロイのモダリティ。

列挙型
MODALITY_UNSPECIFIED 不明なモダリティ。
MODALITY_TEXT テキスト モダリティ。
MODALITY_VOICE 音声モダリティ。
MODALITY_VIDEO 動画モダリティ。

ツールのアノテーション

ツールのアノテーションは、特定のツールの基本的なリスクを説明するために MCP クライアントに送信されます。ほとんどのクライアントはこれらのヒントを信頼できないものとして扱いますが、確認プロンプトをユーザーに送信するタイミングを決定するために使用できます。

タイトル文字列とともに、次のブール値のヒントが次のように定義されています。

  • readOnlyHint: true の場合、ツールは環境を変更しません。デフォルトは false です。
  • destructiveHint: true の場合、ツールは破壊的なアクションを実行できます。false の場合、ツールは追加アクションのみを実行できます。デフォルト値は true です。
  • idempotentHint: true の場合、同じ引数でツールを繰り返し呼び出しても、環境に影響はありません。デフォルトは false です。
  • openWorldHint: true の場合、ツールは外部エンティティの「オープン ワールド」とやり取りできます。false の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

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