[控场AI]
产品Agents SDK

OpenAI Agents SDK

OpenAI Agents SDK是OpenAI发布的用于构建智能体(Agent)应用的开源开发框架。它为开发者提供了创建、编排和管理AI智能体的核心能力,支持多智能体协作、工具调用、对话上下文管理及执行过程追踪等功能,旨在简化基于大语言模型的自主任务规划与执行系统的开发流程。

核心事实

时间轴 (近 90 天)

11月18日

Agent 框架(LangGraph、CrewAI、OpenAI Agents SDK、MCP 协议等)正在快速演进,使托管层面临抽象泄漏风险:框架每更新一次状态模型或工具调用协议,托管平台就要跟进适配。

待验证50%
11月16日

在 Agents SDK 中,guardrails(护栏)是独立于 agent 主逻辑运行的校验层,通常由另一个模型或规则引擎执行输入输出检查。

待验证50%
11月16日

K9-AIF 兼容 CrewAI、LangGraph、Claude Agent SDK 以及 OpenAI Agents SDK。

待验证50%
11月16日

根据 OpenAI 官方文档,agent 护栏只检查第一个 agent 的输入和最后一个 agent 的输出。

待验证50%
11月16日

K9-AIF 将 OpenAI Agents SDK 包装成自己的一个 orchestrator,使每次跨越边界的行为成为检查点。

待验证50%
11月14日

选型建议:需要最少样板代码、原生MCP支持和干净多Agent交接时选OpenAI Agents SDK。

待验证50%
11月14日

主流Agent开发SDK(如OpenAI Agents SDK、LangChain、Vercel AI SDK等)普遍提供工具执行包装层,会将未捕获异常转换为结构化的错误结果返回给模型,而非中断整个运行循环。

待验证50%
11月11日

对于依赖多工具协同的 Agent 工作流,该串行化问题导致延迟随工具数量成倍增长,例如八个调用会逼近 24 秒。

待验证50%
11月9日

追踪在 SDK 中是默认开启的,开发者如果不主动配置,事件就已经在被记录。

待验证50%
11月9日

每个 Agent 运行一个内置循环直到任务完成,开发者不需要手动编写 while 循环。

待验证50%

还有 40 条时间轴事件

全部知识事实 (20)

已验证

工具调用机制中,开发者在调用 LLM API 时附带一份 JSON Schema 格式的工具描述清单,模型以结构化 JSON 格式输出调用参数

90%
已验证

OpenAI在2024年开源了实验性框架Swarm,提出了轻量级的Agent间handoff(交接)机制

80%
已验证

trace 表示一次请求或事务的完整生命周期,由若干 span 组成,每个 span 记录一段有开始和结束时间的操作,并携带名称、属性、事件和状态;span 之间通过父子关系构成有向无环图。

75%
已验证

切换到方案B后场景加载时间从3.3秒缩短到约0.5秒,快约6.8倍

75%
已验证

Open Agent Builder原生支持MCP协议,可以接入社区中已有的MCP工具服务器

75%
已验证

OpenAI、Anthropic等主流AI公司均提供基于Python的官方SDK

75%
已验证

安装 OpenAI Agents SDK 的命令是 pip install openai-agents。

70%
已验证

Handoff 模式适合单一专家接管场景,由接收方拥有所有权、撰写回复并处理后续交互;Agent-as-Tool 模式适合需要多专家意见合成一个连贯回复的场景,调用方保留所有权并汇总答案后统一回复。

65%
已验证

SQLiteSession 是 OpenAI Agents SDK 中用于本地持久化会话记忆的方案,不依赖 OpenAI 服务端。

65%
已验证

OpenAI Agents SDK 支持通过 @function_tool 装饰器将普通 Python 函数标记为工具,并放入 Agent 的 tools 列表。

65%
已验证

OpenAI Agents SDK 将工具直接内联注册,免去手动搭建 MCP Server 的步骤,模型字段是必填项

65%
已验证

Claude Agent SDK 和 OpenAI Agents SDK 都接管了 Agent Loop(智能体循环),将原本需要手写的模型调用、工具分发、历史记录维护和循环控制逻辑大幅简化

65%
已验证

OpenAI Agents SDK 提供 Guardrails(护栏)机制,用于拦截不该进入模型的输入和不该返回给用户的输出

65%
已验证

OpenAI 的 Agent SDK 走更工程化路线,原生支持 Agent 间 hand-off 交接机制并内置安全护栏

65%
已验证

Agent失败模式可从架构三个层次理解:规划层失败、执行层失败、反思层失败,且对应缓解策略完全不同

65%
已验证

Agent Handoffs允许在对话过程中将控制权从一个Agent移交给另一个专精Agent

65%
已验证

OpenAI Agents SDK内置了WebSearchTool,可用于Agent的Web搜索功能

65%
已验证

OpenAI Agents SDK的trace函数支持添加自定义元数据(metadata),可用于筛选和分析追踪记录

65%
已验证

Agents SDK提供了trace函数作为上下文管理器,支持workflow_name和group_id两个关键参数用于自定义追踪

65%
已验证

OpenAI Agents SDK的Runner不会自动保存和维护对话历史,每次调用Runner.run()都是独立的

65%

来源文章