智忆入门:让 Agent 像老员工一样复用团队经验

头像数据分析狮   创建 于 07月27日41

AI Experience Cloud|把真实做过的事,沉淀成可被人和 AI 持续复用的经验。

智忆产品封面:经验网络与 Agent 协同

一、智忆是什么

智忆zhiyi.atbigapp.com)是巨人肩膀生态中的「经验基础设施」。

它解决的不是「再写一篇文档」,而是:

  • 每次对话结束,Context 清空,同类 Bug / 方案反复踩坑
  • Wiki、飞书文档为人阅读优化,Agent 取用时噪音大、缺少「为什么」和适用边界
  • 架构决策、排障教训只存在于个人脑中,人走经验也走

智忆用 结构化经验卡(背景、观察、决策、行动、结果、适用条件)沉淀真实做过的事;人可以浏览确认,Cursor / Claude Code 等 Agent 也能在开工前按任务精准召回。

产品定位一句话:

让 Agent 像工作五年的老员工一样工作。


二、产品飞轮:采集 → 确认 → 召回 → 进化

智忆四步飞轮:采集、确认、召回、持续进化
步骤 名称 做什么
01 自动采集 Agent 完成任务后提交记忆草稿,或从对话 / 改动中提炼经验
02 人工确认 负责人在 Web 端 Review 草稿,校验可信度后发布
03 智能召回 新任务开始前,Agent 按任务上下文 Recall 相关经验与决策
04 持续进化 Feedback 驱动排序,失效经验可标记,越用越准

与传统社区(文章 + 点赞)不同,智忆强调:验证、采纳、失效标记,以及 MCP 一等公民接入——经验即 Context。


三、典型使用场景

研发协作、新人上手、架构决策三类使用场景

场景 1:研发团队少踩「重复坑」

团队刚修过「PM2 热更新找不到进程」「OAuth 回调 404」这类问题。若不沉淀,下个迭代或新人仍会再踩一遍。

用智忆后:

  1. 修完问题,让 Agent 调用 memory_submit 提交经验草稿
  2. 负责人在「草稿确认」核对观察 / 决策 / 行动后发布
  3. 下次同类任务开始前,Agent 先 memory_recall,带着历史解法动手

场景 2:个人开发者沉淀可复用实践

个人也可先跑通闭环:把「自己踩过的坑 + 最终做法」写成经验卡。下周做相似需求时,Agent 不再从零猜,而是先读你的历史经验。

适合:已在用 Cursor / Claude Code,希望个人最佳实践不被对话窗口冲掉。

场景 3:把「为什么这样做」留下来(决策与规则)

记忆中心不只存经验,还可沉淀:

类型 记什么 何时用
经验 (Experience) 可复用的做事方法(现象 → 方案 → 结果) 排障、实现同类功能
规则 / 流程 长期要遵守的约定 代码规范、发版检查清单
决策 (Decision) 为什么选了这条路的关键取舍 架构选型、技术债权衡

新人问「为什么不用方案 B」时,不再只靠口述,Agent 也能召回当时的决策上下文。

场景 4:组织记忆不随人走

骨干离职前,把关键排障经验、上线教训、模块约定确认入库。后续 Agent 与同事共享同一套 Memory,而不是从聊天记录里考古。


四、简单使用教程(约 15 分钟跑通闭环)

接入 MCP:密钥、IDE 与经验云连接示意

准备:Node.js 18+、Cursor(或其他支持 MCP 的 Agent)、巨人肩膀账号。

产品入口:https://zhiyi.atbigapp.com/

第 1 步:登录并签发 Agent 密钥

  1. 打开智忆,使用巨人肩膀统一账号登录(已有账号无需再注册)
  2. 进入工作台 → 打开工作空间设置
  3. Agent API Key 中点击「签发密钥」
  4. 勾选权限:召回经验提交草稿
  5. 立刻复制明文密钥(仅显示一次),妥善保存

第 2 步:在 Cursor 中配置智忆 MCP

在 Cursor 的 MCP 配置(如 .cursor/mcp.json 或全局 MCP 设置)中加入:

json 复制代码
{
  "mcpServers": {
    "zhiyi-mcp": {
      "command": "npx",
      "args": ["-y", "zhiyi-mcp"],
      "env": {
        "BIGAPP_API_KEY": "粘贴你在工作空间签发的密钥"
      }
    }
  }
}

