Dialogflow では、データ所在地を提供することで保存データを地理的リージョンまたはロケーションに物理的に保持します。リージョンを指定すると、保存データはリージョン外で複製されません。料金はすべてのリージョンで同一です。
リージョンは次の理由で使用されます。
- システムに、データの保管場所を制御する規制要件またはポリシー要件が含まれる場合があるため。
- お客様と同じリージョンにデータが存在する場合、ネットワークのレイテンシが改善されることがあるため。たとえば、英国のお客様が
europe-west2
を使用すると、レイテンシの改善が期待できます。
保存データ
すべての Dialogflow デベロッパー ユーザー データとエンドユーザー データは、保存データに含まれています。次に例を示します。
- コンソールまたは API で設定されたすべてのエージェント リソース(インテント、エンティティなど)
- コンソールまたは API で設定されたすべてのエージェント設定
- クエリ履歴
- 検証結果
- モデル作成タスク
- トレーニング タスク
- 長時間実行オペレーション タスク
利用可能なリージョン
Dialogflow では次のリージョンが利用できます。
国のグルーピング | 地理的場所 | リージョン ID |
---|---|---|
ヨーロッパ | ベルギー | europe-west1 |
ヨーロッパ | ロンドン | europe-west2 |
アジア太平洋 | シドニー | australia-southeast1 |
アジア太平洋 | 東京 | asia-northeast1 |
グローバル | Dialogflow の提供はグローバル、保存データは米国内に格納 | global (推奨)、またはリージョンなし(デフォルト)* |
記号 | 説明 |
---|---|
* | global リージョンへの呼び出しは、米国外から呼び出す際にレイテンシが大きくなる可能性があります。可能であれば、サービスとエンドユーザーにもっと近いリージョンを選択してください。 |
コンソールでリージョンを選択する
Dialogflow ES コンソール の左上部分には、リージョンの選択のプルダウンがあります。すべてのエージェントには、作成時に指定された変更できないリージョンが含まれます。コンソールからリージョンを選択すると、選択したリージョンのエージェントのみを一覧表示または作成できます。デフォルトのリージョンは global
です。
API を使用してリージョンを選択する
デフォルト以外のリージョンにエージェントが作成された場合は、設計時のリクエストかランタイム リクエストのために API を呼び出すときに、そのリージョンを指定する必要があります。
リージョンを指定するには、API リクエストに location
パラメータを指定します。REST 呼び出しの場合は、次の両方を行います。
location
URL パス パラメータを指定します。- リージョン固有のホスト名の形式
REGION_ID-dialogflow.googleapis.com
を使用します。例:asia-northeast1-dialogflow.googleapis.com
ホスト名で指定されたリージョンが URL パスで指定されたリージョンと一致しない場合、リクエストは拒否されます。
クライアント ライブラリについては、クライアント ライブラリのドキュメントをご覧ください。次の操作を行う必要があります。
Dialogflow サービス エンドポイントで次の設定をします。
REGION_ID-dialogflow.googleapis.com:443
セッション名を設定:
projects/PROJECT_ID/locations/REGION_ID/agent/sessions/SESSION_ID
次に例を示します。
REST
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: 実際の Google Cloud プロジェクト ID
- REGION_ID: リージョン ID(例:
europe-west2
) - SESSION_ID: セッション ID
HTTP メソッドと URL:
POST https://REGION_ID-dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/REGION_ID/agent/sessions/SESSION_ID:detectIntent
リクエストの本文(JSON):
{ "query_input": { "text": { "text": "I want a pony.", "language_code": "en-US" } } }
リクエストを送信するには、次のいずれかのオプションを展開します。
Java
Dialogflow への認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。
Python
Dialogflow への認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証を設定するをご覧ください。
その他の言語
C#: クライアント ライブラリ ページの C# の設定手順を行ってから、.NET 用の Dialogflow リファレンス ドキュメントをご覧ください。
PHP: クライアント ライブラリ ページの PHP の設定手順を行ってから、PHP 用の Dialogflow リファレンス ドキュメントをご覧ください。
Ruby: クライアント ライブラリ ページの Ruby の設定手順を実行してから、Ruby 用の Dialogflow リファレンス ドキュメントをご覧ください。
Cloud のロギング
ログを保存するリージョンを指定する場合は、Cloud ロギングガイドをご覧ください。
制限事項
Dialogflow コンソールでデフォルト以外のリージョンが選択されている場合、次の機能は使用できません。
多くの REST リファレンス ドキュメントにある APIs Explorer は、API 呼び出しの global
リージョンのみをサポートしています。