Skip to main content

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:frequencyPenaltypresencePenaltytopKseedcacheControlthinkingBudgetendpointPath、每请求级 additionalHeadersadditionalQueryParams Responses 专有参数通过 GenerateOptions.additionalBodyParams 白名单键透传:reasoning.summaryreasoning.contextreasoning.modeservice_tierprompt_cache_keyprompt_cache_optionsmax_tool_callssafety_identifierstoreprevious_response_id store 控制服务端响应存储,默认为 false。如需使用 OpenAI 服务端会话续链,先存储第一轮响应,从响应 metadata 的 openai.response.id 读取 ID,并在后续请求中传入 previous_response_id。使用 previous_response_id 时应只发送本轮新增 input,不要重复完整会话历史。 原生结构化输出默认开启(supportsNativeStructuredOutput() 返回 true)。SDK 重试已禁用(maxRetries=0),重试由 AgentScope 管理。