用途：该技能用于使用 OpenAI Agents SDK（JavaScript/TypeScript）构建 AI 应用，涵盖文本智能体、实时语音智能体、多智能体工作流与生产部署模式。
主要能力：智能体由指令与工具构成；工具使用 Zod schema 定义并可被自动调用；支持 handoffs 多智能体任务分派、输入/输出护栏、基于 Zod 的结构化输出、流式响应、人工审批（requiresApproval: true）以及追踪调试。提供 17 个模板，含文本智能体 8 个、实时语音 3 个、框架集成 4 个、工具 2 个。
使用方式：安装命令为 bun add @openai/agents zod@3，语音需 bun add @openai/agents-realtime；设置 export OPENAI_API_KEY="your-api-key"。基础用法为定义 Agent 后调用 run(agent, input)，可传 { stream: true } 或 { maxTurns: 20 }。语音使用 RealtimeAgent 与 RealtimeSession，transport 可选 webrtc 或 websocket。可集成 Cloudflare Workers（实验性）与 Next.js App Router。
常见错误：Zod schema 类型错误建议内联定义 schema；MCP 追踪错误可调用 initializeTracing()；MaxTurnsExceededError 可提高 maxTurns 或改进指令。完整 9 类错误见 references/common-errors.md。
适用场景：多智能体工作流、语音 AI、工具调用、输入输出校验、人工审批、复杂任务编排、部署到 Cloudflare Workers 或 Next.js。
限制：简单 OpenAI API 调用、仅用非 OpenAI 模型、大规模生产语音（可考虑 LiveKit Agents）不适用。Cloudflare Workers 不支持实时语音，CPU 上限 30 秒、内存 128MB。语音 handoff 期间不能更换 voice/model。API 密钥不得暴露给浏览器，应使用会话令牌。资料未提供具体收费与价格信息。