建一个智能体会遵循的操作指南库
把你摸索出来的方法,整理成一棵操作指南树;你自己、Claude Code 或 Codex 都能查到它,一步步照着做,并且每次都把它改得更好。
你摸索出来的每一个解决办法都值得写下来:重置路由器、部署步骤、税表怎么填。用对的格式写下来,智能体就能找到它、照着做,还能指出哪一步已经不管用了。
你需要
- 数据库里装好 Knowledge 包(参见你的前 30 分钟)。
- 一个连接到它的 AI。对于技术类操作指南,像 Claude Code 或 Codex 这样的编程智能体可以直接照着执行。
Knowledge 包的结构
| 表格 | 存放什么 | 有用的字段 |
|---|---|---|
knowledges | 每行一条笔记或操作指南 | title、context、knowledge_type、knowledge_parent(一条笔记可以放在另一条下面)、related_knowledge(双向关联) |
knowledge_type | 你的分类,可以嵌套 | title、parent_type |
如果同时装了 Progress 包,目标、项目和任务都可以关联到它们所依赖的笔记。
1. 建几个类型(5 分钟)
保持精简。以后随时可以拆分类型。一个虚构的例子:
| 类型 | 上级 |
|---|---|
| How-to | (顶层) |
| Home | How-to |
| Work | How-to |
| Deploy | Work |
| Reference | (顶层) |
让你的 AI 来创建:
创建这些知识类型:How-to,下面有 Home 和 Work;Work 下面有 Deploy;另外顶层有一个 Reference。
2. 写智能体能照着做的操作指南(15 分钟)
一条操作指南要对智能体有用,得写清楚什么时候适用、确切的步骤,以及怎么判断做成了。按这个格式要求它:
在 Deploy 下保存一条操作指南,名为“部署网站”。适用时机:合并到 main 之后。步骤:运行测试、构建、把 out 文件夹上传到服务器、检查首页能否打开。完成标准:页脚显示新版本号。注意事项:服务器需要的是构建文件夹,不是源码。
然后再加一条出问题时会用到的,并把两条关联起来,让一条能引出另一条:
在 Deploy 下再保存一条操作指南,“回滚一次失败的部署”:把上一个构建文件夹放回服务器,然后检查首页。把它作为相关知识关联到“部署网站”。
3. 让智能体照着做一次(5 分钟)
在编程智能体里,进入对应的项目:
找到我那条部署网站的操作指南,照着做。上传任何东西之前先停下来问我。
智能体会查找它(query_records),读取关联的笔记(get_record_neighbors),然后一步步执行,并在你要求的地方停下。
4. 让它保持鲜活(持续进行)
操作指南会过时。解决办法是一发现就立刻更新:
那一步写错了:服务器要的是复制文件夹,不是同步。更新部署操作指南,并把原因作为注意事项加上。
检查是否成功
- 问“怎么部署网站?”,返回的是你的笔记,而不是泛泛的回答。
- 打开一条操作指南,能看到它的类型、上级和相关笔记。
- 有一条操作指南在真实使用后被修正过。
下一步
看看这一切是怎么连在一起的:探索你的知识图谱。