 zhuyongxin
|
f002571629
|
refactor(ai-ops): 增强 lookup_knowledge 工具描述并调整工具优先级
## 主要改动
1. 增强 lookup_knowledge 工具描述
- 参考 queryLogs 的详细描述格式
- 添加 IMPORTANT 关键词强调优先使用场景
- 详细列举 4 种查询场景及示例：
* 错误码定义（ERR_TIMEOUT）
* 接口文档（payment-gateway）
* 排障步骤（支付超时排查）
* 配置说明（HikariCP）
- 保留性能优势说明（L0 < 10ms, L1 200-500ms）
2. 调整工具数组顺序
- 将 lookupKnowledgeTool 提前到第 2 位（仅次于 dateTimeTools）
- Mock 模式顺序：dateTimeTools → lookupKnowledgeTool → queryMetricsTools → queryLogsTools
- 真实模式顺序：dateTimeTools → lookupKnowledgeTool → queryMetricsTools → internalDocsTools
- 弃用工具（internalDocsTools）放在最后
## 设计目标
解决 Executor 优先选择 queryLogsTools 的问题：
- 工具描述对等：lookup_knowledge 与 queryLogs 同等详细
- 位置优先：知识库查询排在日志查询之前
- 明确引导：IMPORTANT 关键词强调使用时机
## 预期效果
Executor 在遇到错误码、配置项、排障问题时，应优先调用 lookup_knowledge，
而不是直接查询日志。
|
2026-06-25 09:55:02 +08:00 |
|
|
zhuyongxin
|
c88b287f83
|
refactor(ai-ops): 优化 lookup_knowledge 工具描述和 Executor Prompt
## 主要改动
1. 优化工具描述（中等版）
- 保留 L0/L1 两阶段检索机制说明
- 增加适用场景列举（错误码、接口文档、排障步骤等）
- 简化为核心信息，减少 token 消耗
2. Executor Prompt 新增详细使用说明
- 添加 lookup_knowledge 返回结果字段说明
- 提供 confidence 和 match_type 的使用建议
- 明确 found=false 的处理方式
- 结构化组织：工具选择 → 结果处理 → 执行反馈
## 设计思路
- 工具描述：简洁，快速理解核心用途
- Executor Prompt：详细，指导正确使用
- 分层设计：减少重复信息，降低 token 消耗
|
2026-06-24 18:48:04 +08:00 |
|
|
zhuyongxin
|
d6229f3385
|
feat(knowledge): 完成 L0+L1 混合检索集成
核心功能：
- 新增 FrontmatterParser 解析 YAML frontmatter
- 新增 KnowledgeIndexService L0 内存索引
- 新增 LookupKnowledgeTool 混合检索工具
- 增强 DocumentManagementService 文件保存和索引同步
技术实现：
- 数据库迁移 V004: api_document.metadata (TEXT)
- 依赖新增: snakeyaml 2.0
- 配置新增: knowledge.base-path
- 可观测性: requestId 追踪 + 性能日志
质量保证：
- 单元测试: 31/31 通过
- 测试覆盖: FrontmatterParser(11), KnowledgeIndexService(13), LookupKnowledgeTool(7)
- 启动验证: L0 索引正常加载
归档文档：
- OpenSpec: openspec/changes/lookup-knowledge-integration/
- devflow 档案: devflow/projects/2026-06-24-lookup-knowledge-integration/
- handoff: handoff/2026-06-24-lookup-knowledge-integration.md
|
2026-06-24 16:07:10 +08:00 |
|
|
zhuyongxin
|
c3a232540a
|
refactor(phase1): 完成包名重构 (org.example → com.superbiz.agent)
Task 4.1: 包名统一重构
- 重命名 41 个 Java 文件的包名
- 更新所有 import 语句
- 恢复枚举类（FaultCategory、DiagnosisStatus、SourceType）
- 更新测试类的 import
重构范围：
- domain/entity: 3 个实体类
- domain/model: 2 个数据类
- domain/enums: 3 个枚举类
- repository: 3 个接口
- service/session: 2 个类（接口 + 实现）
- config: 9 个配置类
- controller: 2 个控制器
- agent/tool: 4 个工具类
- client: 1 个客户端
- Main.java: 主类
验证结果：
- 编译成功，无错误
- 所有测试通过 (27/27)
- ApiDocumentRepositoryTest: 7/7 ✅
- CaseLibraryRepositoryTest: 6/6 ✅
- DiagnosisRecordRepositoryTest: 6/6 ✅
- RedisSessionManagerTest: 8/8 ✅
Progress: 21/33 tasks completed (64%)
|
2026-06-23 14:56:04 +08:00 |
|