# 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 配置文件。