160 lines
5.1 KiB
Markdown
160 lines
5.1 KiB
Markdown
# SOP-016：执行前检索 SOP 强制规则
|
||
|
||
> **版本**: v1.0
|
||
> **起草人**: 胡蓉（projectmanager）
|
||
> **批准人**: 刘炜承
|
||
> **生效日期**: 2026-07-06
|
||
> **关联 Issue**: BIZ-81
|
||
|
||
---
|
||
|
||
## 1. 目的
|
||
|
||
解决 BIZ-45 巡检发现的 Agent 知识库调用率极低问题（徐聪 0%、诗妮 0%、沈路明 33%）。知识库已建立 SOP 但 Agent 不主动检索，导致重复造轮子、忽略历史经验、决策缺乏依据。
|
||
|
||
---
|
||
|
||
## 2. 适用范围
|
||
|
||
全部 Agent（产研线 + 运营线 + 职能线），共 14 个。
|
||
|
||
---
|
||
|
||
## 3. 触发条件（任一触发即必须检索）
|
||
|
||
| # | 触发场景 | 说明 |
|
||
|---|----------|------|
|
||
| 1 | 接收新任务 | WorkBoard 认领 / Multica Issue / TODO.md 分派 / session_send 任务 |
|
||
| 2 | 任务涉及已知业务领域 | 开发/部署/运营/设计/内容/法务/市场等 |
|
||
| 3 | 需要技术选型、流程设计、资源分配决策 | 需参考历史方案 |
|
||
| 4 | 遇到不确定如何处理的问题 | 需查找是否有 SOP 或历史经验 |
|
||
|
||
---
|
||
|
||
## 4. 检索流程（严格执行）
|
||
|
||
```
|
||
开始任务
|
||
↓
|
||
Step 1: memory_search(corpus=all, query="<业务类型> SOP/历史经验")
|
||
↓
|
||
Step 2: 如有匹配 → memory_get / wiki_get 读取详细内容
|
||
↓
|
||
Step 3: 如无匹配 → wiki_search(query="<任务关键词>")
|
||
↓
|
||
Step 4: 仍无匹配 → exec curl 思源知识库全文搜索
|
||
↓
|
||
Step 5: 根据检索结果调整执行方案
|
||
↓
|
||
开始执行任务
|
||
```
|
||
|
||
### 查询构造规范
|
||
|
||
- **SOP 查询**: `memory_search(corpus=all, query="<业务类型> SOP")`
|
||
- 示例：`memory_search(corpus=all, query="项目拆解 SOP")`
|
||
- 示例：`memory_search(corpus=all, query="部署运维 SOP")`
|
||
|
||
- **历史经验查询**: `memory_search(corpus=all, query="<项目名> 决策/问题/方案")`
|
||
- 示例：`memory_search(corpus=all, query="知识库选型 决策")`
|
||
- 示例：`memory_search(corpus=all, query="Agent 任务积压 问题")`
|
||
|
||
- **结构化知识查询**: `wiki_search(query="<主题>")`
|
||
- 示例：`wiki_search(query="项目管理规范")`
|
||
|
||
- **思源知识库全文搜索**:
|
||
```bash
|
||
curl -s -X POST "http://192.168.1.99:6806/api/search/fullTextSearchBlock" \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Token 8ixgqexbnxgibk4u" \
|
||
-d '{"query":"<关键词>", "notebook":"20260623155217-njb0mkn"}'
|
||
```
|
||
|
||
---
|
||
|
||
## 5. 跳过条件（仅以下情况可跳过检索）
|
||
|
||
| # | 跳过场景 | 原因 |
|
||
|---|----------|------|
|
||
| 1 | 简单重复性任务 | 如"重启容器""发送消息"——已知操作无需检索 |
|
||
| 2 | 紧急故障处理 | 先止损，事后补检索 |
|
||
| 3 | 用户明确指示 | "不需要检索历史" |
|
||
| 4 | 纯闲聊/问候 | 无业务内容 |
|
||
|
||
---
|
||
|
||
## 6. 审计指标
|
||
|
||
### 月度检查项
|
||
|
||
| 指标 | 目标 | 检查方式 |
|
||
|------|------|----------|
|
||
| 检索覆盖率 | ≥80% | 对比有检索记录的任务数 / 总执行任务数 |
|
||
| query 相关性 | query 与任务内容匹配 | 抽查 query 与任务 brief 的关键词重合度 |
|
||
| 执行方案调整率 | 有检索的任务中 ≥30% 有方案调整 | 检查检索后是否在 notes/评论中记录调整 |
|
||
| 零检索执行 | <20% | 无检索记录直接执行的任务占比 |
|
||
|
||
### 纳入 Agent 行为审计
|
||
|
||
- ✅ 任务执行前有检索记录（memory_search / wiki_search 调用日志）
|
||
- ✅ 检索 query 与任务相关性强
|
||
- ✅ 根据检索结果调整了执行方案
|
||
- ❌ 无任何检索直接执行（除非符合跳过条件）
|
||
- ❌ 检索 query 过于笼统（如单字查询）
|
||
|
||
### 审计由 COO 月度执行
|
||
|
||
COO（陆怀瑾）每月 1 日检查上月全部 Agent 的检索执行情况，输出审计报告。
|
||
|
||
---
|
||
|
||
## 7. AGENTS.md 注入模板
|
||
|
||
各 Agent 的 AGENTS.md 中需注入以下章节：
|
||
|
||
```markdown
|
||
## ⚠️ 执行前检索 SOP（强制规则）
|
||
|
||
> **BIZ-81 要求**：任务执行前必须先检索知识库，避免重复造轮子、忽略历史经验。
|
||
|
||
### 触发条件
|
||
以下情况**必须**执行检索（任一触发）：
|
||
- 接收到新任务（WorkBoard/Multica/TODO.md 认领）
|
||
- 任务涉及已知业务领域
|
||
- 需要做出技术选型、流程设计、资源分配决策
|
||
- 遇到不确定如何处理的问题
|
||
|
||
### 检索流程
|
||
Step 1: memory_search(corpus=all, query="任务关键词 SOP/历史经验")
|
||
Step 2: 如有匹配 → memory_get / wiki_get 读取详细内容
|
||
Step 3: 如无匹配 → wiki_search(query="任务关键词")
|
||
Step 4: 根据检索结果调整执行方案
|
||
→ 开始执行任务
|
||
|
||
### 跳过条件
|
||
- 简单重复性任务（如"重启容器""发送消息"）
|
||
- 紧急故障处理（先止损，事后补检索）
|
||
- 用户明确指示"不需要检索历史"
|
||
|
||
### 审计指标
|
||
以下行为将纳入 Agent 执行质量审计：
|
||
- ✅ 任务执行前有检索记录
|
||
- ✅ 检索 query 与任务相关性强
|
||
- ✅ 根据检索结果调整了执行方案
|
||
- ❌ 无任何检索直接执行（除非符合跳过条件）
|
||
- ❌ 检索 query 过于笼统
|
||
```
|
||
|
||
---
|
||
|
||
## 8. 生效与维护
|
||
|
||
- **生效日期**: 2026-07-06
|
||
- **维护人**: 胡蓉（projectmanager）
|
||
- **revision 周期**: 每季度 review 一次，根据审计数据调整检索流程
|
||
- **下次 review**: 2026-10-06
|
||
|
||
---
|
||
|
||
*本 SOP 由 projectmanager 胡蓉起草，经刘炜承批准后生效。*
|