AgentsFlex：一个轻量的 Java AI 智能体开发框架。

Agents-Flex 专为 Java 工程师与架构师设计，提供轻量、模块化、可扩展的 AI 智能体开发体验，助力企业快速构建生产级 LLM 应用。

✨ 新增核心能力（v2.0+）

🔧 基础能力矩阵

🧠 模型接入        🔌 工具调用          📚 知识增强
├─ 主流大模型适配     ├─ Function Calling ├─ 多格式文档加载
├─ Ollama 本地部署   ├─ MCP 工具协议       ├─ 智能文本分割
├─ HTTP/SSE/WS 协议  ├─ 本地方法反射执行   ├─ 向量存储集成
├─ 多 Provider 管理  ├─ 执行拦截与监控     ├─ 自定义 Embedding

⚙️ 工程化支持      🔍 可观测性        🛡️ 企业级保障
├─ Prompt 模板引擎  ├─ OpenTelemetry 集成 ├─ 敏感信息脱敏
├─ 多轮记忆管理      ├─ 链路追踪与指标      ├─ 资源安全关闭
├─ 异步/流式响应     ├─ 结构化日志输出      ├─ Apache 2.0 协议

💡 设计原则：零侵入集成 · 接口驱动扩展 · 配置优于编码 · 生产环境友好

🚀 v2.0.0 正式版

📅 发布日期：2026-03-01

v2.0 是一次架构级升级版本。
本次版本全面升级为 Agent 开发框架，新增 Skills 模块、MCP 客户端体系、数据模块、流式能力增强，并完成核心 API 统一与大量重构优化。

✨ 核心架构升级

🔁 架构重构与模块调整

• 移除 Chain 模块（合并至 Tinyflow）
• 移除 documentParser 模块
• 移除 DocumentLoader 模块
• 新增 file2text 模块
• 新增 observability 模块
• 新增 agents-flex-data 数据模块
• 新增 demos 模块（含 helloworld 示例）
• 新增 skills 模块
• 新增 commons 模块（替代 shell 模块）

🧠 核心 API 统一命名

• LLM → ChatModel
• LLMClient → StreamClient
• LLMClientListener → StreamClientListener
• LLMConfig → ChatConfig
• Function → Tool
• PromptFormat → MessageFormat
• TextPromptTemplate → PromptTemplate
• TextPrompt → SimplePrompt
• HistoriesPrompt → MemoryPrompt
• 合并 HumanMessage 等为 UserMessage

🤖 Agent & Skills 能力增强

🧩 Skills 模块

• 新增 Skills 模块体系
• 新增 AI Tutor Skill（支持 YouTube Transcript）
• 新增 Tool 默认值支持
• 自动从 Enum 参数类型提取枚举值
• 增强泛型参数类型支持
• Parameter 默认类型设为 string
• 优化 ToolCall 合并逻辑
• 增强 MethodTool 类型解析能力
• 新增 AiMessage.hasToolCalls() 方法
• 优化 Tool 参数解析逻辑
• 简化 Prompt 与 MemoryPrompt API
• 增加 JSON 错误消息识别能力
• 增强 embedding 错误处理

🌐 MCP（Model Context Protocol）全面升级

🏗 MCP 架构能力

• 新增 MCP 客户端管理模块
• 新增 MCP Tool 集成实现
• 支持 MCP Tool 获取能力
• 支持客户端 Descriptor 与健康检查
• 新增 mcp-servers.json 配置支持
• McpRootConfig → McpConfig 重构
• 客户端类移动至独立包结构

🚚 多传输协议支持

• 新增 HTTP Transport 支持
• 新增 SSE Transport 支持
• 新增 Streamable Transport 支持
• Stdio Transport 支持环境变量
• 支持 HTTP SSE Header 自定义
• 移除硬编码 timeout
• 使用 DEFAULT_TRANSPORT_TYPE 常量替代 "stdio"
• 优化 JSON 映射与传输配置

