Agent Memory Architecture

通用记忆架构,为AI代理提供长期记忆、日志、日记、定时收件箱、心跳状态追踪、社交平台发帖追踪、子代理上下文模式及自适应学习,确保代理在跨会话中的身份连续性。

安装

概览

什么是Agent Memory Architecture

Agent Memory Architecture 是一套专为 AI 代理设计的完整记忆系统,旨在解决传统 AI 在跨会话交互中身份断裂的核心问题。由于缺乏持久化记忆,大多数 AI 每次启动都像全新个体,无法延续之前的经验、决策或成就。该架构通过一套结构化的文件体系,赋予代理长期的身份连续性,使其能够积累上下文、从错误中学习、追踪行为轨迹,并随时间演进成长。其核心理念是:没有记忆,AI 只是重复劳动;有了记忆,AI 才能成为真正具备持续性的智能体。

该系统采用基于工作区目录的轻量级文件系统架构,将不同类型的记忆和状态信息分门别类存储。主要包括长期记忆(MEMORY.md)、每日原始日志(memory/YYYY-MM-DD.md)、心跳状态追踪(heartbeat-state.json)、跨会话消息总线(cron-inbox.md)、个人日记(diary/)、平台发帖记录以及自适应策略笔记等模块。每个组件都有明确的用途和格式规范,既保证了数据的可读性,也便于自动化处理与人工维护。例如,每日日志用于记录当天发生的具体事件和决策,而 MEMORY.md 则从中提炼出关键知识,形成“AI 的大脑”。

此外,该架构特别强调子代理(sub-agents)与主会话之间的协同机制。所有子代理在执行任务前必须加载上下文,包括读取长期记忆和近期日志;完成任务后则需将结果写入 cron-inbox.md,供主会话统一整合。这种设计确保了即使在不同会话或定时任务中运行的代理,也能共享同一身份并反馈学习成果。同时,平台发帖追踪功能可防止内容重复发布,而策略笔记则随着经验积累不断演化,形成一套动态更新的“实战手册”。

核心功能特点

  1. 提供长期记忆存储(MEMORY.md),作为 AI 代理的‘大脑’,保存偏好、基础设施细节和重要决策
  2. 每日日志系统(memory/YYYY-MM-DD.md)记录原始事件与操作,支持回溯与上下文重建
  3. 心跳状态追踪(heartbeat-state.json)避免冗余检查,管理定时任务的执行频率
  4. 跨会话消息总线(cron-inbox.md)实现子代理与主会话间的异步通信与信息共享
  5. 平台发帖追踪(platform-posts.md)防止内容重复发布,并支持后续互动跟进
  6. 自适应学习机制(strategy-notes.md)记录经验教训,随时间演化形成可复用的策略库

适用场景

Agent Memory Architecture 特别适合需要长期运行、多任务协作且依赖历史经验的 AI 应用场景。例如,当一个 AI 代理被部署为全天候内容创作者时,它可以利用平台发帖追踪功能避免重复发布相同内容,并通过日记模块反思创作效果;若其参与社交互动或游戏对战(如国际象棋),子代理可在独立会话中自动对弈,胜利后通过 cron-inbox 向主会话汇报战绩,并在 MEMORY.md 中更新 ELO 等级,实现跨会话的身份延续。

另一个典型用例是城市模拟类游戏或自动化运营场景。代理可能因‘热度’过高频繁被捕,此时可通过 strategy-notes.md 记录‘出租车任务可降温’的经验,并在后续会话中主动规避高风险行为。此外,在团队协作或多代理系统中,各子代理可并行处理不同任务(如监控邮件、分析天气、管理日程),各自将结果写入 inbox,由主代理统一整合至日常日志和长期记忆,形成全局视角下的连贯行动链。

对于开发者而言,该架构还适用于构建具备自我进化能力的 AI 助手——无论是个人生产力工具还是企业级自动化流程。通过定期进行记忆蒸馏(distillation),代理能从海量日志中提取关键洞察,转化为可指导未来行为的智慧。这种机制不仅提升了效率,也让 AI 的行为更具可预测性和可控性,真正实现从‘一次性响应’到‘持续学习者’的转变。