refactor(ai-ops): 优化 lookup_knowledge 工具描述和 Executor Prompt

## 主要改动

1. 优化工具描述(中等版)
   - 保留 L0/L1 两阶段检索机制说明
   - 增加适用场景列举(错误码、接口文档、排障步骤等)
   - 简化为核心信息,减少 token 消耗

2. Executor Prompt 新增详细使用说明
   - 添加 lookup_knowledge 返回结果字段说明
   - 提供 confidence 和 match_type 的使用建议
   - 明确 found=false 的处理方式
   - 结构化组织:工具选择 → 结果处理 → 执行反馈

## 设计思路

- 工具描述:简洁,快速理解核心用途
- Executor Prompt:详细,指导正确使用
- 分层设计:减少重复信息,降低 token 消耗
This commit is contained in:
zhuyongxin
2026-06-24 18:48:04 +08:00
parent 463d8b817b
commit c88b287f83
2 changed files with 22 additions and 2 deletions
@@ -30,8 +30,9 @@ public class LookupKnowledgeTool {
* @param query 查询关键词
* @return 查询结果
*/
@Tool(description = "查询知识库文档。优先精确匹配关键词,未命中或多个匹配时自动补充语义相关片段。" +
"参数 query: 查询关键词,例如 'ERR_TIMEOUT'、'支付网关超时'")
@Tool(description = "查询内部知识库文档。采用两阶段检索:L0 精确匹配关键词(< 10ms),L1 语义检索补充(200-500ms)。" +
"支持查询错误码定义、接口文档、排障步骤、配置说明等。" +
"参数 query: 查询关键词或描述,例如 'ERR_TIMEOUT'、'支付超时排查'")
public LookupResult lookupKnowledge(String query) {
// 生成请求ID用于追踪
String requestId = java.util.UUID.randomUUID().toString().substring(0, 8);