130 lines
4.3 KiB
Markdown
130 lines
4.3 KiB
Markdown
# 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 — 角色特定查询指引 |