🛡 MCP 稳定性增强

• 修复重复客户端注册资源泄露问题
• 优化异常处理机制
• 修复 null 与单文本工具调用问题
• 增强 MCP 工具调用异常处理

💬 Chat / Streaming 能力增强

🔄 流式处理优化

• 修复 final delta 处理问题
• 修复流式失败标记逻辑
• 优化增量消息合并逻辑
• 修复工具调用合并逻辑
• clearFullMessage → finalizeFullMessage
• 流完成后清理 full message
• 增加 stopped 标志位
• 优化 StreamClientListener 逻辑
• 优化 BaseStreamClientListener 停止逻辑

🧠 Thinking / Reasoning 支持

• 新增 thinking protocol 支持
• 动态协议检测
• 移除默认 thinking 协议处理
• 支持 reasoning 内容用于 tool message
• 支持 responseFormat 配置

🔧 ChatOptions 增强

• extra → extraBody
• 新增 includeUsage 支持
• 新增 ChatOptions thinking 支持
• 新增 embedding 维度与 user 支持
• 新增 JSON 错误识别

🧮 数据模块 & RAG

• 新增 JDBC 数据模块
• Tool 构建阶段初始化数据源表
• 新增 MarkdownHeaderSplitter（层级拆分）
• 新增 RAG 文档拆分能力
• 新增 Text2SQL 文档支持
• 新增数据 Demo 模块
• 优化 PDF 生成处理

🔍 Observability 可观测性

• 新增 OpenTelemetry SDK 复用检测
• 修复 propagator 检测逻辑
• 优化 SDK 注册检查

🔌 模型支持优化

• 修复 OpenAI top_k 不支持参数问题
• 修复 OpenAI JSON 解析异常
• 优化 OpenAIChatMessageSerializer
• 优化 Qwen 配置
• 移除 QwenChatOptions responseFormat
• 更新 Ollama 默认配置
• 修复阿里云向量失败提示
• 修复 ElasticSearch 检索失败问题
• 更新默认模型为 Qwen3.5-35B-A3B

⚙ 工具与工具链增强

• 新增高性能类型转换器
• 新增数字字符串校验方法
• 移除旧 converter 实现
• 增强 MethodTool 泛型解析
• 优化参数类型处理
• 新增 defaultValue 支持

🧪 测试增强

• 新增 MCP 单元测试
• 新增 Stream 测试工具类
• 新增 OpenAI 工具调用测试
• 移除不必要 sleep
• 增强 Stream 测试覆盖
• 新增 MDLMcpClientManager 单元测试

📚 文档升级

• README 全面重构（框架定位为 Agent 开发框架）
• 新增 Skills 文档
• 新增 MCP 集成指南
• 新增 ReAct Agent Prompt 文档
• 更新首页内容
• 更新 Chat 文档结构
• 更新 JDK 版本说明
• 更新 Embedding 文档翻译
• 新增 Text2SQL 文档导航

🛠 依赖与构建

• 使用 revision 统一依赖版本
• 更新 POI 依赖
• 移除 slf4j-simple
• 忽略 .env 文件
• 设置 Maven 编译为 Java 8
• 移除 mvn17.sh 脚本
• 更新版权至 2026

🐞 Bug 修复汇总

• 修复参数数组 null 导致 NPE
• 修复请求 header null 检查
• 修复工具调用合并异常
• 修复 embedding 模块打包问题
• 修复重复 MCP 注册资源泄露
• 修复 JSON 解析异常
• 修复流式失败标记处理
• 修复向量数据库失败提示
• 修复 ElasticSearch 检索问题
• 修复 OpenTelemetry 注册检测

🎯 v2.0 版本定位

v2.0 不再是简单的 LLM 封装框架，而是：

🧠 一个面向 Agent 构建、MCP 集成、Tool 编排、数据接入、流式处理 的完整 AI 智能体开发框架。

