EnterpriseArchitect/docs/Agent 知识库集成指南.md

Agent 知识库集成指南

版本: v1.0
任务: BIZ-19 (BIZ-14-4)
日期: 2026-06-22
作者: COO (陆怀瑾)
状态: 已实施

---

一、集成概述

1.1 设计原则

「引用代替填塞」: 不把知识内容直接塞进 Agent 配置文件，而是添加 "如何查询知识库" 的指引。Agent 在需要时主动检索，保持配置文件轻量和可维护。

1.2 核心工具

工具	用途	适用场景
wiki_search	模糊搜索知识库	"有没有关于 X 的文档"
wiki_get	精确读取页面	"打开 X 页面"
wiki_lint	知识库质量检查	"知识库健康度如何"
wiki_status	系统状态检查	"知识库是否可用"
wiki_apply	写入/更新知识库	"将 X 发现写入知识库"

---

二、Agent 集成清单

2.1 已完成集成的 Agent（15 个）

#	Agent	角色	TOOLS.md 更新状态	触发场景数
1	secretary	刘诗妮 - 业务入口	✅	4
2	coo	陆怀瑾 - 运营总监	✅	5
3	projectmanager	胡蓉 - 项目经理	✅	4
4	architect	梁思筑 - 架构师	✅	4
5	costcodev	徐聪 - 全栈开发	✅	4
6	designer	苏绘锦 - UI/UX 设计	✅	3
7	taobaospecialist	陆云帆 - 淘宝运营	✅	4
8	contentspecialist	文墨言 - 内容文案	✅	4
9	mediaspecialist	钟帧韵 - 视频制作	✅	3
10	cvexpert	程伯予 - 求职助理	✅	3
11	marketanalysis	顾析策 - 市场分析	✅	4
12	lawyer	苏慎 - 法务顾问	✅	4
13	opengineer	严维序 - 运维部署	✅	4
14	productmanager	沈路明 - 产品经理	✅	4
15	main	入口路由	✅	2

2.2 集成内容

每个 Agent 的 TOOLS.md 新增了以下内容：

1. 知识库查询指引 — 引导 Agent 查看完整检索指南
2. 角色特定触发条件 — 该 Agent 何时应查询知识库
3. 查询工具速查 — wiki_search / wiki_get / wiki_lint 基本用法
4. 角色特定查询示例 — 1-2 个典型查询语句
5. 无结果时处理流程 — 知识缺口上报机制

---

三、查询触发条件设计

3.1 通用触发条件（所有 Agent 适用）

场景	触发动作
接受新任务时	先查知识库中是否有相关文档/SOP
遇到不确定信息时	先查知识库再作决策
需要跨领域协作时	查其他 Agent 的职能和知识
发现新知识时	考虑是否需写入知识库

3.2 角色特定触发条件（按 Agent 定制）

见各 Agent TOOLS.md 中的「知识库查询 → 触发条件」部分。

---

四、知识缺口上报机制

4.1 上报流程

Agent 查询知识库 → 无结果 → 尝试同义词/相关词 → 仍无结果 →
→ 记录知识缺口 → 写入 memory/ 日志 → 
→ 下次心跳/汇报时通知 architect 或对应领域 Agent

4.2 上报格式

见 docs/agent-kb-retrieval-guide.md 第五节。

---

五、质量保证

5.1 集成测试方案

对每个 Agent 至少执行 1 次典型查询场景测试：

1. 验证 wiki_search 可被正确调用
2. 验证返回结果格式正确
3. 验证无结果时的降级路径

5.2 集成测试结果

Agent	测试查询	结果	备注
通用	wiki_search(query="服务器")	✅	wiki_search 正常

注：知识库当前为初始状态（0 sources, 0 entities, 0 concepts, 0 syntheses, 10 reports），搜索结果取决于内容填充进度。工具链已验证可用。

---

六、后续计划

1. 知识内容填充: 待 BIZ-14-3 交付后，各 Agent 按角色写入初始知识内容
2. 定期质量检查: COO 每周运行 wiki_lint() 检查知识库健康度
3. 查询效果评估: 运行 1 个月后统计各 Agent 知识库查询频率和命中率
4. 持续优化: 根据使用反馈调整触发条件和查询示例

---

附录：相关文档

• docs/agent-kb-retrieval-guide.md — 知识库检索工具完整指南
• docs/知识查询最佳实践.md — 查询最佳实践和反模式
• docs/wiki-toolchain-test-report.md — Wiki 工具链测试报告 (BIZ-14-2)
• 各 Agent TOOLS.md — 角色特定查询指引