关键词：LangChain4j 1.4.0、Agentic、MCP、工具并发、多模态、Java AI

---

🔥 一、版本概览

2024 年 8 月 28 日，LangChain4j 发布 1.4.0 正式版 与 1.4.0-beta10，由 @dliubarskyi 发布。
本次更新聚焦 Agentic 能力增强、MCP 流式传输、工具并发执行、多模态支持 等核心特性，同时引入 watsonx.ai 等新集成，并修复大量社区反馈问题。

---

🧠 二、核心新特性详解

✅ 1. Agentic：声明式 API 大幅增强

• PR #3587：补充缺失特性，支持更复杂的代理流程定义
• PR #3602：允许在返回前干预 supervisor 输出，实现更灵活的代理控制逻辑
• PR #3533：支持通过 builder 传入系统消息，提升代理可配置性
• PR #3594：支持程序化定义代理名称与描述，便于动态创建代理

✅ 2. MCP（Model Context Protocol）：支持流式 HTTP 传输

• PR #3534：MCP 支持 Streamable HTTP Transport，实现低延迟、高吞吐的上下文传输
• PR #3494：McpToolExecutor 可脱离 McpToolProvider 单独使用，模块解耦更彻底
• PR #3578：支持清除或禁用工具列表缓存，提升调试效率
• PR #3570：支持自定义 SSE 请求头，适配企业级网关

✅ 3. AI Service：工具并发执行与异常处理

• PR #3512：支持并发执行多个工具调用，显著降低响应延迟
• PR #3069：支持工具立即返回值，无需等待整个流程结束
• PR #3536：引入 工具参数校验器 与 工具执行异常处理器，提升健壮性（⚠️ 为 Breaking Change）

✅ 4. 多模态支持（Multimodality）

• PR #3420：AI Service 支持图文混合输入，适配 GPT-4V、Claude-3V 等视觉模型
• 支持 ImageContent 与 TextContent 混合构造 UserMessage，实现图+文问答

✅ 5. 结构化输出增强

• PR #3374：支持原始 JSON Schema 元素，无需定义 Java Bean 即可结构化输出
• 适用于动态 schema、前端表单生成等场景

---

🔌 三、新增集成模块

集成模块	贡献者	描述
watsonx.ai	@andreadimaio	IBM 企业级模型全面接入，支持 WatsonxChatModel 与 WatsonxEmbeddingModel
Azure OpenAI	@SandraAhlgrimm	支持 音频转写模型，如 whisper-1
Anthropic	@HamzaElzarw-2022	支持 Token 用量统计，优化成本控制

---

⚠️ 四、Breaking Changes 一览

变更点	影响	迁移建议
工具参数与异常处理器引入（#3536）	自定义工具需实现新接口	使用 @Tool 方法时添加 ToolExecutionErrorHandler
Agentic API 增强（#3587）	原有代理定义可能失效	检查 Agentic 注解使用方式，参考官方示例
默认线程池改为虚拟线程池（#3541）	自定义线程策略需调整	如需平台线程，手动传入 ExecutorService

---

🔧 五、其他实用优化

功能	描述
日志可配置化	支持自定义请求/响应日志级别（#3561、#3601）
Spring Boot 3.4 支持	原生镜像编译速度提升 30%
Azure CosmosDB NoSQL	支持 Sharded DiskANN、Content Retriever Store、Memory Store（#3463）
Playwright 升级至 1.54.0	提升 Web 数据抓取稳定性
安全性修复	升级 GitHub API、Vespa、Jetty 等依赖，修复多个 CVE

---

📦 六、快速升级指南

Maven 依赖

<dependency>
  <groupId>dev.langchain4j</groupId>
  <artifactId>langchain4j</artifactId>
  <version>1.4.0</version>
</dependency>

尝鲜 beta

<version>1.4.0-beta10</version>

升级 checklist

• 检查是否使用 Agentic 注解，验证新 API 兼容性
• 若自定义工具，添加 ToolExecutionErrorHandler
• 若使用线程池，确认虚拟线程行为是否符合预期
• 若使用 MCP，验证 SSE 流式传输是否正常

---

🧪 七、一行代码体验新特性

✅ 工具并发执行

@Tool("查询天气")
String weather(@P("城市") String city) { ... }

@Tool("查询汇率")
String rate(@P("货币") String currency) { ... }

String ans = aiService.chat("北京天气和美元汇率？");
// 两个工具并发调用，耗时 < 500ms

✅ 多模态输入

UserMessage msg = UserMessage.from(
    TextContent.from("这张图里有什么？"),
    ImageContent.from("https://example.com/cat.jpg")
);
String ans = model.generate(msg);

---

📌 八、总结一句话

LangChain4j 1.4.0 = Agentic 更智能、MCP 更流畅、工具更并发、多模态更全能，Java 原生 AI 开发正式迈入“工程级”时代！

---