エージェントを作成するときは、 エージェントのロケーションとして リージョン を指定する必要があります。 エージェントに送信されたリクエストは、このリージョンの Google サービスによって処理され、 Dialogflow CX によって保存データ は地理的地域または場所に物理的に格納されます。 最高のパフォーマンスを得るには、サービスとエンドユーザーに近いリージョンを選択する必要があります。
エージェントの作成後に、エージェントのロケーションを変更することはできません。エージェントのロケーションを変更するには、ロケーションが異なる新しいエージェントに対してエクスポートと復元を行う必要があります。
各ロケーションには、プロジェクト全体に適用される設定が関連付けられています。ほとんどの場合、これらの位置情報の設定は編集する必要がないため、デフォルト設定をそのまま使用できます。システムに顧客管理の暗号鍵が必要な場合(多くの場合、政府機関や規制対象の業界で必要です)、位置情報の設定で詳細をご覧ください。
制限事項
次の制限が適用されます。
異なるテレフォニー統合のリージョン・サポートは異なる場合があります。各統合のドキュメントを確認してください。
システム エンティティのサポートは、言語ごとに異なります。詳細については、 システム エンティティの制限事項 をご覧ください。
多くの REST リファレンス ドキュメントにある APIs Explorer は、API 呼び出しの
globalリージョンのみをサポートしています。
利用可能なリージョン
Dialogflow CX は、エージェントのロケーションに関して次のリージョンをサポートしています。データストア エージェントは、次の表に記載されている リージョンでもサポートされていますが、データストアで使用されるリージョン ID は、エージェント リージョン(リストされている)とは若干 異なります。 データストア リージョン ID 列に値が入力されているすべてのリージョンは、 Vertex AI Agents のデータストア エージェントでサポートされています。
| 国のグルーピング | 地理的位置 | エージェント 地域 ID | データストア リージョン ID |
|---|---|---|---|
| 南北アメリカ | アイオワ | us-central1 |
us(マルチリージョン) |
| 南北アメリカ | モントリオール | northamerica-northeast1 |
global(マルチリージョン) |
| 南北アメリカ | サウスカロライナ | us-east1 |
us(マルチリージョン) |
| 南北アメリカ | オレゴン | us-west1 |
us(マルチリージョン) |
| 南北アメリカ | 米国(マルチリージョン) | us * |
us(マルチリージョン) |
| ヨーロッパ | ベルギー | europe-west1 |
eu(マルチリージョン) |
| ヨーロッパ | ロンドン | europe-west2 |
eu(マルチリージョン) |
| ヨーロッパ | フランクフルト | europe-west3 |
eu(マルチリージョン) |
| ヨーロッパ | オランダ | europe-west4 |
eu(マルチリージョン) |
| ヨーロッパ | チューリッヒ | europe-west6 |
eu(マルチリージョン) |
| アジア太平洋 | シドニー | australia-southeast1 |
global(マルチリージョン) |
| アジア太平洋 | 東京 | asia-northeast1 |
global(マルチリージョン) |
| アジア太平洋 | ムンバイ | asia-south1 |
global(マルチリージョン) |
| アジア太平洋 | シンガポール | asia-southeast1 |
global(マルチリージョン) |
| アジア太平洋 | ジャカルタ | asia-southeast2 |
global(マルチリージョン) |
| グローバル | グローバル マルチリージョン(グローバルなサービス提供、保存データを米国に格納) | global(推奨)、またはリージョンなし(デフォルト) |
global(マルチリージョン)¶ |
| 記号 | 説明 |
|---|---|
| * | Vertex AI は「us」マルチリージョン ロケーションをサポートとしていません。その結果、「us」マルチリージョンで Dialogflow CX の生成 AI 機能を使用するには、それぞれの既存の米国の単一リージョン エンドポイントを使用します。 |
| ¶ | global リージョンへの呼び出しは、米国外から呼び出す際にレイテンシが大きくなる可能性があります。可能であれば、サービスとエンドユーザーにもっと近いリージョンを選択してください。 |
Google Cloud が使用しているリージョンの詳細については、 Google Cloud のリージョン と Google Cloud の地域とリージョンをご覧ください。
現在地の設定
システムに 顧客管理の暗号鍵が必要な場合(多くの場合、政府機関や規制の厳しい業種で必要)は、 位置情報の設定を使用してこの機能を構成できます。
位置情報の設定はプロジェクト間で共有され、ロケーションごとに独自の位置情報の設定があります。
プロジェクトに特定のロケーションの設定が構成されると、不変の
dialogflow.googleapis.com/LocationSettings
リソースが作成され、そのロケーションの設定は
変更できません。これらの設定を変更する場合や、リソースを削除する場合は、新しいプロジェクトを作成する必要があります。
組織のデベロッパーが特定のロケーションでのみエージェントを構成できるようにする必要がある場合は、リソース ロケーションの制約を含む組織のポリシーを設定できます。
位置情報の設定を編集せずにエージェントを作成すると、その位置情報に対してデフォルトの設定が構成され、プロジェクトに対してそれらの設定を変更することはできません。 また、エージェントを作成した後に、エージェントのロケーションを変更することはできません。エージェントのロケーションを変更するには、ロケーションが異なる新しいエージェントに対してエクスポートと復元を行う必要があります。
次のロケーションの設定を使用できます。
- 暗号化: この設定により、Google が管理する暗号鍵と顧客管理の暗号鍵のどちらを使用してデータを保護するかが決まります。デフォルトでは Google が管理する暗号鍵が使用されます。この設定を変更する場合は、Google の担当者を通じて顧客管理の暗号鍵機能へのアクセスをリクエストする必要があります。
次の 2 つの方法で位置情報の設定を構成できます。
- エージェント選択インターフェースで [Location settings] をクリックします。
- エージェントを作成するときに、[ロケーション] プルダウンの横にある [編集] ボタンをクリックします。
API でリージョンを指定する
すべての API リクエストに対してリージョンを指定する必要があります。
REST 呼び出しの場合は、次の両方を行う必要があります。
locationURL パスパラメータの地域 ID を指定します。globalリージョンの場合は、ホスト名にdialogflow.googleapis.comを使用します。他のリージョンではすべてホスト名に[region-id]-dialogflow.googleapis.comを使用します。
次に例を示します。
dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/global/agents/{AGENT_ID}us-central1-dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/us-central1/agents/{AGENT_ID}
クライアント ライブラリについては、リージョン構成オプションに関するクライアント ライブラリのドキュメントをご覧ください。
例については、API クイックスタートをご覧ください。
Cloud のロギング
ログを保存するリージョンを制御する場合は、Cloud ロギングガイドをご覧ください。