OpenAI Agents SDK (Python)

OpenAI Agents SDK (openai-agents パッケージ) を使用して AI エージェントを開発する場合は、このスキルを使用してください。

クイックリファレンス

インストール

pip install openai-agents

環境変数

# OpenAI (直接接続)
OPENAI_API_KEY=sk-...
LLM_PROVIDER=openai

# Azure OpenAI (LiteLLM 経由)
LLM_PROVIDER=azure
AZURE_API_KEY=...
AZURE_API_BASE=https://your-resource.openai.azure.com
AZURE_API_VERSION=2024-12-01-preview

基本的なエージェント

from agents import Agent, Runner

agent = Agent(
    name="Assistant",
    instructions="You are a helpful assistant.",
    model="gpt-5.4",  # or "gpt-5.4-mini", "gpt-5.4-nano"
)

# 同期実行
result = Runner.run_sync(agent, "Tell me a joke")
print(result.final_output)

# 非同期実行
result = await Runner.run(agent, "Tell me a joke")

キーパターン

パターン	目的
Basic Agent	シンプルな Q&A(指示付き)
Azure/LiteLLM	Azure OpenAI 統合
AgentOutputSchema	Pydantic による厳密な JSON 検証
Function Tools	外部アクション (@function_tool)
Streaming	リアルタイム UI (Runner.run_streamed)
Handoffs	専門化されたエージェント、委譲
Agents as Tools	オーケストレーション (agent.as_tool)
LLM as Judge	反復的改善ループ
Guardrails	入出力検証
Sessions	自動会話履歴管理
Multi-Agent Pipeline	マルチステップワークフロー
Sandboxing	エージェント用の隔離実行環境
Subagents	専門化された下位エージェントの生成 (Python + TS)
Observability	組み込みの実行グラフ記録

推奨: MCP 経由のライブドキュメント

モデル名と API の詳細は頻繁に変更されます。利用可能な場合は、以下の静的リファレンスに依存する前に、OpenAI Developer Docs MCP サーバー (openaiDeveloperDocs) を参照してください。

セットアップ (Codex CLI):

codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp

または設定ファイル (~/.codex/config.toml、VS Code .vscode/mcp.json、Cursor ~/.cursor/mcp.json):

[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.com/mcp"

主なツール: mcp__openaiDeveloperDocs__search_openai_docs、fetch_openai_doc、list_api_endpoints、get_openapi_spec。

ルール: 取得したドキュメントを引用してください。フィールド名、デフォルト値、現在のモデル ID については推測しないでください。まず取得してください。引用文は 125 文字以下に保つこと。

MCP が利用できない場合のフォールバック: https://developers.openai.com/api/docs/llms.txt (すべての API ドキュメントのプレーンテキスト索引。各エントリは /api/docs/<slug>.md に .md バージョンを持つ)。

リファレンスドキュメント

オフライン/クイックルックアップスニペット。精度が重要な場合は、モデル名と API シグネチャを MCP またはドキュメントに対して検証してください。

• agents.md - エージェント作成、Azure/LiteLLM 統合
• tools.md - 関数ツール、ホストされたツール、ツールとしてのエージェント
• structured-output.md - Pydantic 出力、AgentOutputSchema
• streaming.md - ストリーミングパターン、FastAPI での SSE
• handoffs.md - エージェント委譲
• guardrails.md - 入出力検証
• sessions.md - セッション、会話履歴
• patterns.md - マルチエージェントワークフロー、LLM as Judge、トレーシング

公式ドキュメント

• ドキュメント: https://openai.github.io/openai-agents-python/
• 例: https://github.com/openai/openai-agents-python/tree/main/examples
• メジャーアップデート: https://openai.com/index/the-next-evolution-of-the-agents-sdk/
• Docs MCP セットアップ: https://developers.openai.com/learn/docs-mcp
• ドキュメント索引 (llms.txt): https://developers.openai.com/api/docs/llms.txt
• 現在のモデル ID: https://platform.openai.com/docs/models