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