OpenAI Agents SDK は、JavaScript/TypeScript でマルチエージェントワークフローを構築するための、軽量でありながら強力なフレームワークです。プロバイダーに依存せず、OpenAI API などをサポートしています。

[!NOTE] Python バージョンをお探しですか？OpenAI Agents SDK Python をご確認ください。

1. Agents: 命令、ツール、ガードレール、ハンドオフで構成された LLM
2. Sandbox Agents: ファイルシステムワークスペースとサンドボックス環境をペアにしたエージェント（より長時間の作業用）
3. Agents as tools / Handoffs: 特定のタスクを他のエージェントに委譲する
4. Tools: さまざまなツールにより、エージェントはアクション（関数、MCP、ホステッドツール）を実行できます
5. Guardrails: 入出力検証用の構成可能なセーフティチェック
6. Human in the loop: エージェント実行全体で人間を関わらせるための組み込みメカニズム
7. Sessions: エージェント実行全体での会話履歴の自動管理
8. Tracing: エージェント実行の組み込み追跡により、ワークフローの表示、デバッグ、最適化が可能です
9. Realtime Agents: すべての機能を備えた強力な音声エージェントを構築します

examples/ ディレクトリを確認して、SDK の実装例をご確認ください。

• Node.js 22 以上
• Deno
• Bun

• nodejs_compat が有効化された Cloudflare Workers

詳細については、ドキュメントをご確認ください。

npm install @openai/agents zod

Sandbox Agents はベータ版です。サンドボックスエージェントはファイルを検査したり、コマンドを実行したり、パッチを適用したり、ワークスペース状態をより長いタスク全体で保持することができます。

import { run } from '@openai/agents';
import { gitRepo, SandboxAgent } from '@openai/agents/sandbox';
import { UnixLocalSandboxClient } from '@openai/agents/sandbox/local';

const agent = new SandboxAgent({
  name: 'Workspace Assistant',
  instructions: 'Inspect the sandbox workspace before answering.',
  defaultManifest: {
    entries: {
      repo: gitRepo({
        repo: 'openai/openai-agents-js',
        ref: 'main',
      }),
    },
  },
});

const result = await run(
  agent,
  'Inspect repo/README.md and summarize what this project does.',
  {
    sandbox: {
      client: new UnixLocalSandboxClient(),
    },
  },
);

console.log(result.finalOutput);
// このプロジェクトは、エージェント ワークフロー を構築するための JavaScript/TypeScript SDK を提供します。

（これを実行する場合は、OPENAI_API_KEY 環境変数を設定してください）

ワークフローがファイルシステムワークスペースやサンドボックスのライフサイクルを必要としない場合でも、通常の 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);
// コードの中のコード、
// 自身を呼び出す関数、
// 無限ループの踊り。

examples/ ディレクトリを探索して、SDK の実装例を確認してください。

特に、オープンソースコミュニティの優れた取り組みに感謝の意を表します。

• zod（スキーマ検証）
• Starlight
• vite および vitest
• pnpm
• Next.js

Agents SDK をオープンソース フレームワークとして構築し、コミュニティの他のメンバーが当社のアプローチを拡張できるようにすることにコミットしています。

詳細については、ドキュメントを参照するか、examples/ ディレクトリを探索してください。

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.

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

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

• Node.js 22 or later
• Deno
• Bun

• Cloudflare Workers with nodejs_compat enabled

Check out the documentation for more detailed information.

npm install @openai/agents zod

Sandbox Agents are in beta. A sandbox agent can inspect files, run commands, apply patches, and carry workspace state across longer tasks.

import { run } from '@openai/agents';
import { gitRepo, SandboxAgent } from '@openai/agents/sandbox';
import { UnixLocalSandboxClient } from '@openai/agents/sandbox/local';

const agent = new SandboxAgent({
  name: 'Workspace Assistant',
  instructions: 'Inspect the sandbox workspace before answering.',
  defaultManifest: {
    entries: {
      repo: gitRepo({
        repo: 'openai/openai-agents-js',
        ref: 'main',
      }),
    },
  },
});

const result = await run(
  agent,
  'Inspect repo/README.md and summarize what this project does.',
  {
    sandbox: {
      client: new UnixLocalSandboxClient(),
    },
  },
);

console.log(result.finalOutput);
// This project provides a JavaScript/TypeScript SDK for building agent workflows.

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

You can still use a regular Agent when your workflow does not need a filesystem workspace or sandbox lifecycle.

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.

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

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.