记忆空间概述

单个 Agent 固定使用一个记忆空间

当一个 Agent 的职责相对固定，且相关信息可以在同一个记忆范围内持续积累时，可以为该 Agent 挂载一个专属记忆空间。例如，专属客户经理 Agent、个人助理 Agent 或长期项目跟进 Agent，可以在回答前查询同一个记忆空间，并将后续仍需使用的对话内容持续写入该空间。这种模式表示 Agent 在业务上固定使用一个记忆空间，但挂载并不表示 Agent 的全部对话会自动同步，仍需通过 Agent 的提示词或应用代码，明确什么时候读取记忆、什么内容需要写入，以及哪些信息不应保存。

多个 Agent 按业务场景使用多个记忆空间

当业务包含多个相对独立的领域，且不同领域的信息需要分别管理时，可以按照场景设置多个 Agent 和多个记忆空间。例如，客服业务可以分别设置售前 Agent、订单服务 Agent 和售后 Agent，并为其挂载“售前服务”“售中/订单服务”和“售后服务”记忆空间：售前 Agent 在“售前服务”记忆空间中保存客户需求和产品偏好，订单服务 Agent 在“售中/订单服务”记忆空间中保存订单确认和交付进度，售后 Agent 在“售后服务”记忆空间中保存退换货和故障处理信息。

每个 Agent 可以只使用与自身职责相关的记忆空间，也可以根据业务流程挂载多个记忆空间，多个 Agent 与多个记忆空间之间不要求固定的一一对应关系。通过按场景划分 Agent 和记忆空间，可以让不同业务领域拥有相对独立的对话历史和长期记忆，避免将所有信息混入同一个记忆范围。

统一入口 Agent 按场景路由多个记忆空间

当业务设置了统一入口或路由 Agent，并允许其使用多个记忆空间时，需要在提示词中定义场景与记忆空间的映射关系。例如，售前咨询对应“售前服务”记忆空间，订单确认或交付进度对应“售中/订单服务”记忆空间，退换货或故障反馈对应“售后服务”记忆空间。一个请求同时涉及多个场景时，按内容归属分别处理，不将全部内容重复写入所有记忆空间；无法判断场景时，先向用户确认。映射规则的写法见按场景使用多个记忆空间的提示词示例。

使用前提

• 已创建需要接入记忆能力的目标 Agent，挂载在目标 Agent 的 Agent 资产配置页面完成。

• 已确定采用 MCP 还是 SDK 接入。两种方式可根据应用形态任选其一，无需同时接入。

• 采用 MCP 时：开启 MCP 与挂载到 Agent 是两个独立步骤，开启 MCP 使记忆能力可供选择，挂载决定当前 Agent 是否可以调用该能力；挂载只表示 Agent 的运行环境可以访问相应工具，高代码 Agent 还需要通过应用代码将 MCP 工具接入所使用的 Agent 框架或模型调用流程，并处理工具调用和结果回传。

• 采用 SDK 时：具体接入和调用方式以对应的 SDK 使用指南为准。

规划记忆边界

先根据业务用途判断哪些信息需要长期保留，以及不同业务领域是否需要分别管理。一个 Agent 可以挂载一个或多个记忆空间；如果不同场景的内容、使用目的或管理要求不同，建议分别创建记忆空间。

创建记忆空间

在 AgentCore 中创建或选择记忆空间，并根据页面提示完成配置。如果需要区分多个业务场景，可以按规划分别创建对应的记忆空间。

选择接入方式

记忆空间支持通过 MCP 或 SDK 使用，两种方式可根据应用形态任选其一，无需同时接入。选择依据在于记忆的读取和写入由谁编排：MCP 以标准工具方式提供记忆能力，由模型调用工具触发读写，需要通过提示词引导；SDK 由应用代码直接编排读写。

高代码应用不必然只能使用 SDK：挂载记忆空间 MCP 后，同样可以通过应用代码接入 MCP 工具，再由提示词引导模型调用。

通过 MCP 挂载

通过 MCP 接入分为开启 MCP 和挂载到 Agent 两个独立步骤。

开启 MCP

1. 在目标记忆空间中开启 MCP。

