翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # ナレッジベースを使用してエージェントのレスポンス生成を補足する Amazon Bedrock のナレッジベースは、検索拡張生成 (RAG) の活用に役立ちます。RAG は、データストアから情報を取得して、大規模言語モデル (LLM) によって生成されるレスポンスを補足する一般的な手法です。データソースとベクトルストアを使用してナレッジベースを設定すると、アプリケーションはナレッジベースにクエリを送信し、その回答として、ソースからの直接的な引用、またはクエリ結果から生成された自然なレスポンスのいずれかを返すことができます。 Amazon Bedrock ナレッジベースを Amazon Bedrock エージェントで使用するには、まずナレッジベースを作成し、次にナレッジベースをエージェントに関連付ける必要があります。ナレッジベースをまだ作成していない場合は、「[Amazon Bedrock ナレッジベースでデータを取得して AI レスポンスを生成する](knowledge-base.md)」を参照してナレッジベースについて確認し、作成してください。ナレッジベースは、[エージェントの作成](agents-create.md)中または作成後に関連付けることができます。ナレッジベースを既存のエージェントに関連付ける方法については、使用する方法に対応するタブを選択して、手順に従ってください。 ------ #### [ Console ] **ナレッジベースを追加するには** 1. Amazon Bedrock コンソールを使用するためのアクセス許可を持つ IAM ID を使用して、AWS マネジメントコンソールにサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。 1. 左側のナビゲーションペインで **[エージェント]** を選択します。次に、**[エージェント]** セクションでエージェントを選択します。 1. **[エージェントビルダーで編集]** を選択します。 1. **[ナレッジベース]** セクションで、**[追加]** を選択します。 1. 作成したナレッジベースを選択し、エージェントがナレッジベースと通信する方法を指示します。 1. **[Add]** (追加) を選択します。上部に成功を示すバナーが表示されます。 1. テストの前にエージェントに加えた変更を適用するために、**[準備]** を選択します。 ------ #### [ API ] ナレッジベースをエージェントに関連付けるには、[Amazon Bedrock エージェントのビルドタイムのエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して [AssociateAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_AssociateAgentKnowledgeBase.html) リクエストを送信します。 次のリストで、リクエストのフィールドについて説明します。 + 以下のフィールドが必要です。 **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/agents-kb-add.html) + 次のフィールドはオプションです。 **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/agents-kb-add.html) ------ エージェントを呼び出すときに [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) リクエストの `sessionState` フィールドを使用して、エージェントにアタッチされたナレッジベースの[照会の設定を変更](kb-test-config.md)できます。詳細については、「[エージェントセッションコンテキストのコントロール](agents-session-state.md)」を参照してください。 # エージェントとナレッジベースの関連付けに関する情報を表示する ナレッジベースの情報を表示する方法については、使用する方法に対応するタブを選択して、手順に従ってください。 ------ #### [ Console ] **エージェントに関連付けられたナレッジベースに関する情報を表示するには** 1. Amazon Bedrock コンソールを使用するためのアクセス許可を持つ IAM ID を使用して、AWS マネジメントコンソールにサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。 1. 左側のナビゲーションペインで **[エージェント]** を選択します。次に、**[エージェント]** セクションでエージェントを選択します。 1. **[エージェントビルダーで編集]** を選択します。 1. **[ナレッジベース]** セクションで、情報を表示するナレッジベースを選択します。 ------ #### [ API ] エージェントに関連付けられたナレッジベースに関する情報を取得するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して、[GetAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentKnowledgeBase.html) リクエストを送信します。以下のフィールドを指定します。 エージェントに関連付けられたナレッジベースに関する情報を一覧表示するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して、[ListAgentKnowledgeBases](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentKnowledgeBases.html) リクエストを送信します。関連付けられたナレッジベースを表示する `agentId` と `agentVersion` を指定します。 **** | フィールド | 簡単な説明 | | --- | --- | | maxResults | レスポンスとして返す結果の最大数。 | | nextToken | maxResults フィールドで指定した数よりも結果の件数が多い場合は、レスポンスで nextToken 値が返されます。結果の次のバッチを表示するには、別のリクエストで nextToken 値を送信します。 | [コード例を見る](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-agent_example_bedrock-agent_ListAgentKnowledgeBases_section.html) ------ # エージェントとナレッジベースの関連付けを変更する エージェントとナレッジベースの関連付けを変更する方法については、使用する方法に対応するタブを選択して、手順に従ってください。 ------ #### [ Console ] **エージェントとナレッジベースの関連付けを変更するには** 1. Amazon Bedrock コンソールを使用するためのアクセス許可を持つ IAM ID を使用して、AWS マネジメントコンソールにサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。 1. 左側のナビゲーションペインで **[エージェント]** を選択します。次に、**[エージェント]** セクションでエージェントを選択します。 1. **[エージェントビルダーで編集]** を選択します。 1. **[アクショングループ]** セクションで、編集するアクショングループを選択します。次に、[**編集**] を選択します。 1. 必要に応じて既存のフィールドを編集します。詳細については、「[ナレッジベースを使用してエージェントのレスポンス生成を補足する](agents-kb-add.md)」を参照してください。 1. エージェントでナレッジベースを使用できるようにするかどうかを制御するには、**[有効]** または **[無効]** を選択します。この機能は、エージェントの動作のトラブルシューティングに使用できます。 1. そのまま同じウィンドウで変更をテストする場合は、**[保存]** を選択します。**[作業中のドラフト]** ページに戻る場合は、**[保存して終了]** を選択します。 1. テストの前にエージェントに加えた変更を適用するために、**[テスト]** ウィンドウまたは **[作業中のドラフト]** ページの上部で **[準備]** を選択します。 ------ #### [ API ] エージェントに関連付けられたナレッジベースの設定を変更するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して [UpdateAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentKnowledgeBase.html) リクエストを送信します。すべてのフィールドが上書きされるため、更新するフィールドと、変更せずに維持するフィールドの両方を含めます。`agentVersion` は `DRAFT` に指定する必要があります。必須フィールドとオプションフィールドの詳細については、「[ナレッジベースを使用してエージェントのレスポンス生成を補足する](agents-kb-add.md)」を参照してください。 作業中のドラフトに変更を適用するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html) リクエストを送信します。リクエストに `agentId` を含めます。`TSTALIASID` エイリアスが指す `DRAFT` バージョンに変更が適用されます。 ------ # ナレッジベースとエージェントの関連付けを解除する ナレッジベースとエージェントの関連付けを解除する方法については、使用する方法に対応するタブを選択して、手順に従ってください。 ------ #### [ Console ] **エージェントからナレッジベースの関連付けを解除するには** 1. Amazon Bedrock コンソールを使用するためのアクセス許可を持つ IAM ID を使用して、AWS マネジメントコンソールにサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。 1. 左側のナビゲーションペインで **[エージェント]** を選択します。次に、**[エージェント]** セクションでエージェントを選択します。 1. **[エージェントビルダーで編集]** を選択します。 1. **[ナレッジベース]** セクションで、削除するナレッジベースの横にあるオプションボタンを選択します。その後、**[削除]** をクリックします。 1. 表示されるメッセージを確認し、**[削除]** を選択します。 1. テストの前にエージェントに加えた変更を適用するために、**[テスト]** ウィンドウまたは **[作業中のドラフト]** ページの上部で **[準備]** を選択します。 ------ #### [ API ] ナレッジベースとエージェントの関連付けを解除するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して、[DisassociateAgentKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DisassociateAgentKnowledgeBase.html) リクエストを送信します。`knowledgeBaseId` を指定し、関連付けを解除するエージェントの `agentId` と `agentVersion` を指定します。 作業中のドラフトに変更を適用するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PrepareAgent.html) リクエストを送信します。リクエストに `agentId` を含めます。`TSTALIASID` エイリアスが指す `DRAFT` バージョンに変更が適用されます。 ------