说明:

  • BIGAPP_API_KEY 换成上一步复制的密钥
  • 生产包已内置 API 地址,一般只需填密钥
  • 配置后重载 MCP,确认 zhiyi-mcp 已连接

第 3 步:验证连通

在 Agent 对话中发送:

text 复制代码
请调用智忆 MCP 工具 memory_recall,测试智忆是否已连通。

【必须执行】
1. 使用 MCP 工具 memory_recall(不要猜测或模拟返回)
2. task 填:MCP 连接测试

调用成功后,请告诉我:是否成功、返回了几条经验(可以为 0)、若失败请贴出报错。

能正常返回(哪怕 0 条)即表示接入成功。

第 4 步:完成一件真实事后,提交经验草稿

选一件刚做完的事(修 Bug、加页面、排查环境问题均可),对 Agent 说:

text 复制代码
请调用智忆 MCP 工具 memory_submit,把刚才完成的任务提交为记忆草稿。

【必须执行】
1. 使用 MCP 工具 memory_submit 提交(不要只在聊天里总结)
2. knowledgeType 填 experience
3. payload 各字段分开写:
   - task:任务标题(80 字以内)
   - observation:遇到了什么问题/现象
   - decision:为什么选这个方案
   - action:具体改了哪些文件、配置或命令
   - outcome:结果如何、怎样验证已解决
4. 如有改动过的文件,传入 modifiedFiles 数组

提交成功后会得到草稿 ID,状态为待确认(pending_review)。

若 Agent 只总结不调工具,可补充一句:「请立即调用 memory_submit MCP 工具提交」。

第 5 步:在 Web 端审核并发布

  1. 打开智忆 → 草稿确认 / Capture
  2. 核对标题与观察、决策、行动、结果,确认无敏感信息
  3. 确认发布到经验中心

质量不高可直接拒绝,不影响后续使用。

第 6 步:新任务前先召回

做同类任务前,先让 Agent 读经验再写代码:

text 复制代码
请先调用智忆 MCP 工具 memory_recall 搜索团队历史经验,读完后再动手写代码。

【必须执行】
1. 使用 MCP 工具 memory_recall(不要用网页搜索,也不要凭记忆回答)
2. 将下方「任务描述」填入 task 参数(只写业务意图,不要把项目代号塞进 task)
3. 若已知当前文件或模块,一并传入 currentFile、module、repository

任务描述:【例如:修复登录页 OAuth 回调 404】

召回成功后请:列出最相关的 1~3 条经验标题,说明对当前任务的建议,再给出实施计划。

至此,「接入 → 沉淀 → 确认 → 召回」闭环已跑通。


五、日常怎么用更顺手

在 Web 端找历史方案

打开 经验搜索,用任务描述或关键词检索已发布经验,比翻聊天记录更直接,也可把命中内容整理后交给 Agent 继续用。

看经验有没有被真正用上

闭环追踪 查看取用、反馈与失效情况。长期无人采用或反馈不佳的,回到记忆中心修订或标记失效,让库越用越准。

经验 vs 社区帖子怎么选

社区帖子 智忆
形态 全文文章 / 问答 结构化 Experience
消费 人读全文 人浏览 + Agent 按任务 Recall
质量信号 点赞、粉丝 验证、采纳、失效标记
适合目标 传播、讨论 团队与助手持续复用真实做过的事

目标若是「让团队和助手持续复用」,优先用智忆。


六、常用 MCP 工具一览

工具 作用
memory_recall 按任务上下文召回已发布经验
memory_submit 提交记忆草稿(经验 / 规则 / 流程 / 决策)
memory_feedback 对召回结果反馈(有用 / 过时 / 错误等)
memory_graph_explore 以某条经验为中心探索关系子图

召回时记住:task 只写业务意图project / module / repository 用独立字段,避免项目名污染检索。


七、写在最后

智忆不是「AI 版知乎」,而是面向 人确认 + Agent 消费 的经验层:

  1. 先签发密钥并配置 MCP
  2. 用一件真实任务跑通提交与审核
  3. 下次同类任务先召回再动手

约 15 分钟,你就能拥有一条「可被人和 AI 共同复用」的组织记忆。

欢迎登录后从工作台「快速开始」跟着四步引导完成第一圈闭环。