openai-agents

SKILL.md

Build text and voice agents with tools, multi-agent handoffs, guardrails, and human-in-the-loop patterns.

Supports text agents, realtime voice agents with WebRTC, and multi-agent workflows with automatic delegation via handoffs

Define tools using Zod schemas for type-safe parameter validation; includes structured output support for predictable JSON responses

Implements input/output guardrails for safety validation, human approval workflows for sensitive operations, and streaming support for real-time event handling

Prevents 11 documented errors including MaxTurnsExceededError, schema mismatches, reasoning defaults, and JSON output leaks; covers Cloudflare Workers, Next.js, and Deno runtimes

Requires Node.js 22+, Zod 4 (breaking change in v0.4.0), and never expose API keys to browsers—use ephemeral session tokens instead

OpenAI Agents SDK

Build AI applications with text agents, voice agents (realtime), multi-agent workflows, tools, guardrails, and human-in-the-loop patterns.

Quick Start

npm install @openai/agents zod@4  # v0.4.0+ requires Zod 4 (breaking change)
npm install @openai/agents-realtime  # Voice agents
export OPENAI_API_KEY="your-key"

Breaking Change (v0.4.0): Zod 3 no longer supported. Upgrade to zod@4.

Runtimes: Node.js 22+, Deno, Bun, Cloudflare Workers (experimental)