OpenAI Agents SDKでマルチエージェントを作る方法|副業自動化・業務効率化に使えるPythonフレームワーク

Uncategorized

「AIに全部やってもらいたい」が現実になってきた時代

「記事を書いてほしい」「競合を調査してほしい」「データを整理してほしい」——こういった依頼を、今までは自分でやるか外注するかしかありませんでした。

でも、AIエージェントの登場でその構図が変わりつつあります。

ただ、ChatGPTに一問一答するだけではどこかで限界がきます。複雑なタスクは「調査→分析→執筆→校正」のように複数のステップがあり、それぞれに専門性が必要だからです。

そこで注目されているのがマルチエージェントという設計思想です。複数のAIエージェントがそれぞれの役割を担い、連携してひとつの大きなタスクをこなす仕組みです。

これを実現するために、OpenAIが2025年に公式リリースしたのがOpenAI Agents SDKopenai-agents)です。GitHubでは公開からわずか数ヶ月で★23,000超を獲得しており、実用性の高さが伺えます。

この記事では、Agents SDKの基本から副業・業務自動化への応用まで、実際のコードを交えながら解説します。


OpenAI Agents SDKとは?主要コンセプトを整理する

OpenAI Agents SDKは、OpenAI公式が提供するマルチエージェントワークフロー構築フレームワークです。特徴をひと言でいうなら「軽量・シンプル・本番対応」。

主なコンセプト一覧

コンセプト 説明
Agents 指示・ツール・ガードレール・ハンドオフを持つLLMの単位
Handoffs タスクを別のエージェントに委譲する仕組み
Tools Python関数・MCP・ホスト型ツールを呼び出す機能
Guardrails 入出力の安全チェック機能
Sessions セッションをまたいだ会話履歴の自動管理
Tracing エージェントの実行を追跡・デバッグ
Realtime Agents gpt-realtime-1.5を使った音声エージェント
Sandbox Agents コンテナで長時間タスクを実行(v0.14.0〜)

また、OpenAI APIだけでなく100以上のLLMプロバイダーに対応しているため、コストや用途に応じてモデルを切り替えられる柔軟さも魅力です。

他のマルチエージェントフレームワークとしては、ByteDanceが開発したDeerFlowのセルフホストも注目を集めていますが、OpenAI Agents SDKはより軽量かつ公式サポートがある点で一歩リードしています。


インストールと最小構成コードで動かしてみる

まずはインストールから。通常版と音声サポート版の2種類があります。

# 通常版
pip install openai-agents

# 音声(Realtime Agent)サポートも含める場合
pip install 'openai-agents[voice]'

環境変数にOPENAI_API_KEYを設定しておけば、以下の最小コードですぐに動作します。

# 最小構成:シンプルなエージェントを動かす
from agents import Agent, Runner

agent = Agent(
    name="副業アドバイザー",
    instructions="Pythonエンジニア向けに、AIを使った副業アイデアをカジュアルに提案してください。"
)

result = Runner.run_sync(agent, "今月から始められる副業を3つ教えて")
print(result.final_output)

Agentクラスに名前と指示を渡すだけで動くシンプルさが気持ちいいですね。Runner.run_sync()は同期実行、非同期ならawait Runner.run()を使います。


ハンドオフでマルチエージェントを実現する

Agents SDKの真骨頂はハンドオフ(Handoffs)です。あるエージェントが処理の途中で「この部分は別のエージェントに任せよう」と委譲できる仕組みで、これによってタスクの分業が可能になります。

# マルチエージェント:リサーチ→執筆の連携
from agents import Agent, Runner

# 執筆担当エージェント
writer = Agent(
    name="ライター",
    instructions=(
        "渡された情報をもとに、SEOを意識した読みやすい日本語ブログ記事を書いてください。"
        "見出しはH2を使い、具体例を含めること。"
    )
)

# リサーチ担当エージェント(ライターへのハンドオフを持つ)
researcher = Agent(
    name="リサーチャー",
    instructions=(
        "指定されたテーマについて最新トレンドや具体的な事例を調査してください。"
        "調査結果がまとまったら、ライターに引き渡して記事にしてもらいます。"
    ),
    handoffs=[writer]
)

result = Runner.run_sync(researcher, "AIを使ったエンジニア副業の最新トレンドを調査して記事にして")
print(result.final_output)

このコードではresearcherが情報収集を担当し、完了したらwriterにバトンタッチします。エージェント同士が連携することで、単体では難しい複合タスクが自然にこなせるようになります。

agency-agentsとClaude Codeの連携でも紹介されているように、エージェントの役割分担はAI活用の生産性を劇的に上げる鍵です。


副業・業務自動化への具体的な活用ユースケース

「コードは動いた。じゃあ実際に何に使えるの?」という疑問に答えます。Pythonが書けるエンジニアなら、以下のユースケースはすぐに試せます。

ユースケース1:ブログ記事の自動生成パイプライン

SEOキーワードを渡すだけで「調査→構成案→本文執筆→メタ情報生成」まで自動化できます。

from agents import Agent, Runner

# メタ情報生成エージェント
meta_writer = Agent(
    name="メタライター",
    instructions="記事本文を受け取り、SEOに最適化されたtitleとmeta_descriptionを生成してください。"
)

