データストアハンドラ

データストアハンドラは、特別なタイプの状態ハンドラで、ウェブサイトのコンテンツとアップロードされたデータに基づいて LLM 生成のエージェントレスポンスを提供できます。

このハンドラを作成するには、エージェントの作成時にデータストアを指定します。

これらのデータストアハンドラを使用すると、エージェントはエンドユーザーとコンテンツについて会話できます。

制限事項

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

現在、この機能は一般提供では一部の言語にのみ対応しています。言語リファレンスのデータストア列をご覧ください。
global、us マルチリージョン、eu マルチリージョンのリージョンのみがサポートされています。
サポートされている構造化データストアのタイプは、よくある質問のみです。
チャンクされたデータストアとチャンクされていないデータストアの両方を使用するアプリはサポートされていません。

アクセス制御

プロジェクトオーナーの場合は、データストアハンドラの作成に必要なすべての権限が付与されています。プロジェクトオーナーでない場合は、次のロールが必要です。

Dialogflow Admin
ディスカバリーエンジン管理者

詳細については、アクセス制御ガイドをご覧ください。

エージェントを作成する

データストアハンドラを使用するエージェントを作成するには:

まだ行っていない場合は、設定手順に沿って操作してください。
Agent Builder コンソールに移動します。

Agent Builder コンソール
コンソールのプルダウンからプロジェクトを選択します。
API をまだ有効にしていない場合は、利用規約を読んで同意し、[続行して API を有効にする] をクリックします。
[新しいアプリを作成] または [新しいアプリ] をクリックします。
[Chat] を選択します。
[エージェントの設定] セクションに会社名を入力します。
[タイムゾーンと言語の設定] セクションを開きます。
タイムゾーンを選択します。
デフォルトの言語を選択
[エージェント名] セクションにエージェント名を入力します。
[エージェントのロケーション] セクションで、リージョンまたはマルチリージョンを選択します。
[続行] をクリックします。
次のいずれかの方法で、データストアをエージェントに接続します。
- 前に作成した既存のデータストアを選択します。
- 新しいデータストアの作成
  1. [新しいデータストアの作成] をクリックします。
  2. データソースの選択
  3. 選択したデータストアソースのデータと構成を指定します。データストアのロケーションは、エージェントのロケーションに対応している必要があります。
  4. [作成] をクリックしてデータストアを作成します。
  5. 新しいデータストアを選択します。
[作成] をクリックします。
エージェントが作成され、[使用可能なデータストア] ページに自動的にリダイレクトされます。このページでは、必要に応じてデータストアを追加できます。
ウェブサイト用に新しいデータストアを作成した場合は、ドメイン所有権の証明をする必要があります。
Dialogflow CX コンソールでエージェントを開くには、左パネルで [プレビュー] をクリックします。コンソールでは、データストアハンドラの編集または追加、エージェントのデプロイ、および必要に応じて、データストアでカバーされていないシナリオを処理するフローを追加できます。

エージェントをテスト

シミュレータを使用して、エージェントをテストします。

エージェントのデプロイ

エージェントをデプロイする方法はいくつかあります。

最も簡単なオプションは、エージェントのユーザーインターフェースを提供する統合を使用することです。各統合には、デプロイ手順が記載されています。
Dialogflow CX Messenger 統合は、データストアハンドラにとって特に優れたオプションです。生成機能のオプションが組み込まれています。
独自のユーザーインターフェースを作成し、操作に会話エージェント（Dialogflow CX）API を使用できます。ユーザーインターフェースの実装でデプロイを管理します。

特別なインテント

エージェントは、提供するコンテンツに関する質問に対応するだけでなく、次のような質問にも答えることができます。

エージェントの識別:「あなたは誰ですか？」、「あなたは人間ですか？」などの質問に対応します。
人間のエージェントにエスカレーションする:「人間と話したい」、「本当の人と話したい」などの質問に対応します。

これは、自動的に生成されるインテントおよびインテントルートによって行われます。

既存のエージェントのデータストアハンドラを追加または編集する

データストアハンドラは、特別なタイプの状態ハンドラです。これは、フローやページに適用でき、同じスコープルールを使用して評価されることを意味します。

データストアハンドラを追加または編集するには:

Dialogflow CX コンソールに移動する。
プロジェクトを選択します。
エージェントを選択します。
データストアハンドラに関連付けられたフローを選択します。通常これは、デフォルトの開始フローです。
データストアハンドラに関連付けられているページを選択します。通常これは、スタートページです。
ページデータの [状態ハンドラを追加] をクリックして、[データストア] を選択します。
データストアを作成する必要がある場合は、Vertex AI Agent Builder ユーザーインターフェースに移動します。詳しくは、選択に役立つデータストア情報をご覧ください。
すでにデータストアがある場合は、[データストアを編集] をクリックします。
必要に応じて更新を行い、完了したら保存します。データストアに固有の設定については、以下をご覧ください。

エージェントレスポンス

[エージェントレスポンス] セクションで、生成する回答を参照するカスタムレスポンスを指定できます。 [エージェントセイ] セクションで $request.knowledge.questions[0] を使用して、生成する回答を提供します。

データストアのレスポンスオプション

[リンクの最大数] フィールドを更新して、生成する回答によって提供される補足リンクの最大数を指定できます。

データストア

データストアの設定