陆怀瑾 (COO)
8c93fee885
纳入刘总反馈：QMD 全文检索为第三层检索路径。分层检索体系：memory_search → wiki_search → qmd → web。初始知识基础条目规划。知识 vs Memory 系统分工。人类审查机制与审核流程。
261 lines
6.4 KiB
Markdown
261 lines
6.4 KiB
Markdown
# 智能体知识库体系建设规范 v1.0
|
||
|
||
> 版本：v1.0（实施版）
|
||
> 编制：陆怀瑾（COO）
|
||
> 日期：2026-06-22
|
||
> 状态：已批准，执行中
|
||
> 适用范围：所有 Agent
|
||
|
||
---
|
||
|
||
## 一、核心目标
|
||
|
||
| 目标 | 实现方式 |
|
||
|------|----------|
|
||
| 知识与配置解耦 | 知识库独立于 Agent 配置文件，不计入 Token |
|
||
| Agent 可主动查询 | 通过多层检索体系按需获取知识 |
|
||
| 人类可审查优化 | Web UI / 飞书文档支持人工审阅 |
|
||
| 零 Token 增长 | 知识条目独立存储，仅在使用时加载 |
|
||
|
||
---
|
||
|
||
## 二、分层检索体系（刘总反馈已纳入）
|
||
|
||
### 2.1 检索优先级
|
||
|
||
```
|
||
Agent 需要知识
|
||
↓
|
||
第一层: memory_search (corpus=all)
|
||
→ 搜索 memory/*.md + MEMORY.md + wiki 条目
|
||
→ 零 Token 消耗，语义检索
|
||
↓ 未命中
|
||
第二层: wiki_search / wiki_get
|
||
→ 编译型结构化知识库
|
||
→ 支持精确检索和页面读取
|
||
↓ 未命中
|
||
第三层: qmd (QMD 全文检索，已安装 ← 刘总反馈)
|
||
→ 本地全文检索 markdown 知识库
|
||
→ 补充 memory_search 未覆盖的长文档
|
||
↓ 未命中
|
||
第四层: web_search / web_fetch
|
||
→ 外部互联网补充
|
||
→ 仅在内部均未命中时使用
|
||
```
|
||
|
||
### 2.2 工具速查
|
||
|
||
| 工具 | 适用场景 | Token 消耗 |
|
||
|------|----------|-----------|
|
||
| memory_search | 通用语义检索（跨 memory + wiki） | 0 |
|
||
| wiki_search / wiki_get | 结构化知识库精确查询 | 0 |
|
||
| qmd | 本地全文检索长文档 | 0 |
|
||
| web_search | 外部互联网信息 | 0 |
|
||
| web_fetch | 网页/文档详情获取 | 按内容量 |
|
||
|
||
---
|
||
|
||
## 三、知识库目录结构
|
||
|
||
```
|
||
knowledge/
|
||
├── 电商/ # 电商运营知识
|
||
│ └── {主题}_v{M}.{N}.md
|
||
│
|
||
├── 内容/ # 内容运营知识
|
||
│ └── {主题}_v{M}.{N}.md
|
||
│
|
||
├── 产品/ # 产品管理知识
|
||
│ └── {主题}_v{M}.{N}.md
|
||
│
|
||
├── 技术/ # 技术开发知识
|
||
│ └── {主题}_v{M}.{N}.md
|
||
│
|
||
├── 设计/ # UI/UX 设计知识
|
||
│ └── {主题}_v{M}.{N}.md
|
||
│
|
||
├── 运营/ # 通用运营知识
|
||
│ └── {主题}_v{M}.{N}.md
|
||
│
|
||
└── 规范/ # 流程规范知识
|
||
└── {主题}_v{M}.{N}.md
|
||
```
|
||
|
||
### 知识条目模板
|
||
|
||
```markdown
|
||
# {知识标题}
|
||
|
||
> 领域: {所属领域} | 版本: v{M}.{N}
|
||
> 维护者: {责任人} | 最后更新: {YYYY-MM-DD}
|
||
|
||
## 概述
|
||
{知识的用途和价值，1-2 句话}
|
||
|
||
## 适用范围
|
||
{在什么场景下使用}
|
||
|
||
## 核心内容
|
||
{知识主体}
|
||
|
||
## 操作步骤 / SOP
|
||
1. ...
|
||
2. ...
|
||
|
||
## 质量检查
|
||
- [ ] ...
|
||
|
||
## 常见问题
|
||
**Q**: ... **A**: ...
|
||
|
||
## 相关条目
|
||
- knowledge/{领域}/{关联主题}.md
|
||
|
||
## 版本历史
|
||
| 版本 | 日期 | 变更 | 作者 |
|
||
|------|------|------|------|
|
||
| v1.0 | 2026-06-22 | 初稿 | 陆怀瑾 |
|
||
```
|
||
|
||
---
|
||
|
||
## 四、与 Memory 系统的分工
|
||
|
||
| 维度 | Memory 系统 | Knowledge 系统 |
|
||
|------|------------|---------------|
|
||
| 内容类型 | 决策记录、经验教训、个性化记忆 | SOP、模板、规范、最佳实践 |
|
||
| 所有者 | 单个 Agent 专属 | 跨 Agent 共享 |
|
||
| 更新频率 | 每日/每周 | 按需/按版本 |
|
||
| 查询方式 | memory_search（语义检索） | wiki_search/wiki_get/qmd |
|
||
| 存储位置 | MEMORY.md + memory/*.md | knowledge/ 目录 |
|
||
|
||
---
|
||
|
||
## 五、Agent 查询指南
|
||
|
||
### 5.1 何时查询知识库
|
||
|
||
| 场景 | 查询示例 |
|
||
|------|----------|
|
||
| 执行 SOP 任务 | "淘宝 活动报名 SOP" |
|
||
| 撰写文档 | "PRD 模板" |
|
||
| 遇到问题 | "部署 故障排查" |
|
||
| 制定规范 | "开发规范" |
|
||
| 不熟悉领域 | "小红书 运营指南" |
|
||
|
||
### 5.2 查询标准流程
|
||
|
||
```
|
||
1. 先用 memory_search(corpus=all, query="...") 搜索
|
||
2. 如有结果，用 memory_get 或 wiki_get 读取详情
|
||
3. 如无结果，用 qmd 全文检索 knowledge/ 目录
|
||
4. 仍无结果，记录知识缺口，通知 COO
|
||
5. 使用获取的知识指导工作
|
||
```
|
||
|
||
### 5.3 知识缺口上报
|
||
|
||
```
|
||
Agent 发现知识缺口
|
||
↓
|
||
在 memory/YYYY-MM-DD.md 中记录：
|
||
- 查询内容
|
||
- 使用场景
|
||
- 建议优先级
|
||
↓
|
||
通知 COO 创建知识条目
|
||
```
|
||
|
||
---
|
||
|
||
## 六、人类审查机制
|
||
|
||
### 6.1 审查方式
|
||
|
||
| 方式 | 适用场景 | 工具 |
|
||
|------|----------|------|
|
||
| Obsidian Web UI | 日常浏览、编辑 | wiki_status 确认可用性 |
|
||
| 飞书文档同步 | 多人协作、审批 | 飞书 Wiki API |
|
||
| CLI 直接编辑 | 技术人员修改 | write/edit 工具 |
|
||
|
||
### 6.2 审核流程
|
||
|
||
```
|
||
Agent 发现缺口 → 记录 → 通知 COO
|
||
↓
|
||
COO 评估优先级
|
||
↓
|
||
高优先级 → 立即创建/指派
|
||
低优先级 → 记入 backlog
|
||
↓
|
||
创建草稿 → wiki_apply(op="create_synthesis")
|
||
↓
|
||
人类审查 → 通过/修改/拒绝
|
||
↓
|
||
发布 → 通知相关 Agent
|
||
```
|
||
|
||
### 6.3 定期质量检查
|
||
|
||
```bash
|
||
# 每周运行一次
|
||
wiki_lint # 检查链接断裂、矛盾信息、过时内容
|
||
```
|
||
|
||
---
|
||
|
||
## 七、知识条目管理
|
||
|
||
### 7.1 创建
|
||
|
||
```
|
||
wiki_apply(op="create_synthesis", title="...", body="...", sourceIds=[])
|
||
```
|
||
|
||
### 7.2 更新
|
||
|
||
```
|
||
wiki_apply(op="synthesis", lookup="...", body="...")
|
||
```
|
||
|
||
### 7.3 版本管理
|
||
|
||
| 变更类型 | 版本变化 | 操作 |
|
||
|----------|----------|------|
|
||
| 内容微调 | v1.0 → v1.1 | 直接覆盖，更新版本历史 |
|
||
| 结构性变更 | v1.x → v2.0 | 保留旧版本，新建条目 |
|
||
| 废弃 | 添加 [deprecated] 标记 | 归档到 archive/ |
|
||
|
||
---
|
||
|
||
## 八、初始知识基础
|
||
|
||
以下条目作为知识库初始基础，需尽快创建：
|
||
|
||
| 领域 | 条目 | 优先级 | 负责 Agent |
|
||
|------|------|--------|-----------|
|
||
| 电商 | 淘宝运营 SOP | 高 | 陆云帆 |
|
||
| 电商 | 客服话术模板 | 中 | 陆云帆 |
|
||
| 内容 | 小红书运营指南 | 高 | 文墨言 |
|
||
| 内容 | 标题写作技巧 | 中 | 文墨言 |
|
||
| 产品 | PRD 模板 | 高 | 沈路明 |
|
||
| 技术 | 开发规范 | 高 | 梁思筑 |
|
||
| 技术 | 部署流程 | 中 | 严维序 |
|
||
| 设计 | UI 设计规范 | 中 | 苏锦绘 |
|
||
| 运营 | KPI 指标定义 | 中 | 陆怀瑾 |
|
||
| 规范 | 文档存储规范 | 已完成 | 陆怀瑾 |
|
||
|
||
---
|
||
|
||
## 九、交付物清单
|
||
|
||
- [x] 知识库体系建设规范（本文档）
|
||
- [ ] knowledge/ 目录结构创建
|
||
- [ ] 初始知识条目（至少 5 个优先）
|
||
- [ ] Agent 查询指南（已嵌入本文档）
|
||
- [ ] 知识审核流程（已嵌入本文档）
|
||
- [ ] wiki_lint 定期检查 cron 任务
|
||
|
||
---
|
||
|
||
> 本规范自批准之日起生效。知识条目创建请联系 COO 协调。 |