OSS Agents JP
オープンソース AI エージェント 日本語ガイド
← 一覧へ
OpenAI Agents SDK (JS/TS)
CODEX

OpenAI Agents SDK (JS/TS)

OpenAI Agents SDK (JS/TS)

OpenAI Agents SDK の TypeScript / JavaScript 実装。Node・ブラウザ・Edge ランタイムで動作し Realtime / Voice エージェントもサポート。

#SDK#TypeScript#公式
EDITOR'S TAKE

編集部メモ

リアルタイムVoiceに対応、OpenAI公式の軽量エージェントフレームワーク

OpenAIが公開した公式エージェントSDKで、TypeScript/JavaScriptエコシステムへの統合度が高いです。マルチランタイム対応(Node、Deno、Bun、Cloudflare Workers)により、環境選択の自由度があり、リアルタイムVoiceエージェントやSandbox Agentsといった機能でテキスト以上のユースケースに対応します。Sandbox AgentsはベータなのでProduction環境での本格採用には検証が必要ですが、ファイルシステムアクセスやコマンド実行が可能な点は強力です。複数エージェント間の協調や、OpenAI Realtime APIを活用した音声対話システムを構築したい開発者に向いています。

USE CASES

こんな場面で使う

  • 複数のエージェントが役割分担して協動する自動化ワークフロー(データ検索→分析→レポート生成など)
  • リアルタイムAPI対応の音声会話型エージェントやコールセンター自動化の実装
  • SandboxAgentでファイル操作・コマンド実行が可能な長実行型タスク自動化
DIFFERENTIATOR

類似ツールとの違い

公式SDKなので、OpenAI APIの最新機能に最優先で追従します。MCP対応で既存ツール連携も容易。PythonのAgents SDKと並行開発されており、言語横断的な知見共有が期待できる点で、コミュニティ主導のフレームワーク(LangChainなど)と異なります。
CAVEAT

注意点・向かない用途

⚠️ Sandbox AgentsはベータなのでProduction環境での本格利用は要検証。エージェント設計の理解が前提で、初心者向けというより既にエージェント開発経験のある層向けです。セキュリティ境界の設定は自分で責任を持つ必要があります。
BEST FOR

向いている読者

TypeScript/JavaScript開発者OpenAI API活用者マルチエージェント設計経験者音声インタラクション実装者

— OSS Agents JP 編集部による独自評価(OpenAI Agents SDK (JS/TS) に関する観察)

REPO STATS

リポジトリ統計

⭐ Stars
-
🍴 Forks
-
⚠️ Open Issues
-
🌿 Language
-
📄 License
-
🕒 最終更新
-
📅 公開日
-
🌿 Branch
-
REFERENCE

公式ドキュメント(README)

本ハブの独自評価は上記「編集部メモ」が一次情報です。以下は GitHub README の参考転載(折りたたみ)。

📖 GitHub README の日本語訳を読む(AI 自動翻訳 / 参考情報)

— AI による自動翻訳 (2026.05.11 更新)。正確な情報は GitHub の原文 をご確認ください。

OpenAI Agents SDK (JavaScript/TypeScript)

npm version CI

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

Image of the Agents Tracing UI

注記

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

コア概念

  1. エージェント:命令、ツール、ガードレール、ハンドオフで構成された LLM
  2. サンドボックスエージェント:ファイルシステムワークスペースとサンドボックス環境と組み合わされたエージェント。長時間の作業に対応します
  3. エージェント・アズ・ツール / ハンドオフ:特定のタスクを他のエージェントに委譲します
  4. ツール:様々なツールにより、エージェントがアクション(関数、MCP、ホストされたツール)を実行できます
  5. ガードレール:入力と出力の検証のための設定可能なセーフティチェックです
  6. ヒューマン・イン・ザ・ループ:エージェント実行全体で人間を関与させるための組み込みメカニズムです
  7. セッション:エージェント実行全体での自動会話履歴管理です
  8. トレーシング:エージェント実行の組み込みトラッキング。ワークフローを表示、デバッグ、最適化できます
  9. リアルタイムエージェント:フル機能を備えた強力な音声エージェントを構築します

examples/ ディレクトリを参照して、SDK の動作を確認してください。

はじめに

サポートされている環境

  • Node.js 22 以降
  • Deno
  • Bun

実験的サポート:

  • nodejs_compat が有効な Cloudflare Workers

詳細情報はドキュメントをご確認ください

インストール

npm install @openai/agents zod

最初の Sandbox Agent を実行する

Sandbox Agents はベータ版です。sandbox agent はファイルを検査し、コマンドを実行し、パッチを適用し、ワークスペースの状態をより長いタスク全体で保つことができます。

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.

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

sandbox なしで agent を実行する

ワークフローがファイルシステムワークスペースや sandbox ライフサイクルを必要としない場合は、通常の 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.

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

謝辞

オープンソースコミュニティ、特に以下のプロジェクトの優れた成果を認めたいです。

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

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

RELATED

同じカテゴリの他のツール