翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

エージェント型検索を使用してナレッジベースをクエリする

エージェント取り出しは、基盤モデルを使用して複雑なクエリをインテリジェントにサブクエリに分解し、ナレッジベースから関連情報を繰り返し取得し、取得した結果が元のクエリに回答するのに十分かどうかを評価します。このアプローチにより、1 回の取り出しパスで完全には対処できない複雑な複数ステップの質問に対する取り出し精度が向上します。

例えば、クエリ「最初に開始されたのはどのマガジン、アーサーズの"、または女性向けの最初の?」を考慮すると、エージェント検索はこれを「アーサーズの" がいつ設立された？」などの個別のサブクエリに分割します。と「First for women founded?」は、それぞれの結果を取得し、組み合わせた結果で十分かどうかを評価します。

エージェント取り出しの仕組み

AgenticRetrieveStream API にリクエストを送信すると、次のプロセスが発生します。

前提条件

エージェント取り出しを使用する前に、次のものが必要です。

エージェント取り出しを使用してナレッジベースをクエリする

エージェント取り出しを使用するには、 AgenticRetrieveStreamリクエストを送信します。レスポンスは、取得結果とトレースイベントを含むストリームです。

次の表に、キーリクエストフィールドを示します。

リクエストとレスポンスの完全な構文については、 API リファレンスAgenticRetrieveStreamの「」を参照してください。

エージェント取り出しレスポンス

AgenticRetrieveStream レスポンスは、次のイベントタイプを含むストリームです。

エージェント取り出しで AgentCore メモリを使用する

Amazon Bedrock AgentCore Memory リソースへのエージェント取り出しアクセスを許可できます。メモリアクセスを使用すると、取得は以前のセッションを続行し、エージェントが以前のセッションで学習したことを活用できます。ACTIVE 状態のアカウントのメモリリソースmemoryIdの を memoryConfigurationフィールドに入力します。

メモリはオプションです。のみmemoryConfigurationを設定する memoryIdは有効ではありません。を指定するときはmemoryConfiguration、次の 2 つの方法の少なくとも 1 つでメモリリソースを使用する必要があります。

プレースホルダーがすでに解決されている状態で、メモリ戦略で設定されているとおりに名前空間を指定します。たとえば、 戦略が名前空間 を定義する場合は/strategy/{memoryStrategyId}/actor/{actorId}、テンプレートではなく解決された値を指定します。名前空間、戦略、メモリレコードの詳細については、「Amazon Bedrock AgentCore デベロッパーガイド」の「メモリの用語」を参照してください。

sessionBinding が設定されている場合、 を使用して、現在の交換がセッションに書き戻されるかどうかpersistenceModeを制御します。

次の例では、以前のセッションを復元し、エージェントにそのアクターの長期メモリへのアクセスを許可し、交換をセッションに保持します。

{
    "messages": [
        {
            "content": {
                "text": "What did we decide about the migration timeline?"
            },
            "role": "user"
        }
    ],
    "retrievers": [
        {
            "configuration": {
                "knowledgeBase": {
                    "knowledgeBaseId": "KB12345678"
                }
            }
        }
    ],
    "agenticRetrieveConfiguration": {
        "foundationModelType": "MANAGED",
        "rerankingModelType": "MANAGED"
    },
    "memoryConfiguration": {
        "memoryId": "projectAssistantMemory-1a2b3c4d5e",
        "sessionBinding": {
            "actorId": "user-123",
            "sessionId": "session-456"
        },
        "retrievalConfigs": [
            {
                "namespace": "/strategy/summarization-1a2b3c4d5e/actor/user-123"
            }
        ],
        "persistenceMode": "DEFAULT"
    }
}

レスポンスストリームはメモリアクティビティを報告します。復元はセッション履歴ロードトレースイベントとして表示されます。長期メモリが返すレコードは、ソースタイプが BedrockAgentCoreMemoryのいずれかのステップで取得トレースイベントに表示されます。

取得自体がどのように表示されるかは、いつ表示されるかによって異なります。基盤モデルがメモリの検索を選択すると (通常は継続的なセッションで）、取得は Planning トレースイベントのmemoryRetrieveアクションとして表示されます。新しいセッションでは、エージェントは代わりに、最初の計画ステップの前に、投機的取得中に長期メモリを取得できます。この場合、エージェントはmemoryRetrieve何も実行しません。詳細については、「エージェント取り出しレスポンス」を参照してください。

エージェントの取得に必要なアクセス許可

AgenticRetrieveStream API を使用するには、呼び出し元の IAM ID に次のアクセス許可が必要です。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "bedrock:AgenticRetrieveStream",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "bedrock:Retrieve",
                "bedrock:GetDocumentContent"
            ],
            "Resource": "arn:aws:bedrock:region:account-id:knowledge-base/*"
        },
        {
            "Effect": "Allow",
            "Action": "bedrock:InvokeModelWithResponseStream",
            "Resource": "*"
        }
    ]
}

エージェント取り出しでガードレールを使用する場合は、次のアクセス許可を追加します。

{
    "Effect": "Allow",
    "Action": [
        "bedrock:GetGuardrail",
        "bedrock:ApplyGuardrail"
    ],
    "Resource": "*"
}

エージェント取り出しで AgentCore Memory リソースを使用する場合は、次のアクセス許可を追加します。

{
    "Effect": "Allow",
    "Action": [
        "bedrock-agentcore:GetMemory",
        "bedrock-agentcore:ListEvents",
        "bedrock-agentcore:RetrieveMemoryRecords",
        "bedrock-agentcore:CreateEvent"
    ],
    "Resource": "arn:aws:bedrock-agentcore:region:account-id:memory/memory-id"
}

bedrock-agentcore:ListEvents は を設定した場合にのみ必要ですsessionBinding。 bedrock-agentcore:RetrieveMemoryRecordsは を設定した場合にのみ必要ですretrievalConfigs。 bedrock-agentcore:CreateEventは persistenceModeが の場合にのみ必要ですDEFAULT。

メモリリソースがカスタマーマネージドキーで暗号化されている場合は、そのキーに次のアクセス許可を追加します。

{
    "Effect": "Allow",
    "Action": "kms:Decrypt",
    "Resource": "arn:aws:kms:region:account-id:key/key-id"
}

考慮事項

エージェント取り出しを使用するときは、次の点に注意してください。