OpenAI Agents SDK

OpenAI Agents SDK は、本番エージェント向けの OpenAI 公式 Python / TypeScript ランタイムです。Swarm 実験の強化後継です。2026-08-17 に Python ドキュメント を再確認: 中核は今も Agents、ハンドオフ（agents-as-tools を含む）、ガードレール、セッション、トレーシングです。新しい公式ページはサンドボックスエージェント、gpt-realtime-2.1 のリアルタイムエージェント、音声エージェント、MCP サーバツール、ヒューマンインザループを追加しています。

インストールは pip install openai-agents または npm install openai-agents。Hello world は from agents import Agent, Runner のあと Runner.run_sync(.) です。

主な機能

• Agents: 指示・ツール・設定を持つ LLM。
• Handoffs / agents-as-tools: 専門家へ渡すか、別エージェントをツールとして呼ぶ。
• Guardrails: エージェントループと並行する入出力チェック。
• Sessions + tracing: 会話を残し、実行を見る。LangSmith、Langfuse、AgentOps も接続できる。
• サンドボックス、リアルタイム、音声、MCP、HITL: Swarm 期の面の上に、現行ドキュメントがこれらを載せる。

使用シナリオ

• 公式の薄いランタイムが欲しい OpenAI 前提の本番エージェント。
• 自前ルータではなくハンドオフで組む専門家システム。
• 公式タイプが付いた音声 / リアルタイムループ。

制約: グラフランタイムではありません。耐久チェックポイントと手描き状態機械が必要なら LangGraph を使ってください。

料金

はじめに

1. Python ドキュメント を読む。
2. pip install openai-agents。
3. Agent を作り、Runner.run_sync(agent, "Hello")。
4. 出荷前にガードレールとセッションを足す。

よくある質問

これは Swarm ですか？

本番向けの後継であり、教育用実験そのものではありません。

Python だけですか？

いいえ。TypeScript もあります（npm install openai-agents）。

OpenAI 以外のモデルは使えますか？

OpenAI 互換プロバイダなら使えます。

代替案

• LangGraph: 耐久グラフと HITL を第一級ランタイムとして扱う。
• CrewAI: ロールベースのマルチエージェント。
• Google ADK: Google のエージェント枠。

ヒント

1. エージェントは小さく保ち、ハンドオフする。神エージェントを育てない。
2. 最初の本番障害の前にトレーシングを入れる。
3. リアルタイムとサンドボックスのページを再確認する。初稿のあと面が動いています。

まとめ

Agents SDK は今も公式で薄い OpenAI エージェントランタイムです。エージェント、ハンドオフ、ガードレール、セッション、トレーシングに加え、サンドボックス、リアルタイム、音声、MCP、HITL があります。ドキュメント から始め、グラフが必要なら LangGraph と比べてください。