OpenAI Agents SDK
OpenAI Agents SDK是OpenAI发布的用于构建智能体（Agent）应用的开源开发框架。它为开发者提供了创建、编排和管理AI智能体的核心能力，支持多智能体协作、工具调用、对话上下文管理及执行过程追踪等功能，旨在简化基于大语言模型的自主任务规划与执行系统的开发流程。
核心事实
时间轴 (近 90 天)
LoopGrid 通过插件方式接入 OpenAI Agents SDK 的原生追踪和运行钩子（run hooks），为每一次决策创建签名记录，覆盖从策略评估到最终结果的完整链路。
OpenAI Agents SDK 负责运行 agent，应用负责授权，LoopGrid 负责记录证据，三者的职责分离确保了清晰的审计线索。
在 750 美元退款的演示中，如果尝试在不批准的情况下恢复运行，agent 会保持暂停状态，工具调用次数为零。
LoopGrid 与 OpenAI Agents SDK 的集成过程无需修改 agent 的核心逻辑，只需在初始化时添加 LoopGrid 组件。
LoopGrid 与 OpenAI Agents SDK 的集成模式适用于需要强合规性的场景，如金融退款、医疗数据访问、权限变更等。
OpenAI Agents SDK 的 tracing processor 是 SDK 追踪系统的插件接口，负责将 agent 运行过程中产生的 span（如模型调用、工具调用、handoff）导出到外部后端。
OpenAI Agents SDK 可以通过将 client 指向其他模型提供方的地址来使用非 OpenAI 的模型（如 Grok）。
对于单一的小 agent，用原生 Python 写出来比用框架更短、更容易调试，框架在这里增加的是依赖而非能力。
一个三 agent 的团队用 OpenAI Agents SDK 大约二十行代码就能搭完。
选择框架应按心智模型匹配：以角色和调用关系思考时适合 Agents SDK，以带分支和回环的流程图思考时适合 LangGraph。
还有 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%