openai-agents-sdk

openai-agents-sdk 技能为使用 Python openai-agents 套件构建复杂自主代理的开发人员提供全面协助。它专为需要编排多代理工作流、实现基于 Pydantic 的严格输出验证以及管理持久会话的工程师和 AI 研究人员而设计。无论您是在构建内部自动化工具、研究助手还是复杂的多步骤推理流水线，此技能都能弥合原生 API 实现与稳健的生产级代理架构之间的鸿沟。

• 代理全生命周期管理，包括代理初始化、指令编写以及 gpt-5 系列模型的选用。

• 多代理协作 (Handoffs) 的深度集成，允许专业代理委派任务并协调复杂的业务逻辑。

• 通过 @function_tool 装饰器实现自定义函数工具，并使用 AgentOutputSchema 进行可靠的 JSON 结构化输出提取。

• 高级执行控制，包括同步与异步运行 (Runner.run_sync, Runner.run_streamed) 以及状态化 SQLiteSession 管理。

• 原生支持 Azure OpenAI 以及通过 LiteLLM 配置的多供应商后端，确保迁移顺畅与模型灵活性。

• 内置执行图记录的可观测性模式、输入输出安全防线 (Guardrails) 以及沙箱执行环境。

• 通过 MCP (Model Context Protocol) 获取实时文档，确保在快速开发周期中模型 ID 和 API 签名保持准确。

• 最佳实践：在最终确定代码之前，请务必使用 openaiDeveloperDocs MCP 服务器验证模型 ID 和 API 结构，因为 OpenAI SDK 更新频繁。

• 用法：执行前请确保正确配置环境变量 (OPENAI_API_KEY, LLM_PROVIDER, AZURE_API_KEY)。

• 限制：虽然是为代理 SDK 设计，但复杂的多代理编排需要仔细设计交接触发器和上下文隔离。

• 关键词：Python 代理, OpenAI SDK, 多代理流水线, 函数工具, AgentOutputSchema, SQLiteSession, LiteLLM, 防护机制, LLM 裁判, 流式传输, 编排, Pydantic 验证。