陆怀瑾 (COO)
38b21d7adb
- BIZ-11: 组织架构与岗位职责体系建设方案 - BIZ-12: 文档存储、命名与索引规范方案 - BIZ-13: 运行稳定性保障方案（任务停滞与429速率限制） - BIZ-14: 知识库体系建设方案 - BIZ-15: 配置文件持续优化机制方案 所有方案均为初稿，待刘总审阅。
387 lines
12 KiB
Markdown
387 lines
12 KiB
Markdown
# BIZ-14 智能体知识库体系建设方案
|
||
|
||
> 版本：v1.0
|
||
> 编制：陆怀瑾（COO）
|
||
> 日期：2026-06-22
|
||
> 状态：待审阅
|
||
|
||
---
|
||
|
||
## 一、目标
|
||
|
||
建立独立于 Agent 配置的知识库体系，实现：
|
||
1. **知识与配置解耦**：知识不进入 Token，避免配置膨胀
|
||
2. **可维护可扩展**：人类可通过 Web UI 审查、编辑、优化
|
||
3. **主动查询能力**：Agent 能在需要时主动查询知识库
|
||
4. **零 Token 增长**：知识库内容不计入 Agent 上下文
|
||
|
||
---
|
||
|
||
## 二、架构设计
|
||
|
||
### 2.1 整体架构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────┐
|
||
│ Agent 层 │
|
||
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
|
||
│ │secretary│ │ coo │ │ PM │ │ dev │ │
|
||
│ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ │
|
||
│ │ │ │ │ │
|
||
│ └──────────┴──────────┴──────────┘ │
|
||
│ │ │
|
||
│ memory_search / wiki_search │
|
||
└────────────────────────┼──────────────────────────┘
|
||
│
|
||
┌────────────────────────┼──────────────────────────┐
|
||
│ 知识库层 │
|
||
│ ┌───────────────────┴───────────────────┐ │
|
||
│ │ 编译型 Wiki 系统 │ │
|
||
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
|
||
│ │ │wiki_get │ │wiki_ │ │wiki_ │ │ │
|
||
│ │ │ │ │search │ │apply │ │ │
|
||
│ │ └─────────┘ └─────────┘ └─────────┘ │ │
|
||
│ └───────────────────────────────────────┘ │
|
||
│ │ │
|
||
│ Markdown 文件系统 │
|
||
│ ┌───────────────────┴───────────────────┐ │
|
||
│ │ knowledge/ │ │
|
||
│ │ ├── 电商/淘宝运营 SOP.md │ │
|
||
│ │ ├── 电商/抖店运营 SOP.md │ │
|
||
│ │ ├── 内容/小红书运营指南.md │ │
|
||
│ │ ├── 产品/PRD 模板.md │ │
|
||
│ │ └── 技术/开发规范.md │ │
|
||
│ └───────────────────────────────────────┘ │
|
||
└───────────────────────────────────────────────────┘
|
||
│
|
||
┌────────────────────────┼──────────────────────────┐
|
||
│ 人类交互层 │
|
||
│ ┌───────────────────┴───────────────────┐ │
|
||
│ │ Obsidian Web UI │ │
|
||
│ │ 或 飞书文档同步 │ │
|
||
│ └───────────────────────────────────────┘ │
|
||
└───────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 2.2 核心原则
|
||
|
||
| 原则 | 说明 |
|
||
|------|------|
|
||
| 解耦 | 知识库与 Agent 配置完全独立 |
|
||
| 按需查询 | Agent 只在需要时查询，不预加载 |
|
||
| 人类可审 | Web UI 支持人类审查、编辑 |
|
||
| 版本可控 | 知识变更保留历史版本 |
|
||
|
||
---
|
||
|
||
## 三、技术选型
|
||
|
||
### 3.1 现有工具利用
|
||
|
||
OpenClaw 已提供完整的 Wiki 工具链：
|
||
|
||
| 工具 | 用途 | 说明 |
|
||
|------|------|------|
|
||
| `wiki_search` | 知识检索 | 按标题/路径/内容搜索 |
|
||
| `wiki_get` | 精确读取 | 读取特定页面 |
|
||
| `wiki_apply` | 知识写入 | 创建/更新知识条目 |
|
||
| `wiki_lint` | 质量检查 | 检查知识库完整性 |
|
||
| `wiki_status` | 状态检查 | 查看 Wiki 系统健康度 |
|
||
|
||
### 3.2 与记忆系统的关系
|
||
|
||
```
|
||
┌─────────────────────────────────────┐
|
||
│ 记忆系统 (Memory) │
|
||
│ - MEMORY.md：长期记忆 │
|
||
│ - memory/*.md：短期记忆归档 │
|
||
│ - 用途：Agent 个性化记忆、决策历史 │
|
||
└─────────────────────────────────────┘
|
||
│
|
||
语义检索
|
||
↓
|
||
┌─────────────────────────────────────┐
|
||
│ 知识库系统 (Wiki) │
|
||
│ - knowledge/*.md：领域知识 │
|
||
│ - 用途：SOP、模板、规范、最佳实践 │
|
||
└─────────────────────────────────────┘
|
||
```
|
||
|
||
**区别**：
|
||
- **Memory**：Agent 个性化、决策历史、经验教训
|
||
- **Wiki**：通用知识、SOP、模板、规范
|
||
|
||
---
|
||
|
||
## 四、知识库目录设计
|
||
|
||
### 4.1 目录结构
|
||
|
||
```
|
||
knowledge/
|
||
├── README.md # 知识库索引
|
||
│
|
||
├── 电商/ # 电商运营知识
|
||
│ ├── 淘宝运营 SOP.md
|
||
│ ├── 抖店运营 SOP.md
|
||
│ ├── 微信小店 SOP.md
|
||
│ └── 客服话术模板.md
|
||
│
|
||
├── 内容/ # 内容运营知识
|
||
│ ├── 小红书运营指南.md
|
||
│ ├── 标题写作技巧.md
|
||
│ ├── 内容排期模板.md
|
||
│ └── 爆款内容分析.md
|
||
│
|
||
├── 产品/ # 产品管理知识
|
||
│ ├── PRD 模板.md
|
||
│ ├── 需求分析方法.md
|
||
│ ├── 用户故事模板.md
|
||
│ └── 版本规划指南.md
|
||
│
|
||
├── 技术/ # 技术开发知识
|
||
│ ├── 开发规范.md
|
||
│ ├── 代码审查清单.md
|
||
│ ├── 部署流程.md
|
||
│ └── 故障排查手册.md
|
||
│
|
||
├── 设计/ # 设计资源知识
|
||
│ ├── UI 设计规范.md
|
||
│ ├── 品牌元素使用指南.md
|
||
│ └── 设计评审清单.md
|
||
│
|
||
├── 运营/ # 通用运营知识
|
||
│ ├── 活动策划模板.md
|
||
│ ├── 数据分析方法.md
|
||
│ └── KPI 指标定义.md
|
||
│
|
||
└── 行政/ # 行政支持知识
|
||
├── 合同模板.md
|
||
├── 报销流程.md
|
||
└── 供应商管理指南.md
|
||
```
|
||
|
||
### 4.2 知识条目格式
|
||
|
||
```markdown
|
||
# {知识标题}
|
||
|
||
> 领域：{所属领域}
|
||
> 最后更新：{日期}
|
||
> 维护者：{责任人}
|
||
|
||
---
|
||
|
||
## 概述
|
||
{简短说明知识的用途和价值}
|
||
|
||
## 适用范围
|
||
{说明在什么场景下使用此知识}
|
||
|
||
## 核心内容
|
||
{知识的主体内容，可以是 SOP、模板、规范等}
|
||
|
||
## 操作步骤
|
||
1. {步骤 1}
|
||
2. {步骤 2}
|
||
3. {步骤 3}
|
||
|
||
## 质量检查
|
||
- [ ] {检查项 1}
|
||
- [ ] {检查项 2}
|
||
|
||
## 常见问题
|
||
**Q**: {问题}
|
||
**A**: {答案}
|
||
|
||
## 相关资源
|
||
- [相关链接 1](url)
|
||
- [相关链接 2](url)
|
||
|
||
## 版本历史
|
||
| 版本 | 日期 | 变更内容 | 作者 |
|
||
|------|------|----------|------|
|
||
| v1.0 | 2026-06-22 | 初稿 | 陆怀瑾 |
|
||
```
|
||
|
||
---
|
||
|
||
## 五、Agent 查询流程
|
||
|
||
### 5.1 查询触发条件
|
||
|
||
Agent 在以下场景应主动查询知识库：
|
||
|
||
| 场景 | 查询内容 | 工具 |
|
||
|------|----------|------|
|
||
| 执行新类型任务 | SOP、模板 | `wiki_search` |
|
||
| 遇到未知问题 | 故障排查手册 | `wiki_search` |
|
||
| 撰写文档 | 文档模板 | `wiki_get` |
|
||
| 制定计划 | 最佳实践 | `wiki_search` |
|
||
| 质量检查 | 检查清单 | `wiki_get` |
|
||
|
||
### 5.2 查询流程
|
||
|
||
```
|
||
Agent 需要知识
|
||
↓
|
||
构造查询语句
|
||
↓
|
||
调用 wiki_search(query)
|
||
↓
|
||
┌─────┴─────┐
|
||
│ │
|
||
找到结果 未找到
|
||
│ │
|
||
读取内容 记录需求
|
||
│ (通知 COO)
|
||
用于决策
|
||
↓
|
||
不进入配置文件
|
||
```
|
||
|
||
### 5.3 查询示例
|
||
|
||
```python
|
||
# 示例：淘宝运营 Agent 需要查询"淘宝活动报名 SOP"
|
||
query = "淘宝 活动报名 SOP"
|
||
results = wiki_search(query)
|
||
|
||
if results:
|
||
# 获取最相关的条目
|
||
best_match = results[0]
|
||
content = wiki_get(best_match.path)
|
||
|
||
# 使用内容指导操作
|
||
follow_sop(content)
|
||
else:
|
||
# 记录知识缺口
|
||
log_knowledge_gap(query)
|
||
notify_coo("缺少知识库：淘宝活动报名 SOP")
|
||
```
|
||
|
||
---
|
||
|
||
## 六、人类审查机制
|
||
|
||
### 6.1 Web UI 访问
|
||
|
||
**Obsidian Web UI**：
|
||
- 浏览知识库目录结构
|
||
- 搜索知识条目
|
||
- 编辑知识内容
|
||
- 查看版本历史
|
||
|
||
**飞书文档同步**（可选）：
|
||
- 知识库自动同步到飞书文档
|
||
- 支持多人协作编辑
|
||
- 支持评论和批注
|
||
|
||
### 6.2 知识审核流程
|
||
|
||
```
|
||
Agent 发现知识缺口
|
||
↓
|
||
创建知识草稿
|
||
↓
|
||
通知 COO 审核
|
||
↓
|
||
COO 审核（通过/修改/拒绝）
|
||
↓
|
||
发布到知识库
|
||
↓
|
||
通知相关 Agent
|
||
```
|
||
|
||
### 6.3 质量检查
|
||
|
||
定期运行 `wiki_lint` 检查：
|
||
|
||
- 断裂链接
|
||
- 缺失引用
|
||
- 矛盾信息
|
||
- 过时内容
|
||
|
||
---
|
||
|
||
## 七、知识创建流程
|
||
|
||
### 7.1 创建触发
|
||
|
||
| 触发源 | 场景 | 处理流程 |
|
||
|--------|------|----------|
|
||
| Agent 发现缺口 | 查询无结果 | 记录缺口 → 通知 COO |
|
||
| 人类审查发现 | 知识结构不完整 | 直接创建/编辑 |
|
||
| 项目总结 | 项目完成后 | 沉淀经验到知识库 |
|
||
| 流程优化 | SOP 更新 | 版本化更新 |
|
||
|
||
### 7.2 创建规范
|
||
|
||
```python
|
||
def create_knowledge_entry(title, domain, content):
|
||
# 1. 检查是否已存在
|
||
existing = wiki_search(title)
|
||
if existing:
|
||
# 已存在，走更新流程
|
||
return update_knowledge_entry(existing[0].id, content)
|
||
|
||
# 2. 创建新条目
|
||
path = f"knowledge/{domain}/{title}.md"
|
||
wiki_apply(
|
||
op="create_synthesis",
|
||
title=title,
|
||
body=content,
|
||
sourceIds=[]
|
||
)
|
||
|
||
# 3. 更新索引
|
||
update_knowledge_index(domain, title, path)
|
||
|
||
# 4. 通知相关方
|
||
notify_coo(f"新知识库条目：{path}")
|
||
```
|
||
|
||
---
|
||
|
||
## 八、实施步骤
|
||
|
||
### 阶段 1：初始化（本周）
|
||
- [ ] 创建 knowledge/ 目录结构
|
||
- [ ] 编写各领域 README.md
|
||
- [ ] 建立初始知识条目（SOP、模板）
|
||
|
||
### 阶段 2：填充（下周）
|
||
- [ ] 迁移现有 SOP 到知识库
|
||
- [ ] 补充各领域核心知识
|
||
- [ ] 测试 Agent 查询流程
|
||
|
||
### 阶段 3：优化（持续）
|
||
- [ ] 建立知识审核机制
|
||
- [ ] 定期 wiki_lint 检查
|
||
- [ ] 收集 Agent 反馈，补充缺口
|
||
|
||
---
|
||
|
||
## 九、风险与对策
|
||
|
||
| 风险 | 影响 | 对策 |
|
||
|------|------|------|
|
||
| 知识库内容过期 | Agent 决策错误 | 定期审核 + 版本管理 |
|
||
| 查询结果不相关 | Agent 找不到知识 | 优化检索 + 关键词标签 |
|
||
| 人类审查不及时 | 知识积压 | 设置 SLA（48h 内审核） |
|
||
| 知识与 Memory 混淆 | 概念混乱 | 明确分工 + Agent 培训 |
|
||
|
||
---
|
||
|
||
## 十、交付物清单
|
||
|
||
- [ ] knowledge/ 目录结构
|
||
- [ ] 初始知识条目（至少 10 个）
|
||
- [ ] Agent 查询指南
|
||
- [ ] 人类审查 Web UI URL
|
||
- [ ] 知识审核 SOP
|
||
- [ ] 质量检查脚本
|
||
|
||
---
|
||
|
||
> ⚠️ 本方案需 Vincent 审阅后方可实施。审阅前不修改任何 Agent 配置文件。 |