SuperAPI AI 工具集

openai-agents

智能体与模型

查看项目

更新于 10-16 03:14

技能介绍

用途:该技能用于使用 OpenAI Agents SDK(JavaScript/TypeScript)构建 AI 应用,覆盖文本智能体、实时语音智能体、多智能体工作流与生产部署模式。

主要能力:定义带指令与工具的 Agent;用 Zod 生成工具参数 schema;通过 handoffs 实现多智能体委派;输入/输出护栏校验;Zod 结构化输出;流式运行;人工审批(requiresApproval);实时语音智能体(RealtimeAgent、RealtimeSession,支持 WebRTC/WebSocket);并行与代码/LLM 编排;调试与追踪。

安装与用法: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(实验性)。基本调用:import { run } from '@openai/agents'; const result = await run(agent, 'What is 2+2?')。

适用场景:多智能体工作流、语音 AI 应用、工具调用、需要输入输出校验或人工审批、部署到 Cloudflare Workers 或 Next.js。

限制:简单 OpenAI API 调用、仅用非 OpenAI 模型、大规模生产语音(可考虑 LiveKit Agents)不建议使用。Cloudflare Workers 不支持实时语音,CPU 30 秒、内存 128MB 限制。浏览器端切勿暴露主 API Key,应使用服务端生成的临时会话令牌。资料还列出 9 类常见错误及规避方式,如 Zod schema 类型错误、MCP 追踪错误、MaxTurnsExceededError、ToolCallError、schema 不匹配等。官方文档:https://openai.github.io/openai-agents-js/;GitHub:https://github.com/openai/openai-agents-js;npm:https://www.npmjs.com/package/@openai/agents。版本 v0.2.1,最后验证 2025-10-26。