陆怀瑾 (COO)
38b21d7adb
- BIZ-11: 组织架构与岗位职责体系建设方案 - BIZ-12: 文档存储、命名与索引规范方案 - BIZ-13: 运行稳定性保障方案（任务停滞与429速率限制） - BIZ-14: 知识库体系建设方案 - BIZ-15: 配置文件持续优化机制方案 所有方案均为初稿，待刘总审阅。
12 KiB
12 KiB
BIZ-14 智能体知识库体系建设方案
版本：v1.0
编制：陆怀瑾（COO）
日期：2026-06-22
状态：待审阅
一、目标
建立独立于 Agent 配置的知识库体系，实现：
- 知识与配置解耦：知识不进入 Token，避免配置膨胀
- 可维护可扩展：人类可通过 Web UI 审查、编辑、优化
- 主动查询能力：Agent 能在需要时主动查询知识库
- 零 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 知识条目格式
# {知识标题}
> 领域：{所属领域}
> 最后更新：{日期}
> 维护者：{责任人}
---
## 概述
{简短说明知识的用途和价值}
## 适用范围
{说明在什么场景下使用此知识}
## 核心内容
{知识的主体内容，可以是 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 查询示例
# 示例：淘宝运营 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 创建规范
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 配置文件。