OpenAI Agents SDK JavaScript 工作流工具包

要解决的问题

在 JavaScript/TypeScript 环境中落地 OpenAI Agents SDK 时，开发者常面临三个痛点：一是官方规范、示例与第三方封装分散在多个仓库，难以快速梳理 agent orchestration、tools、handoffs 与 tracing 的关联；二是 Node.js 22+ 等环境要求与 beta 功能（如 Sandbox Agents）未在单一入口明确，容易踩坑；三是缺少一套连贯的从基础编排到工具调用再到跨 agent 交接的落地路径，导致项目推进时反复试错。

技能的核心能力与工作路径

该技能以源码级指南的形式，为 JS/TS 开发者提供结构化的落地支持：

• 梳理组件关系：围绕 OpenAI Agents SDK 的核心概念，明确 agent、tool、handoff 与 tracing 在代码中的交互方式，避免混淆第三方封装与官方规范。
• 环境与功能映射：结合 Node.js 22+ 的要求，标注 Sandbox Agents 等 beta 功能的适用场景，帮助开发者在项目初期评估是否采用。
• 落地路径参考：提供从基础 agent 定义到工具集成、再到跨 agent handoff 的连贯示例，让开发者能快速搭建符合官方规范的工作流。

适用边界与注意点

• 该工具包是源码级指南，不替代 OpenAI Agents SDK 的官方文档，复杂场景仍需查阅上游文档。
• Sandbox Agents 处于 beta 阶段，稳定性和功能完整性未经官方生产级验证，关键项目需谨慎评估。
• 不包含具体的业务逻辑实现，仅提供通用的编排与集成模式，需结合项目实际调整。