用途：指导使用 OpenAI Agents SDK（JavaScript/TypeScript）构建 AI 应用，涵盖文本智能体、实时语音智能体、多智能体工作流与生产部署模式。
安装与运行环境：npm install @openai/agents zod@3；语音智能体需 npm install @openai/agents-realtime。设置环境变量 export OPENAI_API_KEY="your-api-key"。支持 Node.js 22+、Deno、Bun，Cloudflare Workers 为实验性支持。
核心概念：Agent（带指令与工具的 LLM）、Tool（可调用函数，自动生成 schema）、Handoffs（多智能体委派）、Guardrails（输入/输出校验）、Structured Outputs（基于 Zod 的类型安全输出）。
主要能力：文本智能体支持 run 调用、流式输出、多智能体交接、输入/输出护栏、人工审批（requiresApproval）、并行编排；实时语音智能体基于 RealtimeAgent 与 RealtimeSession，支持 WebRTC/WebSocket 传输、语音交接（交接时不可更换 voice 与 model，对话历史自动传递）。提供 Next.js App Router 与 Cloudflare Workers 集成示例。
使用方式：通过 run(agent, input) 执行并读取 finalOutput、usage.totalTokens；流式使用 stream: true 并遍历事件；调试可设 process.env.DEBUG='@openai/agents:*'。
限制与注意：浏览器端切勿暴露主 OPENAI_API_KEY，应服务端生成临时会话令牌；Cloudflare Workers 不支持实时语音，且有 CPU 时间（30s）与内存（128MB）限制；需设置合理 maxTurns 防止失控成本；文档列出 9 类常见错误及规避方法。简单 OpenAI API 调用或仅用非 OpenAI 模型时不适用；大规模生产语音可考虑 LiveKit Agents。版本 SDK v0.2.1。