OpenAI Agents SDK は、マルチエージェントワークフローを構築するための軽量でありながら強力なフレームワークです。プロバイダーに依存しない設計で、OpenAI Responses および Chat Completions API、さらに 100 以上の他の LLM に対応しています。
注記
JavaScript/TypeScript バージョンをお探しですか？Agents SDK JS/TS をご確認ください。
- エージェント: 指示、ツール、ガードレール、ハンドオフで構成された LLM
- Sandbox エージェント: コンテナで動作するように事前構成されたエージェント。長期間にわたって作業を実行します。
- ツールとしてのエージェント / ハンドオフ: 特定のタスクのために他のエージェントに委譲します
- ツール: 様々なツールがエージェントにアクション実行機能を提供します（関数、MCP、ホストされたツール）
- ガードレール: 入力と出力の検証のための設定可能なセーフティチェック
- 人間の関与: エージェント実行全体で人間を関与させるための組み込みメカニズム
- セッション: エージェント実行全体における自動会話履歴管理
- トレーシング: エージェント実行の組み込みトラッキング。ワークフローを表示、デバッグ、最適化できます
- リアルタイムエージェント:
gpt-realtime-1.5と完全なエージェント機能を使用して強力な音声エージェントを構築できます
examples ディレクトリを確認して実践的な使用例を見たり、詳細は ドキュメント をお読みください。
まず 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 エージェント はバージョン 0.14.0 の新機能です。Sandbox エージェントは、ファイルシステムとあなたが構成・管理するコンテナ環境で実際の作業を実行するエージェントです。Sandbox エージェントは、エージェントがファイルを検査したり、コマンドを実行したり、パッチを適用したり、長期的なタスク全体でワークスペースの状態を維持する必要がある場合に便利です。
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 ディレクトリを確認して実践的な使用例を見たり、詳細は ドキュメント をお読みください。
オープンソースコミュニティ、特に以下の優れた成果に感謝します:
このライブラリの オプション依存関係は以下の通りです:
また、プロジェクト管理には以下のツールを使用しています:
私たちはコミュニティの他のメンバーが当社のアプローチを基に発展させることができるよう、Agents SDK をオープンソースフレームワークとして継続的に構築することに取り組んでいます。
