OpenAI Agents SDK (JavaScript/TypeScript)

The OpenAI Agents SDK is a lightweight yet powerful framework for building multi-agent workflows in JavaScript/TypeScript. It is provider-agnostic, supporting OpenAI APIs and more.

Note

Looking for the Python version? Check out OpenAI Agents SDK Python.

Core concepts

1. Agents: LLMs configured with instructions, tools, guardrails, and handoffs
2. Agents as tools / Handoffs: Delegating to other agents for specific tasks
3. Tools: Various Tools let agents take actions (functions, MCP, hosted tools)
4. Guardrails: Configurable safety checks for input and output validation
5. Human in the loop: Built-in mechanisms for involving humans across agent runs
6. Sessions: Automatic conversation history management across agent runs
7. Tracing: Built-in tracking of agent runs, allowing you to view, debug and optimize your workflows
8. Realtime Agents: Build powerful voice agents with full features

Explore the examples/ directory to see the SDK in action.

Get started

Supported environments

• Node.js 22 or later
• Deno
• Bun

Experimental support:

• Cloudflare Workers with nodejs_compat enabled

Check out the documentation for more detailed information.

Installation

npm install @openai/agents zod

Run your first agent

import { Agent, run } from '@openai/agents';

const agent = new Agent({
  name: 'Assistant',
  instructions: 'You are a helpful assistant',
});

const result = await run(
  agent,
  'Write a haiku about recursion in programming.',
);
console.log(result.finalOutput);
// Code within the code,
// Functions calling themselves,
// Infinite loop's dance.

(If running this, ensure you set the OPENAI_API_KEY environment variable)

Explore the examples/ directory to see the SDK in action.

Acknowledgements

We'd like to acknowledge the excellent work of the open-source community, especially:

• zod (schema validation)
• Starlight
• vite and vitest
• pnpm
• Next.js

We're committed to building the Agents SDK as an open source framework so others in the community can expand on our approach.

For more details, see the documentation or explore the examples/ directory.