SuperBizAgent-java/mvp/issues/rag/rag-spring-ai-advisor-boundary.md

RAG 明确 Spring AI Advisor 与 Agent Tool 的边界

状态：待规划
严重程度：中
发现时间：2026-07-05
范围：Agent 编排、RAG Advisor、工具调用可观测性

---

背景

Spring AI 提供 QuestionAnswerAdvisor、RetrievalAugmentationAdvisor 等 RAG Advisor 能力，可以把检索增强直接挂到模型调用流程中。

但当前项目是 Agent 工程项目，知识检索不是普通聊天增强，而是 Agent 在诊断流程中显式调用的工具。系统还依赖 tool_invocation 记录检索事实，用于 evidence score 和诊断追踪。

---

问题

如果直接把 RAG 全部迁到 Advisor，可能会损失当前项目已有的显式工具链路：

1. Agent 是否调用知识库不够透明。
2. tool_invocation 记录可能变弱。
3. AIOps 诊断步骤和知识证据之间的对应关系不清晰。
4. 面试项目中“Agent 如何使用工具”的展示价值下降。

---

改造方向

不要把 lookup_knowledge 完全替换成隐式 Advisor，而是分层使用：

Agent Tool 层：
  lookup_knowledge
  sessionId
  traceId
  tool_invocation
  evidence score

Spring AI RAG 层：
  query transformer
  retriever
  vector store
  document post processor

也就是说，Advisor / Retriever 可以作为工具内部实现，而不是取代工具本身。

---

验收标准

• Agent 仍然通过显式 lookup_knowledge 使用知识库。
• Spring AI RAG 能力被封装在工具内部或服务内部。
• 每次检索仍能落 tool_invocation。
• Chat / AIOps 两条链路都能追踪检索输入、输出和证据来源。

---

相关文件

• src/main/java/com/superbiz/agent/tool/LookupKnowledgeTool.java
• src/main/java/com/superbiz/agent/service/ChatService.java
• src/main/java/com/superbiz/agent/service/AiOpsService.java
• src/main/java/com/superbiz/agent/service/ToolInvocationRecorder.java