OpenAI Swarm：引き継ぎの教材として有用だが、本番システムの土台ではない
OpenAI Swarm は Agent と handoff という小さな抽象で、複数エージェントの連携を説明する実験・教育目的の Python プロジェクトです。公式 README は OpenAI Agents SDK に置き換えられ、本番用途は移行するよう明記しています。
GitHub リポジトリはアーカイブされていませんが、正式 Releases はなく、2026年4月の確認可能な更新は主に依存関係の固定でした。『未アーカイブ』は『本番推奨』を意味しません。
価値は短い実装から引き継ぎ、関数呼び出し、共有変数、実行ループを読めることです。永続状態、認可、承認、監査、再開、障害復旧は自分で設計する必要があります。
現在の位置づけと確認事項
| 確認項目 | 確認できた事実 | 判断への影響 |
|---|---|---|
| 公式位置づけ | experimental / educational | 新規本番には使わない |
| 後継 | OpenAI Agents SDK | 移行先として公式推奨 |
| 配布 | 正式 Releases なし | Git コミットと依存を固定 |
| 不足 | 永続性、認可、承認、監査 | 外部基盤で実装が必要 |
Swarm のコードが動くことと、障害・重複実行・権限・機密情報を管理できることは別問題です。教材の簡潔さを本番の完成度と混同しないでください。
実務での評価手順
- 現在の Swarm の経路、ツール、共有状態を一覧にする。
- 同じ役割を Agents SDK の agent、handoff、guardrail、tracing に対応づける。
- 成功、誤経路、循環、タイムアウト、部分失敗を固定課題で試す。
- 書き込み操作には確認、べき等キー、再試行上限を置く。
- 機密情報を tracing へ送らないよう伏字と保持期間を決める。
- 少量の処理を並走させ、品質・費用・復旧時間を比較して移行する。
| 評価軸 | 測定方法 | 合格条件 |
|---|---|---|
| 経路 | 正しい specialist への到達率 | 誤経路と循環が基準以下 |
| 安全 | 権限外操作と秘密漏えいを試験 | 重大事故ゼロ |
| 復旧 | 途中失敗からの再開 | 重複せず復旧可能 |
| 観測 | handoff、tool、費用を trace | 原因を追跡できる |
制約と失敗しやすい点
エージェント間の自然言語引き継ぎは、型付き業務状態より曖昧です。重要値は明示的な schema と保存先を持たせます。
ツールを実行できる Agent には最小権限を与え、支払い、メール、削除には人の承認を置きます。
循環や長い再試行は費用と遅延を増やします。最大ターン、停止理由、予算を設定します。
Chat Completions 前提の教材を、現在の API や Agents SDK の保証と同一視しないでください。
代替案との比較
| 選択肢 | 向いている用途 | 主な注意点 |
|---|---|---|
| Swarm | handoff の学習と小さな実験 | 本番統制を持たない |
| OpenAI Agents SDK | OpenAI 系の本番 agent と tracing | 移行作業が必要 |
| LangGraph | 長期状態、分岐、再開 | 設計と運用が重い |
| 決定的ワークフロー | 順序と責任が固定された業務 | 柔軟性は低いが予測しやすい |
Swarm は捨てるべき教材ではありません。少ないコードで handoff の仕組みを理解する用途には今も優れています。
ただし本番採用の選択肢ではなく、既存実験を Agents SDK や別の管理基盤へ移すための読みやすい参照実装として扱うのが妥当です。
よくある質問
廃止されましたか？
リポジトリは未アーカイブですが、公式 README は Agents SDK へ置き換えられたと明記します。
本番で使えますか？
公式は本番用途の移行を推奨しています。
何を学べますか？
Agent、handoff、関数呼び出し、共有変数、実行ループです。
正式リリースはありますか？
確認時に GitHub Releases はありませんでした。
移行先は？
OpenAI を中心に使うなら Agents SDK が公式の第一候補です。
最大の安全課題は？
権限のあるツール、循環、重複実行、秘密情報の trace です。
確認した資料
- 参照資料 1: github.com/openai/swarm
- 参照資料 2: github.com/openai/swarm/blob/main/README.md
- 参照資料 3: github.com/openai/swarm/blob/main/swarm/core.py
- 参照資料 4: github.com/openai/swarm/commits/main/
- 参照資料 5: github.com/openai/swarm/releases
- 参照資料 6: github.com/openai/swarm/blob/main/LICENSE
- 参照資料 7: openai.github.io/openai-agents-python/quickstart/
- 参照資料 8: openai.github.io/openai-agents-python/handoffs/
- 参照資料 9: openai.github.io/openai-agents-python/context/
- 参照資料 10: openai.github.io/openai-agents-python/guardrails/
- 参照資料 11: openai.github.io/openai-agents-python/running_agents/
- 参照資料 12: openai.github.io/openai-agents-python/tracing/
- 参照資料 13: docs.langchain.com/oss/python/langgraph/overview
- 参照資料 14: microsoft.github.io/autogen/stable/user-guide/agentchat-user-guide/index.html
- 参照資料 15: microsoft.github.io/autogen/stable/user-guide/core-user-guide/design-patterns/handoffs.html
- 参照資料 16: docs.crewai.com
独立確認日：2026年8月21日。README、Agents SDK 文書、最新コミットを確認しました。
