OpenAI Agents SDK icon

OpenAI Agents SDK

OpenAI Agents SDKは、マルチエージェントのワークフローと音声エージェントを構築できる軽量なJavaScript/TypeScriptフレームワーク。sandbox、handoffs、tools、tracing、realtime対応。

OpenAI Agents SDK

概要

OpenAI Agents SDK(JavaScript/TypeScript)は、JavaScript と TypeScript でマルチエージェントのワークフローを構築するための軽量フレームワークです。このリポジトリでは、OpenAI APIs などをサポートする provider-agnostic な設計として説明されています。

この SDK は、agents、tools、guardrails、handoffs、sessions、tracing、sandbox agents、realtime agents を中心に構成されています。README には、API の学習やさまざまなワークフローの実行方法を理解するための examples と documentation も案内されており、ファイルの確認、コマンド実行、パッチ適用ができる sandbox 化された作業も含まれます。

主な機能

エージェントの構成要素

指示、tools、guardrails、handoffs を使ってエージェントを構成し、JavaScript または TypeScript で段階的なワークフローを支援します。

sandbox ワークフローのサポート

ファイルシステムの workspace と sandbox 環境を備えた sandbox agents を使い、ファイルアクセスやコマンド実行が必要な長時間タスクに対応します。

エージェントの委任

タスクを専門的なステップに分割する必要がある場合に、agents を tools として使うか handoffs を使って、エージェント間で作業を委任します。

tools ベースの操作

functions、MCP、hosted tools を含む、エージェントが操作を実行できる tools を追加します。

tracing とデバッグ

組み込みの tracing でエージェント実行を追跡し、ワークフローの確認、デバッグ、最適化を行えます。

realtime 音声エージェント

README で full features を備えると説明されている Realtime Agents を使って、音声エージェントを構築します。

実用例

  • マルチエージェントのタスクオーケストレーション

    instructions、tools、handoffs を使うエージェントを構築し、複数ステップにまたがる構造化されたタスクを完了します。

  • リポジトリ対応の自動化

    実行中の workspace 状態を維持しながら、リポジトリへのアクセス、コマンド実行、パッチ適用が必要なワークフローに sandbox agents を使います。

  • 音声エージェント開発

    ワークフローでテキストのみのやり取りではなく realtime の対話が必要な場合に、Realtime Agents を使って音声対応エージェントを作成します。

  • ワークフローのデバッグと最適化

    tracing を追加してエージェントの動作を確認し、その可視性を使って時間をかけてワークフローをデバッグ・改善します。

Pros and Cons

Pros

  • JavaScript/TypeScript のマルチエージェントワークフロー向け軽量フレームワークです。
  • provider-agnostic で、OpenAI APIs などをサポートします。
  • ファイルやコマンドにアクセスできる長時間タスク向けに sandbox agents を備えています。
  • 組み込みの tracing により、デバッグと最適化を支援します。
  • 通常のエージェントと realtime 音声エージェントの両方をカバーします。

Cons

  • README では sandbox agents が beta とされています。
  • Cloudflare Workers のサポートは experimental で、`nodejs_compat` が必要です。

FAQ

SDK を使い始めるにはどうすればよいですか?

README によると、この SDK は `npm install @openai/agents zod` でインストールします。また、README に掲載されている例を実行するには `OPENAI_API_KEY` 環境変数が必要だと記載されています。

どのようなワークフロー向けに設計されていますか?

README では、このパッケージはマルチエージェントのワークフロー向け JavaScript/TypeScript SDK と説明されており、通常のエージェントと sandbox エージェントをサポートしています。また、SDK は provider-agnostic で、OpenAI APIs などをサポートするとされています。

どのランタイムをサポートしていますか?

README に記載されている対応環境は、Node.js 22 以降、Deno、Bun です。Cloudflare Workers は `nodejs_compat` を有効にした experimental 扱いとされています。

音声または realtime の用途をサポートしていますか?

はい。README では、フル機能を備えた音声エージェントを構築するための Realtime Agents が強調されており、リポジトリのトピックには `realtime-api` と `openai-api` が含まれています。

SDK に別途の製品価格はありますか?

このリポジトリは MIT ライセンスのオープンソースプロジェクトです。GitHub の料金ページには GitHub 自体の無料プランと有料プランが表示されていますが、この SDK の個別価格は記載されていません。

Quick Facts

カテゴリ
開発者ツール
言語
JavaScript / TypeScript
ソースドメイン
github.com
ライセンス
MIT
対応ランタイム
Node.js 22 以上、Deno、Bun; Cloudflare Workers は experimental
価格
オープンソース; ソースには製品の個別価格は記載されていません