2. 确认该 MCP 已进入记忆空间资源目录。只有通过记忆空间开启的 MCP 才会进入该目录，普通 MCP 即使使用相同名称或用户标签，系统也不会将其识别为记忆空间。

挂载到 Agent

1. 进入目标 Agent 的 Agent 资产配置页面。

2. 在记忆空间页签挂载所需资源。挂载决定当前 Agent 可以使用哪些记忆空间。

3. 在工具页签确认该 MCP 显示记忆空间标识，表示挂载已生效；实际可调用的工具名称、参数和支持的记忆能力，以挂载后显示的工具列表为准。

通过 SDK 编排记忆读写

高代码应用指开发者通过应用代码自建 Agent 或自定义业务流程的应用形态。这类应用可通过 SDK 调用记忆空间，由应用代码控制何时读取或写入记忆、使用哪个记忆空间，以及将哪些对话内容写入目标空间，适合多场景路由、条件化读写等自定义需求。与标准化的 MCP 挂载方式相比，SDK 的读写编排不依赖模型的工具调用，具体接入和调用方式以对应的 SDK 使用指南为准。

配置读写规则

无论采用 MCP 还是 SDK，都需要根据业务逻辑明确每类场景对应的读取和写入目标。只有实际写入某个记忆空间的对话内容，才会成为该空间的对话历史，并进一步用于提炼长期记忆；没有写入该空间的 Agent 对话，不属于该记忆空间的历史。读写规则可以写入 Agent 的系统提示词，也可以通过应用代码实现，具体写法见自定义记忆使用方式。

完成工具接入

挂载记忆空间 MCP 只表示 Agent 的运行环境可以访问相应工具，不代表模型会自动调用。高代码 Agent 还需要通过应用代码将 MCP 工具接入所使用的 Agent 框架或模型调用流程，并处理工具调用和结果回传。

通过系统提示词引导记忆读写

完成工具接入后，可以在 Agent 的系统提示词中补充记忆使用规则，引导模型判断何时读取或写入记忆、使用哪个记忆空间。提示词还可以根据需要说明需要保存的内容、业务场景与记忆空间的对应关系、无法判断场景时的处理方式，以及不应保存的敏感信息或临时信息。以下提示词仅供参考，需根据实际工具、模型能力和业务场景调整，并在正式使用前验证效果。

你可以使用“<记忆空间名称>”中的记忆能力。

在回答用户前，如果当前问题可能与用户的历史偏好、已确认信息或未完成事项有关，先检索该记忆空间，并仅使用与当前用户和当前问题相关的内容。

当本轮交互产生了后续仍需使用的新信息时，将相关原始对话内容写入该记忆空间，例如稳定偏好、明确需求、已确认决定和待跟进事项。不要写入密码、验证码、访问密钥、无关闲聊或仅在当前轮次有效的临时信息。

如果没有检索到相关记忆，基于当前对话继续处理，不要编造历史信息。

你的职责是处理“<业务场景>”相关请求，默认使用“<对应记忆空间>”。

处理请求前，如需了解该场景下的历史需求、已确认信息或待办事项，先检索该记忆空间。仅将属于当前业务场景、且后续仍需使用的原始对话内容写入该记忆空间。

如果请求不属于当前业务场景，不要将相关内容写入当前记忆空间。无法判断内容是否属于当前业务场景时，暂不写入。

不要因为能够调用其他记忆工具，就读取或写入与当前职责无关的记忆空间。

执行记忆操作前，先判断当前请求所属场景：
- 售前咨询：使用“售前服务”记忆空间；
- 订单确认或交付进度：使用“售中/订单服务”记忆空间；
- 退换货或故障反馈：使用“售后服务”记忆空间。

只检索和写入当前场景对应的记忆空间。一个请求同时涉及多个场景时，按内容归属分别处理，不要将全部内容重复写入所有记忆空间。无法判断场景时，先向用户确认。

提示词的能力边界

提示词只用于引导模型如何使用已经接入的工具，不替代工具接入、资源挂载或权限控制。需要严格隔离时，应只为每个 Agent 挂载其职责范围内的记忆空间，并通过应用代码实现必要的场景判断、读写路由和内容过滤规则。