AgentScope Java 2.x 系列【45】 2.0.4 版本更新：支持 Responses API、个人微信......

1. 更新速览

核心亮点：新增OpenAI Responses API；重构AgentScope Service；Channel与存储能力增强；强化并发Agent执行、工具/技能隔离。

1.1 ✨ 新增

1.1.1 核心 / 模型

1. 新增OpenAI Responses API模块（#3078）
2. 支持returnDirect工具结果，直接返回、终止推理循环（#2891）
3. 暴露详细聊天 Token 用量指标；新增模型降级 failover 监听器（#3215，#3145）
4. 支持Anthropic Bearer Token鉴权（#3038）
5. 新增类型安全Jev System One客户端、Spring Boot Starter及中间件示例（#3240）

1.1.2 Harness / 工具 / 存储

1. 新增AgentRun / RunControl单次执行控制，运行时上下文显式传递（#3279）
2. 请求级工具配置，隔离工具可见性、流式回调、会话技能资源（#3283）
3. 文件系统配置新增可选sharedLocalWorkspace（#3247）
4. 支持关闭内置Web工具，支持注入自定义HTTP Client（#3075，#3103）
5. 支持MCP Server和工具维度元数据透传（#3255）
6. 新增MongoDB存储扩展（#2698）
7. E2B原生快照支持按沙箱自动清理旧快照（#2555）

1.2.3 Service / Channel

1. 重新设计 AgentScope Service 实现（#3080）
2. 新增个人微信iLink Channel集成（#3184）
3. 钉钉新增HTTP回调接收模式，与Stream模式共存（#3177）
4. 可插拔Channel AccessToken存储、入站事件去重；bot-loop guard增加空闲淘汰（#3182，#3175）
5. Channel入站媒体消息统一抽象为通用元数据（#3180）

1.2 🔄 变更

1. 删除消息实体中未使用的role参数（#3045）
2. Gemini工具参数Schema直接使用原生JSON Schema（#3051）
3. Version.VERSION改为从Maven项目版本自动生成（#3087）
4. 文档站迁移至Mintlify；保留旧链接、恢复多语言切换（#3081，#3082，#3276）

1.3 🛠️ 修复

1.3.1 核心 / 状态 / 并发

1. 并发调用上下文隔离，支持取消正在运行/排队任务；解决工具、技能跨会话互相干扰（#3279，#3283）
2. 修复版本=0迁移状态产生虚假CAS冲突；JDBC无条件写入做原子版本返回，写入后缓存版本（#3165，#3220，#3236）
3. 状态缓存淘汰同步清理slot版本；移除State反序列化标记接口；Agent返回空结果也持久化状态（#3074，#3048，#3049）
4. 保留摘要失败的终止状态；处理模型降级过程中的同步异常（#2757，#3149）
5. 用户拒绝HITL人工确认工具调用时发送工具结果事件，支持自定义拒绝理由（#3104，#2546）
6. 修复JSON Schema生成线程安全问题（#2796）

1.3.2 模型提供商

1. 明文HTTP请求默认使用HTTP/1.1，解决h2c升级导致vLLM/uvicorn丢失POST body问题（#3214）
2. 完整保留流式chunk内reasoning details、thought signatures；清理冗余OpenAI工具元数据（#3128，#2910，#2914）
3. cache_control移动至内容块级别（#2878）
4. DashScope流式输出与thinking模式解耦；自定义多模态端点识别；阻塞式Embedding SDK调用移出执行线程（#3137，#3163，#3265）
5. 修正Gemini Token用量统计（#3034）
6. Ollama工具结果序列化使用tool_name；thinking输出封装为ThinkingBlock（#3093，#3146）

1.3.3 Harness / 沙箱 / 集成

