OpenAI Agents SDK
OpenAI Agents SDK是OpenAI发布的用于构建智能体（Agent）应用的开源开发框架。它为开发者提供了创建、编排和管理AI智能体的核心能力，支持多智能体协作、工具调用、对话上下文管理及执行过程追踪等功能，旨在简化基于大语言模型的自主任务规划与执行系统的开发流程。
核心事实
时间轴 (近 90 天)
OpenAI Agents SDK 取代了 OpenAI 此前的实验项目 Swarm，核心隐喻是交接（handoffs），支持 Python 与 TypeScript。
在 OpenAI Agents SDK 中，运行结束后 result.last_agent 指向最后实际处理请求的智能体，便于在交接后继续对话时复用正确的智能体实例。
在 OpenAI Agents SDK 中，tools 列表中的智能体通过 agent.as_tool() 方法转换成一个普通工具，调用时启动一个独立的子运行，只把最终输出字符串返回给父智能体，父运行的对话状态不会被继承。
护栏本身通常是一个轻量智能体，用结构化输出做二元判定，因此会增加一次额外的 LLM 调用开销。
OpenAI Agents SDK 支持通过 @function_tool 装饰器将普通 Python 函数标记为工具，并放入 Agent 的 tools 列表。
Agents SDK 的护栏（Guardrail）机制在判定违反策略时抛出 InputGuardrailTripwireTriggered 或 OutputGuardrailTripwireTriggered 异常，立即中止智能体运行，而非仅返回警告。
SQLiteSession 是 OpenAI Agents SDK 中用于本地持久化会话记忆的方案，不依赖 OpenAI 服务端。
agent.as_tool(tool_name=..., tool_description=...) 可将子智能体包装成工具，与 handoff 的区别在于：交接是控制权转移，工具化是主智能体保留控制权并调用子智能体。
在 OpenAI Agents SDK 中，可以通过输出结构化模型（如 Pydantic BaseModel）并设置 Agent 的 output_type 来获得结构化输出，返回的 final_output 即为该类型实例。
OpenAI Agents SDK 支持通过 needs_approval=True 实现敏感操作的人机协同审批，运行后结果对象出现 interruptions，需调用 state.approve 或 state.reject 继续执行。
还有 40 条时间轴事件
全部知识事实 (20)
OpenAI在2024年开源了实验性框架Swarm，提出了轻量级的Agent间handoff（交接）机制
80%已验证OpenAI、Anthropic等主流AI公司均提供基于Python的官方SDK
70%已验证OpenAI 的 Agent SDK 走更工程化路线，原生支持 Agent 间 hand-off 交接机制并内置安全护栏
65%已验证Agent失败模式可从架构三个层次理解：规划层失败、执行层失败、反思层失败，且对应缓解策略完全不同
65%已验证工具调用机制中，开发者在调用 LLM API 时附带一份 JSON Schema 格式的工具描述清单，模型以结构化 JSON 格式输出调用参数
65%已验证Open Agent Builder原生支持MCP协议，可以接入社区中已有的MCP工具服务器
65%已验证OpenAI Agents SDK的trace函数支持添加自定义元数据（metadata），可用于筛选和分析追踪记录
65%已验证Agents SDK提供了trace函数作为上下文管理器，支持workflow_name和group_id两个关键参数用于自定义追踪
65%已验证OpenAI Agents SDK的Runner不会自动保存和维护对话历史，每次调用Runner.run()都是独立的
65%已验证OpenAI Agents SDK中的instructions参数本质上是系统提示词（system prompt），用于定义Agent的行为准则
65%已验证OpenAI 官方 Python SDK 发布了 v3.23.0 版本，以 Agents 能力增强为主线
90%待验证OpenAI Agents SDK内置了WebSearchTool，可用于Agent的Web搜索功能
90%待验证OpenAI Agents SDK使用to_input_list()方法将上一次的运行结果转换为可重新输入的格式，以实现对话历史的手动管理
90%待验证2024-2025年，Anthropic Claude Agent SDK、OpenAI Agents SDK、Google ADK等Agent框架集中涌现
85%待验证OpenAI Agents SDK支持gpt-4.1-nano和gpt-4.1-mini等模型
85%待验证group_id的设计借鉴了分布式追踪领域的Trace Context标准（如W3C TraceContext），用于将相关追踪记录归为一组
70%待验证OpenAI Agents SDK 提供 Guardrails（护栏）机制，用于拦截不该进入模型的输入和不该返回给用户的输出
60%待验证ScriptedModel 是 OpenAI Agents SDK 提供的测试辅助类，允许预先定义静态响应序列代替真实 LLM 驱动 Agent 执行
60%待验证OpenAI Agents SDK的无状态设计与LangChain的Memory模块等有状态框架形成对比
60%待验证OpenAI Agents SDK定义了五种消息类型：Developer Message、User Message、Assistant Message、Function Call和Function Call Output
60%