本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用代理式检索查询知识库

代理检索使用基础模型智能地将复杂的查询分解为子查询，以迭代方式从知识库中检索相关信息，并评估检索到的结果是否足以回答原始查询。这种方法提高了复杂的多步骤问题的检索准确性，而单次检索过程可能无法完全解决这些问题。

例如，给定查询 “哪本杂志最先创办，《亚瑟杂志》还是《女性第一本杂志》？”，代理检索将其分解为单独的子查询，例如 “《亚瑟杂志》是什么时候成立的？” 以及 “First for Women 是什么时候成立的？”，检索每个结果，并评估合并后的结果是否足够。

代理检索的工作原理

当您向 AgenticRetrieveStream API 发送请求时，会发生以下过程：

先决条件

在使用代理检索之前，必须具备以下条件：

使用代理检索查询知识库

要使用代理检索，AgenticRetrieveStream请发送请求。响应是一个包含检索结果和跟踪事件的流。

下表描述了密钥请求字段：

有关完整的请求和响应语法，请参阅 API 参考AgenticRetrieveStream中的。

代理检索响应

AgenticRetrieveStream响应是一个包含以下事件类型的流：

使用 AgentCore 内存进行代理检索

您可以授予代理检索亚马逊基岩 AgentCore 内存资源的权限。通过内存访问，检索可以继续较早的会话并利用代理在先前的会话中学到的内容。向该memoryConfiguration字段提供您的账户中处于该ACTIVE状态的内存资源的。memoryId

内存是可选的。仅设置 a memoryId 的 A 无效。memoryConfiguration当您提供内存资源时memoryConfiguration，必须通过以下两种方式中的至少一种使用内存资源：

提供完全按照内存策略配置的命名空间，占位符已经解析。例如，如果策略定义了命名空间/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 身份必须具有以下权限：

{
    "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 内存资源进行代理检索，请添加以下权限：

{
    "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"
}

注意事项

使用代理检索时请记住以下几点：