67 lines
1.9 KiB
Markdown
67 lines
1.9 KiB
Markdown
# 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，而是分层使用：
|
||
|
||
```text
|
||
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`
|