OpenAI Agents SDK は、マルチエージェントワークフロー構築のための軽量で強力なフレームワークです。プロバイダーに依存しない設計で、OpenAI Responses と Chat Completions API、および 100 以上の他の LLM に対応しています。

1. エージェント：指示、ツール、ガードレール、ハンドオフで構成された LLM
2. サンドボックスエージェント：長期にわたって作業を実行するために、コンテナと連携するよう事前設定されたエージェント
3. ツールとしてのエージェント / ハンドオフ：特定のタスクを他のエージェントに委譲する
4. ツール：エージェントがアクション（関数、MCP、ホスト型ツール）を実行できるようにするさまざまなツール
5. ガードレール：入出力検証のための構成可能なセーフティチェック
6. 人間参加ループ：エージェント実行全体で人間の参加を促すための組み込みメカニズム
7. セッション：エージェント実行全体での自動会話履歴管理
8. トレーシング：エージェント実行の組み込みトラッキング。ワークフローの表示、デバッグ、最適化が可能です
9. リアルタイムエージェント：gpt-realtime-2 と全エージェント機能を備えた強力な音声エージェントを構築できます

examples ディレクトリを参照して SDK の動作を確認し、詳細はドキュメントをご覧ください。

はじめに、Python 環境を設定（Python 3.10 以上が必要）し、OpenAI Agents SDK パッケージをインストールしてください。

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install openai-agents

音声サポートについては、オプション voice グループでインストールしてください：pip install 'openai-agents[voice]'。Redis セッションサポートについては、オプション redis グループでインストールしてください：pip install 'openai-agents[redis]'。

uv に慣れている場合、パッケージのインストールはさらに簡単です：

uv init
uv add openai-agents

音声サポートについては、オプション voice グループでインストールしてください：uv add 'openai-agents[voice]'。Redis セッションサポートについては、オプション redis グループでインストールしてください：uv add 'openai-agents[redis]'。

Sandbox Agents はバージョン 0.14.0 で新機能として追加されました。サンドボックスエージェントは、設定・制御できる環境内でファイルシステムを使用して実際の作業を実行するエージェントです。サンドボックスエージェントは、エージェントがファイルを検査したり、コマンドを実行したり、パッチを適用したり、より長いタスク全体にわたってワークスペースの状態を保持する必要がある場合に有用です。

from agents import Runner
from agents.run import RunConfig
from agents.sandbox import Manifest, SandboxAgent, SandboxRunConfig
from agents.sandbox.entries import GitRepo
from agents.sandbox.sandboxes import UnixLocalSandboxClient

agent = SandboxAgent(
    name="Workspace Assistant",
    instructions="Inspect the sandbox workspace before answering.",
    default_manifest=Manifest(
        entries={
            "repo": GitRepo(repo="openai/openai-agents-python", ref="main"),
        }
    ),
)

result = Runner.run_sync(
    agent,
    "Inspect the repo README and summarize what this project does.",
    # Run this agent on the local filesystem
    run_config=RunConfig(sandbox=SandboxRunConfig(client=UnixLocalSandboxClient())),
)
print(result.final_output)

# This project provides a Python SDK for building multi-agent workflows.

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

（Jupyter ノートブックユーザーの方は、hello_world_jupyter.ipynb をご覧ください）

examples ディレクトリを探索して、SDK が実際に動作する様子を確認し、詳細については ドキュメント をお読みください。

オープンソースコミュニティの優れた活動を認めたいと考えています。特に以下の皆様に感謝します：

• Pydantic
• Requests
• MCP Python SDK
• Griffe

このライブラリには、以下のオプション依存関係があります：

• websockets
• SQLAlchemy
• any-llm と LiteLLM

また、プロジェクト管理には以下のツールを使用しています：

• uv と ruff
• mypy と Pyright
• pytest と Coverage.py
• MkDocs

我々は、Agents SDK をオープンソースフレームワークとして継続的に構築し、コミュニティの他の皆様が私たちのアプローチを拡張できるようにすることにコミットしています。