翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ナレッジベースをクエリして結果を返すか、レスポンスを生成する
ナレッジベースにクエリを実行する方法については、選択した方法に対応するタブを選択し、ステップに従います。
- Console
-
ナレッジベースをテストするには
-
Amazon Bedrock のアクセス許可を持つ ロール AWS Management Console を使用して にサインインし、 で Amazon Bedrock コンソールを開きますhttps://console.aws.amazon.com/bedrock/
。 IAM -
左側のナビゲーションペインから、ナレッジベース を選択します。
-
ナレッジベースセクションで、次のいずれかのアクションを実行します。
-
テストするナレッジベースの横にあるラジオボタンを選択して、[ナレッジベースをテストする] を選択します。テストウィンドウが右から展開されます。
-
テストするナレッジベースを選択します。テストウィンドウが右から展開されます。
-
-
ユースケースに応じて、クエリのレスポンスの生成を選択またはクリアします。
-
ナレッジベースから直接取得した情報を返すには、「レスポンスの生成」をオフにします。Amazon Bedrock は、クエリに関連するデータソースからテキストチャンクを返します。
-
ナレッジベースから取得した情報に基づいてレスポンスを生成するには、「レスポンスの生成」をオンにします。Amazon Bedrock は、データソースに基づいてレスポンスを生成し、提供された情報を脚注で引用します。
-
-
「レスポンスの生成」を有効にする場合は、「モデルの選択」を選択して、レスポンスの生成に使用するモデルを選択します。次に、適用 を選択します。
-
（オプション) 設定アイコン (
) を選択して、設定 を開きます。次の設定を変更できます。-
検索タイプ — ナレッジベースのクエリ方法を指定します。詳細については、「検索タイプ」を参照してください。
-
取得された結果の最大数 – 取得する結果の最大数を指定します。詳細については、「取得された結果の最大数」を参照してください。
-
フィルター – ファイルのメタデータで使用するフィルターグループを最大 5 つ、各グループ内で最大 5 つ指定します。詳細については、「メタデータとフィルタリング」を参照してください。
-
ナレッジベースのプロンプトテンプレート – レスポンスの生成 をオンにすると、デフォルトのプロンプトテンプレートを独自のプロンプトテンプレートに置き換えて、レスポンス生成のためにモデルに送信されるプロンプトをカスタマイズできます。詳細については、「ナレッジベースのプロンプトテンプレート」を参照してください。
-
ガードレール – レスポンスの生成 をオンにすると、ナレッジベースのプロンプトとレスポンスでガードレールがどのように機能するかをテストできます。詳細については、「ガードレール」を参照してください。
-
-
チャットウィンドウのテキストボックスにクエリを入力して [実行] を選択すると、ナレッジベースからのレスポンスが表示されます。
レスポンスは、次の方法で調べることができます。
-
レスポンスを生成しなかった場合、テキストチャンクは関連性の順に直接返されます。
-
レスポンスを生成した場合は、脚注を選択して、レスポンスのその部分の引用されたソースからの抜粋を表示します。リンクを選択して、 ファイルを含む S3 オブジェクトに移動します。
-
各脚注で引用されているチャンクの詳細を表示するには、ソースの詳細を表示 を選択します。ソースの詳細ペインでは、次のアクションを実行できます。
-
クエリ用に設定した設定を確認するには、クエリ設定 を展開します。
-
ソースチャンクの詳細を表示するには、その横の右矢印 (
) を選択して展開します。次の情報が表示されます。-
ソースチャンクからの raw テキスト。このテキストをコピーするには、コピーアイコン () を選択します
。Amazon S3 を使用してデータを保存する場合は、 ファイルを含む S3 オブジェクトに移動し、外部リンクアイコン () を選択します 
。 -
ソースチャンクに関連付けられたメタデータ。Amazon S3 を使用してデータを保存する場合、属性/フィールドのキーと値は、ソースドキュメントに関連付けられている
.metadata.jsonファイルで定義されます。詳細については、「メタデータ を含む Amazon S3 接続設定」を参照してください。
-
-
-
チャットオプション
-
レスポンスを生成する場合は、モデルの変更を選択して、レスポンス生成に別のモデルを使用できます。モデルを変更すると、チャットウィンドウ内のテキストは完全に消去されます。
-
クエリのレスポンスの生成と、レスポンスの生成 を選択またはクリアして直接引用符を返すかを切り替える。設定を変更すると、チャットウィンドウ内のテキストは完全に消去されます。
-
チャットウィンドウをクリアするには、ほうきアイコン () を選択します
。 -
チャットウィンドウのすべての出力をコピーするには、コピーアイコン () を選択します
。
-
- API
-
取得
ナレッジベースをクエリし、データソースから関連するテキストのみを返すには、Agents for Amazon Bedrock ランタイムエンドポイント を使用してRetrieveリクエストを送信します (リクエストとレスポンスの形式とフィールドの詳細についてはリンクを参照）。
次の表では、パラメータとリクエスト本文を簡単に説明しています (詳細情報とリクエスト構造については、「Retrieve request syntax 」を参照してください。
変数 必須? ユースケース knowledgeBaseId あり クエリするナレッジベースを指定するには retrievalQuery あり クエリを指定する textフィールドが含まれます。nextToken なし レスポンスの次のバッチを返すには retrievalConfiguration なし ベクトル検索をカスタマイズするためのクエリ設定を含めるには。 次の表は、レスポンス本文を簡単に説明しています (詳細情報とレスポンス構造については、「レスポンスの取得構文」を参照してください。
変数 ユースケース retrievalResults ソースチャンク、ソースの Amazon S3 の場所、チャンク scoreの関連性が含まれます。nextToken 別のリクエストで を使用して、結果の次のバッチを返すには。 RetrieveAndGenerate
ナレッジベースをクエリし、基盤モデルを使用してデータソースの結果に基づいてレスポンスを生成するには、Agents for Amazon Bedrock ランタイムエンドポイント を使用してRetrieveAndGenerateリクエストを送信します。
次の表では、パラメータとリクエストボディを簡単に説明しています (詳細情報とリクエスト構造については、RetrieveAndGenerate リクエスト構文 を参照してください）。
変数 必須? ユースケース input あり クエリを指定する textフィールドが含まれます。retrieveAndGenerate設定 あり クエリするナレッジベース、レスポンス生成に使用するモデル、およびオプションのクエリ設定を指定する場合。 sessionId なし 同じ値を使用して同じセッションを続行し、情報を維持する sessionConfiguration なし セッションの暗号化用のKMSキーを含めるには 次の表は、レスポンス本文を簡単に説明しています (詳細情報とレスポンス構造については、「レスポンスの取得構文」を参照してください）。
変数 ユースケース 引用 内の各オブジェクトで生成されたレスポンスの一部 generatedResponsePart、contentオブジェクト内のソースチャンク、オブジェクト内のソースの Amazon S3 の場所が含まれますlocationretrievedReferences。guardrailAction レスポンスで使用されるガードレールがあるかどうかを指定します。 output 生成されたレスポンス全体が含まれます。 sessionId セッションの ID が含まれており、別のリクエストで再利用して同じ会話を維持できます。
注記
レスポンスの生成中にプロンプトが文字数制限を超えたというエラーが表示された場合は、次の方法でプロンプトを短縮できます。
-
取得された結果の最大数を減らします (これにより、 の $search_results$ プレースホルダーに入力される内容が短縮されますナレッジベースのプロンプトテンプレート）。
-
より小さなチャンクを使用するチャンク戦略でデータソースを再作成します (これにより、 の $search_results$ プレースホルダーに入力される内容が短縮されますナレッジベースのプロンプトテンプレート）。
-
プロンプトテンプレートを短くします。
-
ユーザークエリを短縮します (これにより、 の $query$ プレースホルダーに入力される内容が短縮されますナレッジベースのプロンプトテンプレート）。