1. 保留非UTF-8文件上传内容；在提示词暴露会话workspace路径（#2456，#3020）
2. 状态持久化时重新绑定K8s远程快照；保留命令换行符（#3025，#3204）
3. 优化Docker沙箱原生文件传输；拒绝截断的下载结果（#2923）
4. 非归属AgentRun的沙箱保持MCP连接；保留MCP工具返回图片URL（#2302，#3053）
5. JDBC沙箱slot ID支持路径分隔符（#3233）
6. 修复AG-UI权限恢复后工具结果丢失；为分段文本生成唯一消息ID；清理active-run标记后再下发终止信号（#3100，#3010，#3109）
7. 企业微信发送失败转为流式错误对外透出（#3173）
8. Spring Boot Starter改用模块化core、AG-UI依赖（#3156）
9. Milvus L2检索分数归一化；WordReader Markdown表格单元格转义（#3070，#3169）

1.4 📖 文档更新

1. 新增中英文Agent Harness构建指南，重构AgentScope Service使用文档（#3139，#3136）
2. 补充Jev结构化决策集成文档；修正文档CompactionConfig.keepTokens默认值（#3274，#3144）

2. 重要更新

2.1 OpenAI Responses API 支持

Chat Completions是传统无状态对话API，适合简单聊天；Responses API是面向Agent/ 智能体的新一代API，原生支持多步骤工具循环、服务端状态、结构化事件流。

// 1. 构建 OpenAI Responses API Model（2.0.4新增模块）ModelresponsesModel=OpenAIResponsesModel.builder().apiKey(System.getenv("OPENAI_API_KEY")).modelName("gpt-4o").baseUrl("https://api.openai.com/v1")// 可选，代理地址替换此处.temperature(0.3).build();// 2. 构建 HarnessAgent，挂载Responses模型 + 工具HarnessAgentagent=HarnessAgent.builder().name("responses-agent").model(responsesModel).sysPrompt("你是一个计算器助手，用户让你做加法就调用add工具。")// 注册工具，包含 returnDirect 加法工具.registerTool(newOpenAIResponsesDemo().add(null,null)).build();

2.2 Jev 模型集成

Jev是TypeSafe AI推出的结构化决策模型。它不是聊天模型，不生成文本，也不做工具调用。它做的事情只有一件：接收上下文和一组结构化问题，返回类型化的答案和校准概率。

AgentScope集成Jev以独立扩展模块的方式存在，应用代码直接注入JevClient做判断，或者通过middleware挂到Agent循环里。

依赖引入：

<dependency><groupId>io.agentscope</groupId><artifactId>agentscope-extensions-jev</artifactId><version>${agentscope.version}</version></dependency>

Spring Boot项目可以直接用starter：

<dependency><groupId>io.agentscope</groupId><artifactId>agentscope-jev-spring-boot-starter</artifactId><version>${agentscope.version}</version></dependency>

agentscope:jev:api-key:${TYPESAFE_API_KEY:}base-url:https://api.typesafe.aimodel:jev-latesttimeout:5s

执行守卫（判断行为风险）：

JevAutoModeMiddlewareautoMode=JevAutoModeMiddleware.builder(client).guardedTool("bash").safetyThreshold(0.8).execution(newio.agentscope.extensions.judge.jev.JevExecution.Options(io.agentscope.extensions.judge.jev.JevExecution.Mode.SHADOW,java.time.Duration.ofSeconds(2),"v1",(ctx,record)->{})).build();ReActAgentagent=ReActAgent.builder().name("assistant").model(model).toolkit(toolkit).middleware(autoMode).build();

2.3 AgentScope Service 重写

AgentScope Service是面向业务应用、可自托管的Agent as a Service平台。平台上的托管Agent（Managed Agent）基于AgentScope HarnessAgent内核。

当前Service版本为2.1.0-BETA1，属于预发布版本。

2.4 个人微信通道

新增iLink Channel适配器，对接腾讯OpenClaw/ClawBot的iLink协议，让你的AgentScope Agent直接在「个人微信」里聊天，不用企业微信、不用逆向hook微信。