MCP Tools Reference: ces.googleapis.com

ツール: update_deployment

指定されたデプロイを更新します。入力で常に更新マスクを渡すようにしてください。

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

入力スキーマ

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

UpdateDeploymentRequest

JSON 表現 
{
  "deployment": {
    object (Deployment)
  },
  "updateMask": string
}
フィールド
deployment

object (Deployment)

必須。更新するデプロイ。
updateMask

string (FieldMask format)

省略可。更新するフィールドのリスト。

完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo"。

デプロイ

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

省略可。チャネル プロファイルの一意の識別子。
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 にする必要があります（両端を含む）。

FieldMask

JSON 表現 
{
  "paths": [
    string
  ]
}
フィールド
paths[]

string

フィールド マスクパスのセット。

出力スキーマ

デプロイは、アプリの不変でクエリ可能なバージョンを表します。特定のチャンネル プロファイルでアプリのバージョンをデプロイするために使用されます。

デプロイ

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

省略可。チャネル プロファイルの一意の識別子。
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 にする必要があります（両端を含む）。

ツールのアノテーション

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