openai-agents

Installation
Summary

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
SKILL.md

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)


Related skills
Installs
363
GitHub Stars
776
First Seen
Jan 20, 2026