feat(modelprovider): 完善模型调用与RAG召回支撑

AGENT.md

@@ -11,8 +11,8 @@
 - 文件上传与附件管理
 - 前后端统一的管理控制台
 
-当前阶段已经完成平台骨架、公共接口规范、知识库/知识文档管理、文档上传、文档解析、解析快照与手动切片入口。
-后续重点从"文档可切片"推进到"向量可检索"、"模型可路由"和"Agent 可运行"。
+当前阶段已经完成平台骨架、公共接口规范、知识库/知识文档管理、文档上传、文档解析、解析快照、手动切片入口、模型平台基础配置与 Agent 定义管理/调试入口。
+后续重点从"文档可切片"推进到"向量可检索"、"模型可路由"和"Agent 运行时可编排"。
 
 ## 2. 总体设计思路
 
@@ -74,18 +74,24 @@
 
 ### 3.3 Agent 运行模块
 
-后续平台重点能力，建议逐步补齐：
+当前已落地最小可用能力：
 
-- Agent 定义
-- Prompt 模板
-- 工具注册与调用
-- 会话上下文与记忆
-- 执行日志与任务状态
+- `agent_definition`：Agent 定义管理（CRUD、编码唯一校验、知识库绑定校验）
+- Agent 管理接口：`/api/agents/list`、`/api/agents/query`、`/api/agents/detail`、`/api/agents/save`、`/api/agents/delete`
+- Agent 调试接口：`POST /api/agents/{agentId}/chat`，支持普通对话与 RAG 对话两种模式
+- Agent 调试链路：用户问题向量化 -> `rag_chunk_embedding` 相似度召回 -> 组装上下文 -> Chat 模型回答 -> 返回引用切片
+- 统一模型调用日志：通过 `ChatModelGateway` 与 `model_call_log` 记录请求 ID、模型、耗时与 token 信息
+
+后续平台重点能力：
+
+- Prompt 模板管理
+- 会话上下文持久化与记忆
+- 工具注册与调用协议
+- 执行任务状态与日志
 - 多步骤编排
 
-建议未来增加的核心对象：
+建议后续补齐的核心对象：
 
-- `agent_definition`
 - `agent_session`
 - `agent_message`
 - `agent_task`
@@ -104,6 +110,8 @@
 - 知识库管理页（完整 CRUD + 概览卡片 + 双栏详情 + 批量上传入口）
 - 知识文档页（条件查询 + 批量上传 + 解析重试 + 批量切片 + 编辑/启停用/删除）
 - 切片任务页（解析成功/失败文档概览与切片入口）
+- Agent 管理页（Agent 定义管理与知识库绑定）
+- Agent 调试页（普通对话 / RAG 对话切换、引用切片回显）
 
 前端技术要点：
 
@@ -125,7 +133,7 @@
 - 附件管理页面前端联调
 - RAG 检索配置、向量索引任务和最近任务页面联调
 - 模型服务商、模型配置、路由规则和调用日志管理
-- Agent 调试页
+- Agent 会话历史与运行日志页
 - 执行日志查看
 
 ## 4. 当前接口设计原则
@@ -219,7 +227,7 @@
 5. ~~接入切片生成与切片持久化~~（已完成定长/分隔符切片与手动切片入口）
 6. 建设模型服务商配置与模型路由层
 7. 接入 Embedding / Chat 模型并完成向量写入
-8. 建立 Agent 运行时骨架
+8. 完善 Agent 运行时骨架（会话、工具、任务）
 9. ~~补前端控制台基础骨架~~（已完成，部分高级页面待联调）
 
 剩余重点：
@@ -227,17 +235,17 @@
 - 完成模型服务商配置、模型配置、路由规则和调用日志基础能力
 - 接入 Embedding，生成并保存 `rag_chunk_embedding`
 - 补齐索引任务、重试、重建索引和最近任务接口
-- 接入 OpenAI-compatible / Spring AI 适配层并实现最小模型调用链路
+- 扩展 Agent 会话、工具调用与任务编排能力
 
 ## 7. 下一步建议
 
 结合当前代码状态，接下来建议重点做：
 
-- 实现模型服务商和模型配置表：支持 Ollama、硅基流动、百炼等 OpenAI-compatible 来源
-- 实现 Embedding 网关：对已落库切片调用 Embedding 模型并写入 `rag_chunk_embedding`
+- 完成 RAG 全量向量化链路，确保知识库可稳定召回
+- 为 Agent 调试链路补齐会话持久化与多轮上下文管理
+- 建立 Agent 工具注册与调用协议，沉淀最小工具集
 - 把 `indexStatus` 从手工字段推进为真实状态流转
 - 补齐重建索引、失败重试、最近任务接口和前端展示
-- 接入模型路由，实现本地小模型与云端大模型的成本优先调用链路
 
 ## 8. 文档用途说明