Agent Assist では、データ所在地を提供することで保存データを特定の地理的リージョンまたはロケーションに物理的に保持します。リージョンを指定すると、保存データはリージョン外には保存されません。料金はすべてのリージョンで同じです。
リージョンの指定は、次のようなユースケースで特に役立ちます。
- システムに、データの保管場所を制御する規制要件またはポリシー要件が含まれる場合があるため。
- お客様と同じリージョンにデータが存在する場合、ネットワークのレイテンシが改善されることがあります。たとえば、ベルギーのお客様が
europe-west1を使用すると、レイテンシの改善が期待できます。
利用可能なリージョン
| 国のグルーピング | 地理的位置 | リージョン ID | データストア リージョン ID |
|---|---|---|---|
| 南北アメリカ | アイオワ | us-central1 |
us（マルチリージョン） |
| 南北アメリカ | サウスカロライナ | us-east1 |
|
| 南北アメリカ | オレゴン | us-west1 |
|
| 南北アメリカ | モントリオール | northamerica-northeast1 |
|
| 南北アメリカ | 米国（マルチリージョン） | us * |
us（マルチリージョン）* |
| ヨーロッパ | ベルギー | europe-west1 |
eu（マルチリージョン） |
| ヨーロッパ | ロンドン | europe-west2 |
|
| ヨーロッパ | フランクフルト | europe-west3 |
|
| アジア太平洋 | シンガポール | asia-southeast1 |
|
| アジア太平洋 | 東京 | asia-northeast1 |
|
| アジア太平洋 | ムンバイ | asia-south1 |
|
| アジア太平洋 | シドニー | australia-southeast1 |
|
| グローバル | グローバル マルチリージョン（グローバルなサービス提供、米国に保存データ） | global（推奨）、またはリージョンなし（デフォルト） |
global（マルチリージョン）¶ |
| 記号 | 説明 |
|---|---|
| * | Vertex AI は「us」マルチリージョン ロケーションをサポートとしていません。その結果、「us」マルチリージョンで Agent Assist の生成 AI 機能を使用するには、それぞれの既存の米国の単一リージョン エンドポイントを使用します。 |
| ¶ | global リージョンへの呼び出しは、米国外から呼び出す際にレイテンシが大きくなる可能性があります。可能であれば、サービスとユーザーにもっと近いリージョンを選択してください。 |
地域別配信で利用可能な機能
| リージョン ID | カスタム セクションを使用した要約 v3.1/3.0 | カスタム セクションによる要約 v2.1 | カスタム セクションによる要約 v2.0/1.0 | 感情分析 | （プロアクティブ）生成ナレッジ アシスト |
|---|---|---|---|---|---|
us-central1 |
✓ | ✓ | ✓ | ✓ | ✓ |
us-east1 |
✓ | ✓ | ✓ | ✓ | ✓ |
us-west1 |
✓ | ✓ | ✓ | ✓ | ✓ |
us |
✓ | ✓ | ✓ | ✓ | |
northamerica-northeast1 |
✓ | ✓ | ✓ | ✓ | |
europe-west1 |
✓ | ✓ | ✓ | ✓ | |
europe-west2 |
✓ | ✓ | ✓ | ✓ | |
europe-west3 |
✓ | ✓ | ✓ | ✓ | |
asia-southeast1 |
✓ | ✓ | ✓ | ✓ | |
asia-northeast1 |
✓ | ✓ | ✓ | ✓ | |
asia-south1 |
✓ | ✓ | ✓ | ||
australia-southeast1 |
✓ | ✓ | ✓ | ✓ | |
global |
✓ | ✓ | ✓ | ✓ | ✓ |
保存データ
すべての Agent Assist デベロッパー ユーザー データとエンドユーザー データは、保存データに含まれています。次に例を示します。
- ナレッジベースとナレッジ ドキュメント。
- 会話プロファイル。
- 会話とメッセージの履歴。
- コンバージョンの参加者。
- Agent Assist から返された候補。
- フィードバック。
制限事項
次の制限が適用されます。
- エージェント アシスト コンソールでは、リージョン化はまだサポートされていません。地域別化を実装するには、API を直接呼び出す必要があります。
- モデル トレーニングはリージョン化をサポートしていません。このプロセス中に、データがリージョン外に転送される場合があります。
多くの REST リファレンス ドキュメントにある API Explorer は、API 呼び出しの
globalリージョンのみをサポートしています。CCAI 音声文字変換は現在、EU、米国、北米（カナダ）で、使用中のマルチリージョン データと保存データ（Speech Adaptation 機能を使用していない場合）のみをサポートしています。
データストアでサポートされているリージョンは、（プロアクティブ）生成ナレッジ アシスト機能で使用される
global、usマルチリージョン、euマルチリージョンのみです。
API を使用してリージョンを指定する
地域化を使用するには、すべての API リクエストにリージョンを指定する必要があります。
必須フィールド:
locationURL パスパラメータのリージョン ID を指定します。globalリージョンの場合は、ホスト名にdialogflow.googleapis.comを使用します。他のリージョンではすべてホスト名に[region-id]-dialogflow.googleapis.comを使用します。
次に例を示します。
dialogflow.googleapis.com/v2/projects/project_id/locations/global/knowledgeBases/knowledge_base_idus-central1-dialogflow.googleapis.com/v2/projects/project_id/locations/us-central1/knowledgeBases/knowledge_base_id
クライアント ライブラリを使用するには、次の手順が必要です。
- サービス エンドポイントを
REGION_ID-dialogflow.googleapis.comに設定します。 リソース名に正しいロケーションを設定します。次に例を示します。
projects/project_id/locations/region_id/knowledgeBases/knowledge_base_id
認証情報
クライアント ライブラリに認証情報を提供するには、GOOGLE_APPLICATION_CREDENTIALS 環境変数を使用することをおすすめします。この変数の設定の詳細については、Dialogflow の設定手順をご覧ください。
代わりにコードで手動で認証情報を指定する必要がある場合は、リージョン化されたエンドポイントを呼び出す前に、さらに 1 つの手順が必要です。認証情報を生成するときに、スコープを https://www.googleapis.com/auth/cloud-platform に設定する必要があります。次の例は、GoogleCredentials オブジェクトを作成するときに Java でこれを行う方法を示しています。
GoogleCredentials.fromStream(new FileInputStream("credential_file"))
.createScoped("https://www.googleapis.com/auth/cloud-platform")
Cloud Logging
ログを保存するリージョンを指定する場合は、Cloud Logging のドキュメントをご覧ください。