记忆中心用于管理企业服务智能体长期交互产生的上下文资产，通过树形视图统一查看系统自动生成的记忆摘要、会话记录、资源索引、技能相关文件。文件目录与命名具备调度语义，不建议手动删改，防止影响智能体对话效果。本文介绍企业服务智能体管理者如何开启/关闭企业服务智能体的记忆能力，以及如何查看和维护记忆中心。 ## 基本概念 |**概念** |**含义** |**面向对象** | |---|---|---| |**记忆能力** |企业服务智能体是否具备长期记忆的总开关，企业服务智能体创建时默认开启。 |企业服务智能体实例 | |**记忆中心** |用于查看和维护企业服务智能体长期记忆资产的页面。 |企业服务智能体实例 | |**记忆策略** |企业服务智能体使用记忆中心时的读取、写入与过期规则。 |企业服务智能体实例 | ## 项目文件说明记忆中心以树形结构列出企业服务智能体的全部上下文文件，层级为 **user → 用户 UUID → 六类内容子目录 + 两个概览文件**。 > UUID（Universally Unique Identifier）是全局唯一标识。每个用户 UUID 目录下按内容类型拆分为 `memories`、`peers`、`privacy`、`resources`、`sessions`、`skills` 六个子目录，并在同层放置 `.abstract.md `与 `.overview.md `两个概览文件；sessions 下再包含多个以会话 UUID 命名的子目录，每个会话目录下存放` .meta.json `与 `messages.jsonl`等系统生成文件。 ### 目录结构 |目录 |说明 |管理建议 | |---|---|---| |memories |保存长期记忆的摘要和概览，例如项目背景、用户偏好、长期决策等。 |优先查看；修改前确认是否会改变助手后续理解。 | |peers |协作对象、相关人或关联主体信息。 |涉及人员信息时谨慎查看和传播。 | |privacy |隐私、权限或不应记忆内容的相关配置。 |不建议手动修改；如需调整隐私规则，优先使用产品设置入口。 | |resources |上传附件、截图、文档材料或资源索引。 |用于追溯材料来源；删除前确认是否仍被会话或记忆引用。 | |sessions |含多个会话 UUID 子目录，保存不同对话线程的原始记录和元数据。 |用于问题排查、历史回溯和对话证据定位。 | |skills |保存技能相关摘要和概览，帮助理解助手可使用的能力范围。 |查看为主；不要直接改内部技能脚本或系统生成内容。 |

注意

不要直接删除或批量改写 privacy、sessions、skills 下的系统生成文件。此类操作可能导致历史上下文丢失、会话排查困难、技能摘要不一致，或影响助手后续对话中的记忆效果。

