生活分享

Amazon Bedrock 知识库 Agentic Retrieve 新增 AgentCore 记忆:单次调用还原对话、按用户 ACL 过滤文档

AWS 介绍,在 AgenticRetrieveStream 中加入 memoryConfiguration,即可让 Bedrock Managed Knowledge Base 结合 AgentCore memory,并通过 userContext 应用文档 ACL。该集成为选择性启用,记忆资源须与知识库位于同一账户。

新闻日期: 阅读时间约 7 分钟

LINE 分享
目录
  1. 1. 这次改了什么?相比过去需要自己做哪些事
  2. 2. 支持范围与前置条件是什么?
  3. 3. 多用户共用时,身份与隔离如何设计?
  4. 4. 实际表现与成本、延迟要注意什么?

AWS 在机器学习博客发布教程,介绍如何让 Amazon Bedrock Managed Knowledge Base(AWS 托管的企业文档知识库)的 Agentic Retrieve 功能结合 AgentCore memory。Agentic Retrieve 会自动规划多个子查询来回答问题;AgentCore memory 则是可保存用户对话与个人事实的记忆服务。根据 AWS,这项集成为选择性启用、向后兼容。文中未标注预览或测试阶段,也没有提供示例区域以外的可用性信息。对开发知识问答应用的团队来说,原本要自行维护的对话数据表、历史重放和事实提取流程,可以改由服务处理。

这次改了什么?相比过去需要自己做哪些事

AWS 指出,用户期望知识型应用能记住自己。后续提问会依赖上一轮的上下文,答案也应反映数周前提过的地点、角色或方案,同时仍只能根据用户有权阅读的文档作答,并附上引用。AWS 称,Managed Knowledge Base 与 AgentCore memory 现在接手三件事:存储对话、从对话中提取事实,以及把相关事实带入搜索。

做法是在 AgenticRetrieveStream 请求中加入 memoryConfiguration。AWS 表示,在同一次调用中,服务会还原对话;规划器(决定要查什么的组件)会自行判断何时需要用户事实,从长期记忆中取回后,用来组成发往知识库的子查询;生成答案后,服务再把这一轮问答存回记忆。AWS 说明,采用后应用程序不再需要对话数据表、历史重放和提取管线,但仍须负责验证用户并传递用户身份。

AWS 文章中的主要配置与行为
项目AWS 说明的做法
对话历史sessionBinding 让服务还原并写入;messages 只带当前问题
文档权限userContext.userId 传入经验证的 email,由知识库按 ACL 过滤
记忆标识actorId 使用 Cognito sub,命名空间以 actorId 为根
写入模式persistenceMode 默认 DEFAULT(需 generateResponse 为 true);NONE 只还原不写入
记忆失败时请求不会失败,追踪中出现 FAILED 事件,答案仅由知识库生成

支持范围与前置条件是什么?

AWS 表示,与此集成搭配的记忆资源必须与知识库位于同一个 AWS 账户,且处于 ACTIVE 状态。文中示例使用美国西部(俄勒冈)us-west-2 区域,需要 Python 3.10 以上与 Boto3 1.43.72 以上。此外还需要创建以下资源的权限:S3 存储桶、Cognito 用户池、IAM 角色、知识库和记忆资源。文章未说明其他区域的可用性。

ACL(访问控制列表)是列出谁可以读取哪些文档的名单。AWS 还指出,aclEnabled 在数据源创建后无法更改。没有任何 ACL 条目覆盖的文档不会被导入知识库;email 不匹配任何条目的用户,也不会从该数据源得到结果。一个请求最多可带五个知识库。

多用户共用时,身份与隔离如何设计?

在 AWS 的示例中,员工通过 Amazon Cognito(AWS 的登录服务)登录。登录后获得的 ID token 中,sub(固定的用户编号)用作记忆的 actorId(记忆所有者标识)和命名空间(存放该用户记忆记录的路径),经验证的 email 则用作 userContext.userId。这些值都由应用程序从已验证的 token 中获取,不来自请求正文。AWS 解释,email 可能被更改,或在员工离职后重新分配给他人,新用户就会因此继承旧记忆;所以 actorId 应使用永不变动、也不会被复用的 ID。

记忆策略方面,AWS 表示摘要策略会捕捉用户顺带提到的事实,用户偏好策略则提取用户明确表达的偏好,建议两者并用。retrievalConfigs 只接受一个条目,因此单个 namespacePath 必须覆盖该用户的所有记录;示例把 {actorId} 直接放在根目录下。

作为纵深防御(多一层保护),AWS 建议为每位用户创建带 userId 标签的 IAM 角色会话,并搭配 bedrock-agentcore:actorId 与 namespacePath 条件键。在其演示中,若请求绑定了他人的 actorId,记忆操作会返回 AccessDeniedException,回答仍由知识库生成。

实际表现与成本、延迟要注意什么?

在 AWS 的示例运行中,工程师 Maya 询问待命津贴并得到答案;销售 Sofia 问同样的问题,因为无权读取工程文档,答案表示在她可访问的来源中没有待命津贴的记载。这项过滤由知识库完成。另一个例子中,Maya 先在 VPN 对话中提到自己在法兰克福办公室,之后在新对话中询问 PTO(带薪休假)。长期记忆命中一条记录,答案反映了法兰克福的规定。Liam 问同样的问题时检索到 0 条记忆记录,得到列出三个办公室的通用表格,并被请求说明自己在哪个办公室。

AWS 称长期记忆提取是异步进行的。在其运行中,首条记录在第 2 回合后 81 秒出现,但这个时间并非承诺,设计时应假设记录要过一段时间才可用。延迟方面,会话还原约增加 200 毫秒;含一个知识库、ACL 与记忆的完整回合耗时 4–10 秒,主要由规划迭代决定。这些都是观察值,不是服务承诺。计费方面,agentic retrieval 按每次调用加上底层检索计费,记忆操作则计入 AgentCore memory 用量。

常见问题

必须改用这项功能吗?

不必。AWS 称该集成为选择性启用且向后兼容。若需要精确控制每次请求带入的历史(例如自行编辑历史),AWS 建议继续传送 messages;但 messages 不能与 sessionBinding 在同一请求中同时使用。

记忆服务故障时,回答会失败吗?

不会。根据 AWS,记忆操作采用尽力而为方式。记忆调用失败或被拒绝时,请求不会失败,追踪中会出现 FAILED 事件,答案仅由知识库生成。

sessionId 该怎么管理?

新对话的 sessionId 由应用程序生成并返回给客户端,客户端在后续回合送回以延续对话。AWS 说明这样做是安全的,因为短期记忆以 actorId 区分,而 actorId 取自 token。AWS 建议整个对话期间使用稳定的 sessionId;每次请求都换新 ID 虽然会被接受,但会破坏连续性,并且每回合产生一条摘要记录。

哪些对话事件会被还原?

AWS 说明只有 USER 与 ASSISTANT 的对话事件会被还原;其他系统写入的 TOOL 或 OTHER 角色事件会被跳过。

查看同分类最新消息

觉得这篇整理实用吗?分享给需要的朋友

LINE 分享

资料来源

本文依据上方所列参考来源与标示之核实日期整理;票价、时刻、功能规格或服务条款可能变动,出发、预订或购买前请至相关官方网站确认最新信息。

生活分享