OpenAI Official 模型
agentscope-extensions-model-openai-official 通过官方 OpenAI Java SDK 集成 OpenAI 模型。暂时只支持 Responses API,未来会考虑支持 Chat Completions API。
添加依赖
ModelRegistry
设置OPENAI_API_KEY 后,使用 openai-official:<model> 字符串 id:
显式 Builder
需要自定义 base URL、多 Agent formatter 时使用 Builder:Spring Boot
本模块暂无专用 Spring Boot starter。推理
通过GenerateOptions.reasoningEffort 控制推理力度(low / medium / high / minimal)。要在响应中看到推理内容,需显式开启 reasoning.summary:
Msg.metadata 自动在多轮对话中回放,无需手动管理。
兼容性说明
本模块通过 OpenAI Java SDK 集成,暂时只支持 Responses API,未来会考虑支持 Chat Completions API。以下选项不支持,设置非空值时会 fail-fast:frequencyPenalty、presencePenalty、topK、seed、cacheControl、thinkingBudget、endpointPath、每请求级 additionalHeaders 和 additionalQueryParams。
Responses 专有参数通过 GenerateOptions.additionalBodyParams 白名单键透传:reasoning.summary、reasoning.context、reasoning.mode、service_tier、prompt_cache_key、prompt_cache_options、max_tool_calls、safety_identifier、store、previous_response_id。
store 控制服务端响应存储,默认为 false。如需使用 OpenAI 服务端会话续链,先存储第一轮响应,从响应 metadata 的 openai.response.id 读取 ID,并在后续请求中传入 previous_response_id。使用 previous_response_id 时应只发送本轮新增 input,不要重复完整会话历史。
原生结构化输出默认开启(supportsNativeStructuredOutput() 返回 true)。SDK 重试已禁用(maxRetries=0),重试由 AgentScope 管理。