ツール: 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 ( |
| フィールド | |
|---|---|
parent |
必須。親アプリ。形式: |
deploymentId |
省略可。デプロイに使用する ID。デプロイのリソース名の最終的なコンポーネントになります。指定しない場合、デプロイに一意の ID が自動的に割り当てられます。 |
deployment |
必須。作成するデプロイ。 |
デプロイ
| JSON 表現 |
|---|
{ "name": string, "displayName": string, "appVersion": string, "channelProfile": { object ( |
| フィールド | |
|---|---|
name |
ID。デプロイの完全修飾リソース名。形式: |
displayName |
必須。デプロイの表示名。 |
appVersion |
省略可。デプロイするアプリ バージョンのリソース名。形式: |
channelProfile |
必須。デプロイで使用されるチャンネル プロファイル。 |
createTime |
出力専用。このデプロイが作成されたときのタイムスタンプ。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
updateTime |
出力専用。このデプロイが最後に更新されたタイムスタンプ。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
etag |
出力専用。読み取り、変更、書き込みオペレーション中にオブジェクトが変更されていないことを確認するために使用される ETag。etag が空の場合、更新によって同時変更が上書きされます。 |
experimentConfig |
省略可。デプロイのテスト構成。 |
whatsappCredentials |
省略可。入力専用。WhatsApp チャンネル プロファイルを構成するときに、一時的な WhatsApp 認証情報が必要です。 |
instagramCredentials |
省略可。入力専用。Instagram チャンネル プロファイルを設定する際に、一時的な Instagram 認証情報が必要になります。 |
modelSettings |
省略可。デプロイのモデル設定。アプリレベルまたはエージェント レベルで構成されたモデル設定をオーバーライドします。注: デプロイレベルのモデル設定のオーバーライドは、許可リストで制御されます。このフィールドを有効にするには、CXAS チームにお問い合わせください。 |
modality |
省略可。デプロイのモダリティ。注: デプロイレベルのモダリティのオーバーライドは、許可リストで制御されています。このフィールドを有効にするには、CXAS チームにお問い合わせください。 |
ChannelProfile
| JSON 表現 |
|---|
{ "profileId": string, "channelType": enum ( |
| フィールド | |
|---|---|
profileId |
省略可。チャネル プロファイルの一意の識別子。 |
channelType |
省略可。チャンネル プロファイルのタイプ。 |
personaProperty |
省略可。チャンネル プロファイルのペルソナ プロパティ。 |
webWidgetConfig |
省略可。ウェブ ウィジェットの構成。 |
whatsappConfig |
省略可。WhatsApp のデプロイに固有の構成。 |
instagramConfig |
省略可。Instagram デプロイ固有の構成。 |
共用体フィールド
|
|
disableDtmf |
省略可。DTMF(デュアルトーン マルチ周波数)を無効にするかどうか。 |
共用体フィールド
|
|
disableBargeInControl |
省略可。会話でユーザーの割り込み制御を無効にするかどうか。- true: エージェントが話している間、ユーザーによる割り込みが無効になります。- false: エージェントは、ユーザーが割り込みできるタイミングを自動的に制御します。 |
共用体フィールド
|
|
noiseSuppressionLevel |
省略可。チャンネル プロファイルのノイズ サプレッション レベル。使用可能な値は、「low」、「moderate」、「high」、「very_high」です。 |
PersonaProperty
| JSON 表現 |
|---|
{
"persona": enum ( |
| フィールド | |
|---|---|
persona |
省略可。チャンネルのペルソナ。 |
WebWidgetConfig
| JSON 表現 |
|---|
{ "modality": enum ( |
| フィールド | |
|---|---|
modality |
省略可。ウェブ ウィジェットのモダリティ。 |
theme |
省略可。ウェブ ウィジェットのテーマ。 |
webWidgetTitle |
省略可。ウェブ ウィジェットのタイトル。 |
securitySettings |
省略可。ウェブ ウィジェットのセキュリティ設定。 |
SecuritySettings
| JSON 表現 |
|---|
{ "enablePublicAccess": boolean, "enableOriginCheck": boolean, "allowedOrigins": [ string ], "enableRecaptcha": boolean } |
| フィールド | |
|---|---|
enablePublicAccess |
省略可。ウェブ ウィジェットへの一般公開アクセスが有効かどうかを示します。 |
enableOriginCheck |
省略可。ウェブ ウィジェットのオリジン チェックが有効かどうかを示します。 |
allowedOrigins[] |
省略可。ウェブ ウィジェットのホストを許可されているオリジン。オリジンは RFC 6454 で定義されています。空の場合、すべてのオリジンが許可されます。最大 100 個のオリジンを指定できます。例: "https://example.com" |
enableRecaptcha |
省略可。ウェブ ウィジェットの reCAPTCHA による確認が有効かどうかを示します。 |
WhatsAppConfig
| JSON 表現 |
|---|
{ "wabaId": string, "phoneNumberId": string, "phoneNumber": string, "displayName": string, "thumbnailUrl": string, "description": string } |
| フィールド | |
|---|---|
wabaId |
必須。WhatsApp Business のアカウント ID。 |
phoneNumberId |
必須。Meta の電話番号 ID。 |
phoneNumber |
省略可。E.164 形式の電話番号。 |
displayName |
出力専用。取得した Meta のビジネス ページ名。 |
thumbnailUrl |
出力専用。取得した Meta ビジネス プロフィールのサムネイル URL。 |
description |
出力専用。Meta のビジネス ページまたはプロフィールの説明。 |
InstagramConfig
| JSON 表現 |
|---|
{ "instagramAccountId": string, "displayName": string, "thumbnailUrl": string, "description": string } |
| フィールド | |
|---|---|
instagramAccountId |
必須。Instagram のアカウント ID。 |
displayName |
出力専用。取得した Meta のビジネス ページ名。 |
thumbnailUrl |
出力専用。取得した Meta ビジネス プロフィールのサムネイル URL。 |
description |
出力専用。Meta のビジネス ページまたはプロフィールの説明。 |
タイムスタンプ
| JSON 表現 |
|---|
{ "seconds": string, "nanos": integer } |
| フィールド | |
|---|---|
seconds |
UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800~253402300799 の範囲(両端を含む)にする必要があります(これは 0001-01-01T00:00:00Z~9999-12-31T23:59:59Z に対応します)。 |
nanos |
ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。0~999,999,999 にする必要があります(両端を含む)。 |
ExperimentConfig
| JSON 表現 |
|---|
{
"versionRelease": {
object ( |
| フィールド | |
|---|---|
versionRelease |
省略可。テストのバージョン リリース。 |
VersionRelease
| JSON 表現 |
|---|
{ "state": enum ( |
| フィールド | |
|---|---|
state |
省略可。バージョン リリースの状態。 |
trafficAllocations[] |
省略可。バージョン リリースのトラフィック割り当て。 |
TrafficAllocation
| JSON 表現 |
|---|
{ "id": string, "trafficPercentage": integer, "appVersion": string } |
| フィールド | |
|---|---|
id |
省略可。トラフィックの割り当ての ID。自由形式の文字列。最大 128 文字。 |
trafficPercentage |
省略可。トラフィックの割り当てのトラフィックの割合。0 ~ 100 の範囲で指定してください。 |
appVersion |
省略可。トラフィックの割り当てのアプリ バージョン。形式: |
WhatsAppCredentials
| JSON 表現 |
|---|
{ "authCode": string, "pin": string, "phoneNumber": string, "businessAccountId": string, "wabaId": string, "conversationProfileId": string } |
| フィールド | |
|---|---|
authCode |
必須。埋め込み登録フローによって提供される Meta 認証コード。 |
pin |
必須。2 段階認証プロセス用にユーザーが作成した 6 桁の PIN。 |
phoneNumber |
必須。WhatsApp に登録する電話番号。 |
businessAccountId |
必須。電話番号に使用するビジネス アカウント ID。 |
wabaId |
必須。WhatsApp Business のアカウント ID。 |
conversationProfileId |
省略可。デプロイに使用する会話プロファイル ID。 |
InstagramCredentials
| JSON 表現 |
|---|
{ "authCode": string, "conversationProfileId": string } |
| フィールド | |
|---|---|
authCode |
必須。埋め込み登録フローによって提供される Meta 認証コード。 |
conversationProfileId |
省略可。デプロイに使用する会話プロファイル ID。 |
ModelSettings
| JSON 表現 |
|---|
{ "model": string, // Union field |
| フィールド | |
|---|---|
model |
省略可。エージェントが使用する LLM モデル。設定されていない場合、エージェントは親エージェントからモデルを継承します。 |
共用体フィールド
|
|
temperature |
省略可。設定すると、この 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 |
動画モダリティ。 |
出力スキーマ
デプロイは、アプリの不変でクエリ可能なバージョンを表します。特定のチャンネル プロファイルでアプリのバージョンをデプロイするために使用されます。
デプロイ
| JSON 表現 |
|---|
{ "name": string, "displayName": string, "appVersion": string, "channelProfile": { object ( |
| フィールド | |
|---|---|
name |
ID。デプロイの完全修飾リソース名。形式: |
displayName |
必須。デプロイの表示名。 |
appVersion |
省略可。デプロイするアプリ バージョンのリソース名。形式: |
channelProfile |
必須。デプロイで使用されるチャンネル プロファイル。 |
createTime |
出力専用。このデプロイが作成されたときのタイムスタンプ。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
updateTime |
出力専用。このデプロイが最後に更新されたタイムスタンプ。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
etag |
出力専用。読み取り、変更、書き込みオペレーション中にオブジェクトが変更されていないことを確認するために使用される ETag。etag が空の場合、更新によって同時変更が上書きされます。 |
experimentConfig |
省略可。デプロイのテスト構成。 |
whatsappCredentials |
省略可。入力専用。WhatsApp チャンネル プロファイルを構成するときに、一時的な WhatsApp 認証情報が必要です。 |
instagramCredentials |
省略可。入力専用。Instagram チャンネル プロファイルを設定する際に、一時的な Instagram 認証情報が必要になります。 |
modelSettings |
省略可。デプロイのモデル設定。アプリレベルまたはエージェント レベルで構成されたモデル設定をオーバーライドします。注: デプロイレベルのモデル設定のオーバーライドは、許可リストで制御されます。このフィールドを有効にするには、CXAS チームにお問い合わせください。 |
modality |
省略可。デプロイのモダリティ。注: デプロイレベルのモダリティのオーバーライドは、許可リストで制御されています。このフィールドを有効にするには、CXAS チームにお問い合わせください。 |
ChannelProfile
| JSON 表現 |
|---|
{ "profileId": string, "channelType": enum ( |
| フィールド | |
|---|---|
profileId |
省略可。チャネル プロファイルの一意の識別子。 |
channelType |
省略可。チャンネル プロファイルのタイプ。 |
personaProperty |
省略可。チャンネル プロファイルのペルソナ プロパティ。 |
webWidgetConfig |
省略可。ウェブ ウィジェットの構成。 |
whatsappConfig |
省略可。WhatsApp のデプロイに固有の構成。 |
instagramConfig |
省略可。Instagram デプロイ固有の構成。 |
共用体フィールド
|
|
disableDtmf |
省略可。DTMF(デュアルトーン マルチ周波数)を無効にするかどうか。 |
共用体フィールド
|
|
disableBargeInControl |
省略可。会話でユーザーの割り込み制御を無効にするかどうか。- true: エージェントが話している間、ユーザーによる割り込みが無効になります。- false: エージェントは、ユーザーが割り込みできるタイミングを自動的に制御します。 |
共用体フィールド
|
|
noiseSuppressionLevel |
省略可。チャンネル プロファイルのノイズ サプレッション レベル。使用可能な値は、「low」、「moderate」、「high」、「very_high」です。 |
PersonaProperty
| JSON 表現 |
|---|
{
"persona": enum ( |
| フィールド | |
|---|---|
persona |
省略可。チャンネルのペルソナ。 |
WebWidgetConfig
| JSON 表現 |
|---|
{ "modality": enum ( |
| フィールド | |
|---|---|
modality |
省略可。ウェブ ウィジェットのモダリティ。 |
theme |
省略可。ウェブ ウィジェットのテーマ。 |
webWidgetTitle |
省略可。ウェブ ウィジェットのタイトル。 |
securitySettings |
省略可。ウェブ ウィジェットのセキュリティ設定。 |
SecuritySettings
| JSON 表現 |
|---|
{ "enablePublicAccess": boolean, "enableOriginCheck": boolean, "allowedOrigins": [ string ], "enableRecaptcha": boolean } |
| フィールド | |
|---|---|
enablePublicAccess |
省略可。ウェブ ウィジェットへの一般公開アクセスが有効かどうかを示します。 |
enableOriginCheck |
省略可。ウェブ ウィジェットのオリジン チェックが有効かどうかを示します。 |
allowedOrigins[] |
省略可。ウェブ ウィジェットのホストを許可されているオリジン。オリジンは RFC 6454 で定義されています。空の場合、すべてのオリジンが許可されます。最大 100 個のオリジンを指定できます。例: "https://example.com" |
enableRecaptcha |
省略可。ウェブ ウィジェットの reCAPTCHA による確認が有効かどうかを示します。 |
WhatsAppConfig
| JSON 表現 |
|---|
{ "wabaId": string, "phoneNumberId": string, "phoneNumber": string, "displayName": string, "thumbnailUrl": string, "description": string } |
| フィールド | |
|---|---|
wabaId |
必須。WhatsApp Business のアカウント ID。 |
phoneNumberId |
必須。Meta の電話番号 ID。 |
phoneNumber |
省略可。E.164 形式の電話番号。 |
displayName |
出力専用。取得した Meta のビジネス ページ名。 |
thumbnailUrl |
出力専用。取得した Meta ビジネス プロフィールのサムネイル URL。 |
description |
出力専用。Meta のビジネス ページまたはプロフィールの説明。 |
InstagramConfig
| JSON 表現 |
|---|
{ "instagramAccountId": string, "displayName": string, "thumbnailUrl": string, "description": string } |
| フィールド | |
|---|---|
instagramAccountId |
必須。Instagram のアカウント ID。 |
displayName |
出力専用。取得した Meta のビジネス ページ名。 |
thumbnailUrl |
出力専用。取得した Meta ビジネス プロフィールのサムネイル URL。 |
description |
出力専用。Meta のビジネス ページまたはプロフィールの説明。 |
タイムスタンプ
| JSON 表現 |
|---|
{ "seconds": string, "nanos": integer } |
| フィールド | |
|---|---|
seconds |
UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800~253402300799 の範囲(両端を含む)にする必要があります(これは 0001-01-01T00:00:00Z~9999-12-31T23:59:59Z に対応します)。 |
nanos |
ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。0~999,999,999 にする必要があります(両端を含む)。 |
ExperimentConfig
| JSON 表現 |
|---|
{
"versionRelease": {
object ( |
| フィールド | |
|---|---|
versionRelease |
省略可。テストのバージョン リリース。 |
VersionRelease
| JSON 表現 |
|---|
{ "state": enum ( |
| フィールド | |
|---|---|
state |
省略可。バージョン リリースの状態。 |
trafficAllocations[] |
省略可。バージョン リリースのトラフィック割り当て。 |
TrafficAllocation
| JSON 表現 |
|---|
{ "id": string, "trafficPercentage": integer, "appVersion": string } |
| フィールド | |
|---|---|
id |
省略可。トラフィックの割り当ての ID。自由形式の文字列。最大 128 文字。 |
trafficPercentage |
省略可。トラフィックの割り当てのトラフィックの割合。0 ~ 100 の範囲で指定してください。 |
appVersion |
省略可。トラフィックの割り当てのアプリ バージョン。形式: |
WhatsAppCredentials
| JSON 表現 |
|---|
{ "authCode": string, "pin": string, "phoneNumber": string, "businessAccountId": string, "wabaId": string, "conversationProfileId": string } |
| フィールド | |
|---|---|
authCode |
必須。埋め込み登録フローによって提供される Meta 認証コード。 |
pin |
必須。2 段階認証プロセス用にユーザーが作成した 6 桁の PIN。 |
phoneNumber |
必須。WhatsApp に登録する電話番号。 |
businessAccountId |
必須。電話番号に使用するビジネス アカウント ID。 |
wabaId |
必須。WhatsApp Business のアカウント ID。 |
conversationProfileId |
省略可。デプロイに使用する会話プロファイル ID。 |
InstagramCredentials
| JSON 表現 |
|---|
{ "authCode": string, "conversationProfileId": string } |
| フィールド | |
|---|---|
authCode |
必須。埋め込み登録フローによって提供される Meta 認証コード。 |
conversationProfileId |
省略可。デプロイに使用する会話プロファイル ID。 |
ModelSettings
| JSON 表現 |
|---|
{ "model": string, // Union field |
| フィールド | |
|---|---|
model |
省略可。エージェントが使用する LLM モデル。設定されていない場合、エージェントは親エージェントからモデルを継承します。 |
共用体フィールド
|
|
temperature |
省略可。設定すると、この 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 の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。
破壊的ヒント: ✅ | べき等ヒント: ❌ | 読み取り専用ヒント: ❌ | オープン ワールド ヒント: ❌