# 本文執筆エージェント
body_writer = Agent(
    name="本文ライター",
    instructions="与えられた構成に沿って、2000文字以上の日本語技術記事を書いてください。",
    handoffs=[meta_writer]
)

# 構成案エージェント
planner = Agent(
    name="構成プランナー",
    instructions="SEOキーワードをもとに記事の見出し構成を作成してください。",
    handoffs=[body_writer]
)

# キーワードを渡すだけで全工程が自動実行される
result = Runner.run_sync(planner, "キーワード:OpenAI Agents SDK 使い方")
print(result.final_output)

副業でコンテンツSEOをやっている方にとって、このパイプラインは時間コストを大幅に削減できます。

ユースケース2:競合・市場リサーチの自動化

「特定の市場を毎朝調査してSlackに投稿」「週次でトレンドレポートを生成してメールする」といった自動化も、Agents SDKとツール(@function_toolデコレータ)を組み合わせれば実装できます。

browser-useでブラウザを自動化と組み合わせると、Webサイトの情報収集からレポート生成まで完全自動化も視野に入ります。

ユースケース3:コードレビューエージェント

OSSプロジェクトや受託開発で、「レビュアーエージェント→セキュリティチェックエージェント→修正提案エージェント」という連携も作れます。GitHub ActionsのWebhookをトリガーにすれば、PR作成と同時に自動レビューが走るパイプラインも構築可能です。

エージェントを24時間稼働させるなら

こういった自動化エージェントは、ローカルPCではなくVPSで常時稼働させるのがベストです。ConoHa VPS(月額最安クラスのVPS)なら低コストでPythonエージェントを24時間動かし続けられます。月額数百円〜のプランから始められるので、副業の初期投資としても現実的です。

n8nのセルフホスト手順を参考にVPS環境を整えれば、Agents SDKとワークフロー自動化ツールを組み合わせた強力な自動化基盤が作れます。


Guardrails・Tracing・Sessionsで本番品質を上げる

副業や業務で実際に使うとなると、品質・安全性・デバッグのしやすさが重要になります。Agents SDKにはそのための機能が揃っています。

Guardrails(ガードレール)

入力・出力の両方に安全チェックを設けられます。たとえば「有害なコンテンツが出力されたらブロックする」「個人情報が含まれる入力を拒否する」といったルールを簡単に追加できます。クライアント向けのサービスに組み込む場合は必須の機能です。

Tracing(トレーシング)

エージェントがどのステップを踏んでどんな判断をしたかを追跡できます。マルチエージェントのデバッグは単体よりも難しくなりがちですが、Tracingを使えば実行フローを可視化できます。OpenAIのダッシュボードでトレースを確認できるので、問題箇所の特定が格段に楽になります。

Sessions(セッション管理)

複数回の会話にまたがって文脈を保持する仕組みです。チャットボット型のサービスや、継続的なリサーチエージェントを作る際に役立ちます。会話履歴の管理を自前で実装する必要がなくなるため、開発コストの削減に直結します。

その他の副業・自動化に役立つOSSについては副業に使えるOSSツールもあわせてチェックしてみてください。


まとめ

OpenAI Agents SDKは、マルチエージェント開発の敷居を大きく下げた実用的なフレームワークです。

  • pip install openai-agentsだけで始められる低い導入コスト
  • ハンドオフによる柔軟な役割分担
  • Guardrails・Tracing・Sessionsによる本番品質の担保
  • 100以上のLLMに対応したプロバイダー非依存設計

Pythonが書けるエンジニアであれば、この記事で紹介したコードをそのまま動かして数時間以内に自分のユースケースに応用できるはずです。

「記事生成を自動化したい」「リサーチ作業を減らしたい」「副業の収益を上げるためにAIを活用したい」——そういった目標があるなら、まず最小構成コードを動かすことから始めてみてください。

リポジトリ: openai/openai-agents-python(GitHub)


よくある質問(FAQ)

Q. OpenAI以外のAPIキーでも使えますか?
A. はい。100以上のLLMプロバイダーに対応しています。AnthropicやGoogle、ローカルLLMなどにも接続できます。モデルの設定を切り替えるだけなので、コストに応じて使い分けが可能です。

Q. LangChainやAutoGenとの違いは何ですか?
A. Agents SDKはOpenAI公式で、より軽量・シンプルな設計が特徴です。LangChainは機能が豊富な反面、学習コストが高め。AutoGenはMicrosoftが開発したフレームワークで設計思想が異なります。まずAgents SDKから始めて、必要に応じて他を検討するのがおすすめです。

Q. 非同期処理はサポートしていますか?
A. はい。Runner.run()で非同期実行が可能です。FastAPIやasyncioと組み合わせたWebサービスへの組み込みもスムーズにできます。

Q. コストはどれくらいかかりますか?
A. Agents SDK自体は無料のOSSです。かかるコストはOpenAI APIなどLLMの利用料金のみです。テスト段階では安価なモデル(gpt-4o-miniなど)を使い、本番に移行する際により高性能なモデルに切り替える運用が現実的です。

Q. Sandbox Agentsとは何ですか?
A. v0.14.0から追加された機能で、コンテナ内でエージェントが長時間にわたる複雑な作業(コード実行・ファイル操作など)をこなせるようになります。長時間のバッチ処理や自律的なコーディングタスクに向いています。

コメント

タイトルとURLをコピーしました