### 系统生成文件说明 UUID 目录同级及各会话目录下的系统生成文件由系统在对话过程中自动生成，命名前缀（如`.`）表明其为系统托管文件，处置建议如下表。 |**文件** |**位置** |**内容** |**建议处置** | |---|---|---|---| |.overview.md |用户 UUID 目录同级 / 各会话 UUID 目录 |概览：供快速判断主题范围。 |适合阅读 | |.abstract.md |用户 UUID 目录同级 / 各会话 UUID 目录 |摘要：供判断某会话是否命中当前场景。 |适合阅读 | |.meta.json |各会话 UUID 目录 |会话元数据：时间戳、状态、参与者等。 |谨慎查看 | |messages.jsonl |各会话 UUID 目录 |原始消息流水，逐条包含内容、工具状态和时间信息。 |谨慎查看 | ## 前提条件已具备企业服务智能体管理者权限。 ## 开启与关闭记忆能力记忆能力是企业服务智能体具备长期记忆的总开关，企业服务智能体创建完成时默认开启，无需手动操作。仅在极少数场景下（如敏感场景需关闭长期记忆、临时调试或合规下线）需要手动关闭。 ### 开启记忆能力创建完成后，记忆能力自动开启，管理者可直接在管理控制台进入 **记忆中心** 页面查看和管理。 ## 查看记忆策略 1. 企业服务智能体管理者登录 ArkClaw 工作台，在左侧切换至目标企业服务智能体实例页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0e796d3a3428a44023199c08c26f990e.png) 2. 在左侧导航栏，选择 Agent 管理。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_93ab21aab01225a035c1f93734821756.png) 3. 选择“基本信息”，并单击“记忆策略”按钮，查看当前 Agent 的记忆策略。 ## 管理记忆中心 ### 管理边界记忆中心内文件按处置方式划分为四类。原则上，摘要与概览类文件适合阅读，原始日志适合审计，隐私与技能相关文件应通过产品能力管理，不应直接改底层文件。 |**操作类型** |**适用对象** |**说明** | |---|---|---| |适合阅读 |.abstract.md、.overview.md |用于快速理解记忆、会话或技能概况，风险较低。 | |谨慎查看 |messages.jsonl、.meta.json |包含原始对话、工具状态和时间信息，适合排障，不适合传播无关内容。 | |谨慎修改 |memories 下的摘要类文件 |可能影响助手后续对用户背景和项目状态的理解，修改前应保留原文。 | |不建议手动操作 |privacy、skills、系统生成日志 |可能涉及隐私规则、技能配置或系统一致性，应优先使用正式管理入口。 | ### 日常管理场景记忆中心的日常维护建议管理者应先明确本次要解决什么问题，再进入对应目录。 #### 场景 1：快速了解企业服务智能体记住了什么 **适用情形：** 仅想了解企业服务智能体记住了什么背景、偏好或长期决策，不涉及具体某次对话。 1. 进入 **记忆中心** 页面，在**项目文件**面板中展开目标用户 UUID 目录。 2. 打开 UUID 目录同级的` .overview.md`，检查其中的整体概览是否覆盖当前项目、用户偏好或长期决策。若仅需快速判断主题，可先看` .abstract.md`。 3. 如需深入某一类记忆，再展开` memories `子目录查看对应文件。 4. 验证：确认概览中未出现已过期或已作废的偏好；若发现偏差，建议保留原文后再进行修改。 #### 场景 2：排查某次异常对话 **适用情形：** 需要回溯某次具体对话（如工具调用失败、回答不符合预期）。 1. 在 **记忆中心** 中展开` sessions `子目录，按会话 UUID 定位目标会话目录。 2. 先打开` .meta.json `判断是否为目标会话（可通过时间戳、参与者等元数据交叉核对）。 3. 再打开` messages.jsonl`，按时间戳和状态字段定位问题。若看到 `tool_status` 从 `pending` 变为 `completed`，通常说明对应工具调用已完成；如果长期停留在` pending`，需结合 `.meta.json `中的 `updated_at `字段判定是否属于中断或未完成调用。 4. 验证：将排查结论回填到工单或对话记录中，避免重复排查。 `tool_status` 常见取值及处置建议如下： |**状态值** |**含义** |**处置建议** | |---|---|---| |pending |工具调用已发起、尚未收到结果。 |若 5 分钟内自然流转到 completed，可忽略；超过 5 分钟仍未变化，视为中断。 | |completed |工具调用已完成。 |正常状态，无需处理。 | |failed |工具调用失败。 |结合上下文与错误码判断是否需要重试或调整技能配置。 | |interrupted |调用中途被终止。 |确认是用户主动打断还是系统异常，前者可忽略，后者需联系运维排查。 | #### 场景 3：核对企业服务智能体的能力边界 **适用情形：** 需要确认企业服务智能体当前可用的技能范围，或核对某个技能描述是否与实际能力一致。 1. 在 **记忆中心** 中打开 UUID 目录同级的 `.overview.md`，其中会汇总企业服务智能体的技能范围。 2. 展开 skills 子目录，查看其中的具体技能文件。 3. 验证：确认技能摘要是否与企业服务智能体实际能力一致。若不一致，请从[技能管理](https://docs.volcengine.com/docs/87732/2534896)入口调整，不要直接改文件。

ArkClaw 企业版