开放人工智能的 java 开发工具包 4.108.0,主要面向需要配置实时会话外部工具、或处理托管智能体预算状态的开发者。它为 live mcp 服务器配置补充类型化模型和构建器,并为 managed agents 增加预算事件类型。升级的是客户端表达和解析能力,具体服务是否可用,仍取决于对应 api 与账户权限。

4.108.0 是正式版,具体改了什么?
OpenAI Java SDK 的 GitHub Release 在 2026 年 11 月 18 日发布,未标记为预发布。更新日志列出两项 API 变化:Live MCP server configuration,以及 Managed Agents budget events。SDK 的正式版本标记与其内部 beta API 命名空间是不同维度;不能据此前者推断所有相关服务都已正式面向全部用户开放。
Live MCP 配置适合哪些接入场景?
这项变化对应 Live 会话中的 MCP 工具配置。版本源码里的 McpTool 包含服务器标签、地址、说明、授权信息和请求头,以及 allowedTools 与 requireApproval 等字段。服务器连接、可用工具范围和执行前审批因此有了明确的类型化表达,而不只是依靠自行拼接原始数据。

立即学习“Java免费学习笔记(深入)”;
其中,allowed_tools 用于限定该服务器允许使用的工具;require_approval 用于表达哪些工具执行前需要用户批准。它们分别处理工具范围和审批要求,不能把允许某个工具等同于跳过审批。此次提交还增加了相应过滤模型,并明确保留已有原始 MCP 访问器、回调和无参构建器方法。
对已有 Live MCP 集成而言,这提供了采用类型化模型的空间;但保留旧接口并不等于所有应用都无需回归验证。对于只使用普通文本生成、没有接入 Live MCP 的项目,这一项变化本身并不会自动带来业务功能提升。
预算事件表示什么状态?
Managed Agents 部分新增 AgentSessionBudgetReachedEvent。源码说明它在会话因达到支出上限而暂停时发出,对应类型为 agent.session.budget_reached,包含 event_id 和暂停的 session 等信息。它适合让事件处理层识别预算触发的暂停,而不是把这种情况笼统当成连接故障或正常完成。

同一提交中的预算控制模型也区分 limit 与 consumed:上限以美分表示,消费记录是尽力提供、向下取整到整美分的值,可能不可用;参数中的空上限表示移除限制。这些字段不能直接当作精确实时账单,更不能据事件名称推断 SDK 会自动增加预算或恢复会话。
怎样判断这次更新与项目的关系?
从这些已核实的改动看,Live MCP 工具集成和托管会话事件消费是最直接相关的两个方向。应用侧可能需要更细致地呈现工具授权范围,或把预算暂停映射为可解释的业务状态;这是根据类型变化作出的接入分析,并非新增控制台功能或运行效果实测。
正式 Release 与 v4.108.0 标签源码提供的是发布和代码依据,并不证明所有依赖镜像中的对应构件均已可用。依赖仓库的分发状态、编译兼容性和真实 API 行为是不同的验证对象;仅凭这些版本变更不能承诺服务权限、收费规则或调用成功率。


















