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