核心能力包括：

• 完整 Tool & Skills 体系
• MCP 多协议支持（stdio / http / sse）
• 强化 Streaming 处理
• 数据与 RAG 原生支持
• Thinking / Reasoning 协议支持
• 高可观测性

开发文档：

• 快速开始:  https://agentsflex.com/zh/chat/getting-started.html
• ChatModel:  https://agentsflex.com/zh/chat/chat-model.html
• ChatConfig:  https://agentsflex.com/zh/chat/chat-config.html
• 对话拦截器:  https://agentsflex.com/zh/chat/chat-interceptor.html
• 对话上下文:  https://agentsflex.com/zh/chat/chat-context.html
• Prompt 提示词:  https://agentsflex.com/zh/chat/prompt.html
• 提示词模板:  https://agentsflex.com/zh/chat/prompt-template.html
• Message 消息:  https://agentsflex.com/zh/chat/message.html
• Memory 记忆:  https://agentsflex.com/zh/chat/memory.html
• Tool 工具调用:  https://agentsflex.com/zh/chat/tool.html
• Tool 拦截器:  https://agentsflex.com/zh/chat/tool-interceptor.html
• MCP 开发文档:  https://agentsflex.com/zh/chat/mcp.html
• Skills 开发文档：https://agentsflex.com/zh/chat/skills.html
• 智能问数（Text2Sql）开发文档: https://agentsflex.com/zh/chat/data.html
• ChatClient:  https://agentsflex.com/zh/chat/chat-client.html
• ChatRequestSpecBuilder:  https://agentsflex.com/zh/chat/chat-request-spec-builder.html
• ChatMessageSerializer:  https://agentsflex.com/zh/chat/chat-message-serializer.html
• AiMessageParser:  https://agentsflex.com/zh/chat/ai-message-parser.html
• 大模型错误重试:  https://agentsflex.com/zh/chat/retry.html
• 大模型日志:  https://agentsflex.com/zh/chat/logger.html
• ReAct Agent 智能体:  https://agentsflex.com/zh/agent/react-agent.html
• Routing Agent（多智能体路由）:  https://agentsflex.com/zh/agent/routing-agent.html
• Rerank 重排模型:  https://agentsflex.com/zh/models/rerank.html
• Embedding 重排模型:  https://agentsflex.com/zh/models/embedding.html
• RAG 文档概念:  https://agentsflex.com/zh/rag/document.html
• 向量存储 (Vector Store):  https://agentsflex.com/zh/rag/vector-store.html
• SearchWrapper:  https://agentsflex.com/zh/rag/search-wrapper.html
• file2text:  https://agentsflex.com/zh/rag/file2text.html
• 文档分割 Splitter:  https://agentsflex.com/zh/rag/splitter.html
• 搜索引擎:  https://agentsflex.com/zh/rag/search-engine.html
• Observability 可观测:  https://agentsflex.com/zh/observability/observability.html
• 模型可观测:  https://agentsflex.com/zh/observability/model.html
• 工具调用可观测:  https://agentsflex.com/zh/observability/tool.html
• Maps 工具类:  https://agentsflex.com/zh/util/maps.html
• Retryer 工具类:  https://agentsflex.com/zh/util/retryer.html
• ToolScanner 工具类:  https://agentsflex.com/zh/util/tool-scanner.html
• Tool.Builder 工具类:  https://agentsflex.com/zh/util/tool-builder.html
• LocalTokenCounter 工具类:  https://agentsflex.com/zh/util/local-token-counter.html
• 其他工具类:  https://agentsflex.com/zh/util/others.html
• v1.x 升级:  https://agentsflex.com/zh/other/v1-upgrade.html
• 工作流编排:  https://agentsflex.com/zh/other/chain.html

源码下载

• Gitee：https://gitee.com/agents-flex/agents-flex
• Github：https://github.com/agents-flex/agents-flex