Files
aiagent/docs/zhini-kefu/知你客服17号能力文档.md

59 lines
2.0 KiB
Markdown
Raw Normal View History

2026-04-13 22:52:36 +08:00
# 知你客服 17 号 · 能力说明(C:主动排障闭环执行)
## 定位
在 **知你客服15号**(可持续多步工具执行)基础上,增加 **C 能力**:
遇到问题时优先主动完成「**自检 → 执行 → 验证 → 补救**」闭环,而不是停留在“我去检查一下”。
## 核心增强
1. **主动自检**
- 任务开始先确认必要前提(工作区、目标路径、文件是否存在、输入是否完整)。
2. **主动执行**
- 明确调用工具推进,不只给计划语句。
3. **结果验证**
- `file_write` 后强制回读或关键字段校验,避免“说已写入但未落盘”。
4. **失败补救**
- 单步失败时至少尝试 1-2 个替代方案(路径、文件名、编码、模式)。
5. **最小化追问**
- 仅在确实缺少关键输入时才向用户追问;否则优先自助完成。
## 工具策略
- 默认本地闭环:`system_info`、`file_read`、`file_write`、`text_analyze`、`json_process`。
- `http_request` 仅在用户明确要求联网或本地信息不足时使用。
- `database_query` 仅允许 `SELECT`。
- 古文/常识续写(如《三字经》补全)优先直接生成并落盘,不依赖联网。
## 运行参数
- `llm-unified.max_tool_iterations = 22`(默认)。
- 工具列表与 15 号一致(全量内置工具)。
## 创建/更新脚本
```text
backend/scripts/create_zhini_kefu_17.py
```
用法:
```powershell
cd backend
.\venv\Scripts\python.exe scripts/create_zhini_kefu_17.py
```
环境变量:
- `PLATFORM_BASE_URL`(默认 `http://127.0.0.1:8037`)
- `PLATFORM_USERNAME`(默认 `admin`)
- `PLATFORM_PASSWORD`(默认 `123456`)
- `SOURCE_AGENT_NAME`(默认 `知你客服15号`)
- `TARGET_NAME`(默认 `知你客服17号`)
## 验收建议
1. 让 17 号执行“创建并写入文件,再读回验证”的任务。
2. 让 17 号执行“已有文件续写并覆盖指定段落”的任务。
3. 构造轻微异常(路径不规范、文件已存在)确认其会主动补救而非直接停住。