commit

devflow/glossary/CONTEXT.md

@@ -0,0 +1,29 @@
+# 上下文词汇表
+
+## 术语
+
+### ChatModel
+- 定义：Spring AI 的聊天模型抽象接口，所有 LLM 提供商（DashScope、OpenAI、Ollama 等）都实现此接口
+- 使用场景：所有需要 LLM 推理/生成回答的代码应面向此接口编程
+
+### EmbeddingModel
+- 定义：Spring AI 的文本向量化抽象接口，将文本转换为向量
+- 使用场景：RAG 流程中将文档文本转为向量存入 Milvus
+
+### DashScopeChatModel
+- 定义：DashScope（阿里云）对 ChatModel 的具体实现
+- 使用场景：当前项目硬编码使用，需要改为通过 ChatModel 接口引用
+
+### ReactAgent
+- 定义：Spring AI Alibaba Agent Framework 的反应式 Agent 实现
+- 使用场景：Planner-Executor-Replanner 多 Agent 协作
+
+### Spring AI Alibaba Agent Framework
+- 定义：基于 Spring AI 的多 Agent 协作框架，提供 ReactAgent、PlannerAgent、ExecutorAgent 等
+- 使用场景：项目核心 Agent 逻辑，ReactAgent.builder().model() 接受 ChatModel 接口
+
+## 业务规则
+
+- ChatModel 是唯一 LLM 调用抽象：替换模型只需更换 Spring Boot starter 和配置
+- EmbeddingModel 是唯一向量化抽象：替换向量模型只需更换 starter 和配置
+- ReactAgent 已兼容 ChatModel 接口，不绑定 DashScope