リージョン指定と位置情報の設定

エージェントを作成するときは、 エージェントのロケーションとして リージョン を指定する必要があります。 エージェントに送信されたリクエストは、このリージョンの Google サービスによって処理され、 Dialogflow CX によって保存データ は地理的地域または場所に物理的に格納されます。 最高のパフォーマンスを得るには、サービスとエンドユーザーに近いリージョンを選択する必要があります。

エージェントの作成後に、エージェントのロケーションを変更することはできません。エージェントのロケーションを変更するには、ロケーションが異なる新しいエージェントに対してエクスポートと復元を行う必要があります。

各ロケーションには、プロジェクト全体に適用される設定が関連付けられています。ほとんどの場合、これらの位置情報の設定は編集する必要がないため、デフォルト設定をそのまま使用できます。システムに顧客管理の暗号鍵が必要な場合(多くの場合、政府機関や規制対象の業界で必要です)、位置情報の設定で詳細をご覧ください。

制限事項

次の制限が適用されます。

利用可能なリージョン

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(マルチリージョン)¶

Google Cloud が使用しているリージョンの詳細については、 Google Cloud のリージョンGoogle Cloud の地域とリージョンをご覧ください。

現在地の設定

システムに 顧客管理の暗号鍵が必要な場合(多くの場合、政府機関や規制の厳しい業種で必要)は、 位置情報の設定を使用してこの機能を構成できます。

位置情報の設定はプロジェクト間で共有され、ロケーションごとに独自の位置情報の設定があります。

プロジェクトに特定のロケーションの設定が構成されると、不変の dialogflow.googleapis.com/LocationSettings リソースが作成され、そのロケーションの設定は 変更できません。これらの設定を変更する場合や、リソースを削除する場合は、新しいプロジェクトを作成する必要があります。

組織のデベロッパーが特定のロケーションでのみエージェントを構成できるようにする必要がある場合は、リソース ロケーションの制約を含む組織のポリシーを設定できます

位置情報の設定を編集せずにエージェントを作成すると、その位置情報に対してデフォルトの設定が構成され、プロジェクトに対してそれらの設定を変更することはできません。 また、エージェントを作成した後に、エージェントのロケーションを変更することはできません。エージェントのロケーションを変更するには、ロケーションが異なる新しいエージェントに対してエクスポートと復元を行う必要があります。

次のロケーションの設定を使用できます。

  • 暗号化: この設定により、Google が管理する暗号鍵と顧客管理の暗号鍵のどちらを使用してデータを保護するかが決まります。デフォルトでは Google が管理する暗号鍵が使用されます。この設定を変更する場合は、Google の担当者を通じて顧客管理の暗号鍵機能へのアクセスをリクエストする必要があります。

次の 2 つの方法で位置情報の設定を構成できます。

API でリージョンを指定する

すべての API リクエストに対してリージョンを指定する必要があります。

REST 呼び出しの場合は、次の両方を行う必要があります。

  • location URL パスパラメータの地域 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 ロギングガイドをご覧ください。