一部のサービスと機能は名前を変更中です。生成ハンドブックとフロー機能も、単一の統合コンソールに移行されます。詳しくは、こちらをご覧ください。

このページは Cloud Translation API によって翻訳されました。

データストアのパフォーマンスの向上

このガイドでは、データストアハンドラのパフォーマンスをモニタリングして改善するための推奨事項について説明します。

エージェントのパフォーマンスをトラッキングする

エージェントの会話履歴をモニタリングしたり、エージェントの統計情報に分析ツールを使用したりできます。

セルフサービス評価を実行する

セルフサービス評価を実行すると、データストアエージェントの品質が評価され、変更が推奨されます。

エージェントのレスポンスを改善する

テスト中に期待どおりでないレスポンスが見つかった場合は、次の手順をお試しください。

特定の質問のよくある質問のエントリを追加することで、回答を上書きできます。
構造化されたよくある質問で質の低い回答がある場合は、非構造化されたよくある質問をお試しください。
検索構成を使用すると、正しい回答を確実に提供するのに役立ちます。
レスポンスを最適化するには、構成の解析とチャンクを使用します。
特定のフレーズを禁止するには、エージェントの設定: 禁止フレーズをご覧ください。
責任ある AI（RAI）のコンテンツフィルタリングをカスタマイズするには、エージェントの設定: 安全フィルタをご覧ください。

Playbook で使用されるデータストアツールの最適化

この設定により、データストアの RAG レスポンスが高速化され、ユーザーのクエリを書き換えたり、ツールパラメータを動的に入力したりしないため、レイテンシが改善されます。つまり、ユーザーのクエリはそのままデータストアに渡され、フィルタやユーザーメタデータ関連のパラメータは入力されません。

この機能を有効にするには、Dialogflow CX コンソールで Playbook を選択し、[Settings] タブをクリックします。フォローアップアクションの処理をすぐに続行するか、次のエンドユーザー入力を待機するかを、ハンドブックで構成できます。

有効になっている場合、次の Playbook の手順は引き続き適用されます。

データストアを使用してユーザーのクエリに回答するタイミング。
データストアを使用してユーザーのクエリに回答せず、代わりに別のレスポンスを提供する必要がある場合。
「競合他社に関する質問には答えない」など、防御的な指示。

有効にすると、次の Playbook 指示は無視されます。次のいずれかのクエリ要件がある場合は、この設定を有効にしないでください。

手順に沿って入力する特定のデータストアフィルタ。
フィルタによって渡されたユーザーパーソナライズメタデータを適用する手順。
データストアにクエリを実行する前にユーザーのクエリを書き換えるその他の指示。

会話の余談を処理する

エンドユーザーが会話中に明らかにするための質問をする場合があります。たとえば、クレジットカード情報の収集中に、CVV が何かを明確にする必要があります。この場合、エージェントは質問に回答し、必要なクレジットカード情報の収集に戻る必要があります。これを行うには、質問に答えるデータストアを使用してデータストアハンドラを作成し、そのハンドラをクレジットカード情報の収集を処理するフローのフロースタートページに適用して、このハンドラが「現在のページ」に戻るためのトランジションターゲットを設定します。

望ましくないインテントマッチを処理する

エージェントがデータストアハンドラを使うべきなのにインテントと一致している場合、これを修正するために以下を試すことができます。

あいまいなトレーニングフレーズを削除または変更します。これにより、すべてのトレーニングフレーズが目的の意図を正確に処理し、データストアのコンテンツと競合しなくなります。
ネガティブサンプルを使用してインテント不一致を回避します。

データストアのフィルタリング

場合によっては、セッションパラメータ値に応じて、クエリに特定のデータストアのみを使用することがあります。たとえば、商品カテゴリごとに一意のデータストアを作成する場合があります。商品カテゴリのデータストアをフィルタするには:

セッションパラメータを商品カテゴリに設定します。
セッションパラメータの値を確認し、目的のデータストアハンドラを含む特定のページに遷移する条件ルートを作成します。
データストアハンドラが呼び出しページに戻り、会話を続行できます。

パーソナライズ

生成回答をエンドユーザーにより関連性のあるものにするために、会話エージェント（Dialogflow CX）にユーザーに関する情報を提供できます。

この情報は JSON として提供されます。想定されるスキーマはないため、オブジェクトプロパティを自由に定義できます。この JSON は大規模な言語モデルにそのまま送信されるため、記述的なプロパティ名と値により最適な結果につながります。

次に例を示します。

{
  "subscription plan": "Business Premium Plus",
  "devices owned": [
    {"model": "Google Pixel 7"},
    {"model": "Google Pixel Tablet"}
  ]
}

API によるパーソナライズ

インテント検出リクエストを送信するときに、そのデータを会話エージェント（Dialogflow CX）に渡すことができます。この情報はセッションで維持されないため、すべてのインテント検出リクエストで提供する必要があります。

この情報は、Sessions.detectIntent メソッドの queryParams.endUserMetadata フィールドに入力します。

セッションリファレンスのプロトコルとバージョンを選択:

プロトコル	V3	V3beta1
REST	セッションリソース	セッションリソース
RPC	セッションインターフェース	セッションインターフェース
C++	SessionsClient	利用できません
C#	SessionsClient	利用できません
Go	SessionsClient	利用できません
Java	SessionsClient	SessionsClient
Node.js	SessionsClient	SessionsClient
PHP	利用不可	利用できません
Python	SessionsClient	SessionsClient
Ruby	利用不可	利用できません

Dialogflow CX Messenger によるパーソナライズ

このデータを Dialogflow CX Messenger の統合に提供できます。setContext メソッドをご覧ください。

検索構成

エージェントの動作をより適切に制御し、回答の質を向上させるために、検索構成（ブーストとフィルタ）を公開することで、ドキュメントのブースト、埋め込み、フィルタを行うことができます。

ブーストコントロールを使用すると、特定のドキュメントにブースト値（ランキングが高い場合は 0 より大きい値、ランキングが低い場合は 0 未満の値）を適用することで、検索結果のランキングを変更できます。

フィルタコントロールを使用すると、指定したフィルタ条件に基づいて検索結果を保持または削除できます。

この情報は、会話エージェント（Dialogflow CX）リクエストに JSON として提供されます。JSON の形式は、検索コントロールのタイプによって異なります。

ブーストコントロール

次の検索構成は、ブーストコントロールを示しています。

"searchConfig": {
  "boostSpecs": [
    {
      "dataStores": [ "DATASTORE_ID" ],
      "spec": [
        {
          "conditionBoostSpecs": {
            "condition": "CONDITION",
            "boost": "1.0"
          }
        }
      ]
    }
  ]
}

フィルタコントロール

次の検索構成は、フィルタコントロールを示しています。

"searchConfig": {
  "filterSpecs": [
    {
      "dataStores": [ "DATASTORE_ID" ],
      "filter": "CONDITION"
    }
  ]
}

API を使用して検索構成を設定する

この情報は、Sessions.detectIntent メソッドの queryParams.searchConfig フィールドに入力します。