OpenAI Agents SDK のトレーシングシステムは、AIワークフローの可視性を提供し、重要なイベントをキャプチャすることで、開発者がアプリケーションを効果的に監視およびデバッグできるようにします。
OpenAI Agents SDKとは？
OpenAI Agents SDKは、AIエージェント開発を簡素化するPythonツールキットです。これはOpenAIのSWARMプロジェクトのプロダクション対応の進化版であり、インテリジェントで協調的かつ安全なAIシステムを構築するための機能を提供します。その中核には、特定の指示とツールで設定可能なLLMベースのエージェントがあり、カスタムロールをサポートし、OpenAIモデル（o1、o3-mini、gpt-4o）とOpenAI互換APIを持つサードパーティモデルの両方と互換性があります。
OpenAI Agents SDKの主要機能
ツールと機能拡張：
- Function Calling :
@function_toolデコレータを使用してPython関数をツールに変換し、自動スキーマ生成とPydantic検証を提供します。 - Built-in Agent Loop : ツール呼び出し、結果フィードバック、タスクループを処理し、エージェントとLLM間のシームレスな対話を実現します。
- Task Handoffs : エージェントが他の専門エージェントにタスクを委任できるようにし、マルチエージェントコラボレーションを可能にします。
セキュリティと監視メカニズム：
- Guardrails : 入力スクリーニングにより有害なコンテンツを防止し、出力検証により応答品質と適切性を確保します。
- Tracing Tools : 組み込みのトレーシング機能によりエージェントフロー全体を可視化および監視し、デバッグと最適化を支援します。
開発者向け機能：
- Python-Native Methods : Python言語機能を活用してエージェントのオーケストレーションとチェイニングを行い、新しい抽象化の学習を最小限に抑えます。
- Highly Customizable : カスタムツール、構造化出力タイプ、外部LLMプロバイダー統合機能を提供します。
- Lightweight Design : シンプルかつ強力なプリミティブセットで、学習曲線が最小限です。
OpenAI Agents SDKの利点
開発効率
- セットアッププロセスを簡素化し、エージェントアプリケーション開発を効率化し、AIエージェント開発への参入障壁を低減します。
システム機能の強化 ：
- 複雑なタスク実行と効率的なマルチエージェントコラボレーションをサポートします。
- 専門化された協調システムを作成し、複雑な問題を解決します。
- 外部LLMモデルを統合し、より高い柔軟性を実現します。
セキュリティと信頼性 ：
- Guardrailsにより安全なAIインタラクションを確保します。
- AIエージェントシステムの信頼性と適切な動作を強化します。
- AIエージェントアプリケーションを本番環境に準備するプロセスを簡略化します。
分析と最適化 ：
- トレーシングシステムがエージェントの動作に関する洞察を提供します。
- ユーザーパターン分析とボトルネック特定を改善します。
- デバッグとワークフロー最適化機能を強化します。
OpenAI Agents SDKの例
ステップ1：エージェントのセットアップ
仮想アシスタント「 AccountingAssistant 」を作成し、その機能に関する明確な指示を与えてエージェントを初期化します。
ステップ2：ツールの統合
以下の必須ツールを統合します：
- Web Search Tool：税務最新情報を取得。
- API Calls：財務諸表を分析。
- File Search Tool：関連ドキュメントを検索。
ステップ3：タスクの定義
ワークフローを個別のタスクに分解します：
- タスク1：最新の税務情報を取得。
- タスク2：APIを使用して財務データを分析。
- タスク3：最新データに基づいてレポートを生成。
ステップ4：タスクの実行
タスクを逐次または並行して実行します。例：
Runner.run_sync(agent, "Generate a report based on the latest tax laws and financial data.")
ステップ5：監視とデバッグ
トレーシングツールを使用してタスクの実行を監視し、潜在的な問題を特定してデバッグします。
Novita AIをOpenAI Agents SDKと統合する方法
1. Python環境をセットアップし、Agents SDKをインストールします。
python -m venv env
source env/bin/activate
pip install openai-agents
2. Novita APIキーを設定します。
3. ハンドオフの例
import os
from openai import AsyncOpenAI
from agents import (
Agent,
Runner,
set_default_openai_api,
set_default_openai_client,
set_tracing_disabled,
)
BASE_URL = "https://api.novita.ai/v3/openai"
API_KEY = os.getenv("NOVITA_API_KEY")
MODEL_NAME = os.getenv("MODEL_NAME")
# Because Novita not support the responses API so we use the chat completions API instead.
set_default_openai_api("chat_completions")
set_default_openai_client(AsyncOpenAI(base_url=BASE_URL, api_key=API_KEY))
# Disable tracing for this example
# Refer to https://openai.github.io/openai-agents-python/tracing/#external-tracing-processors-list to use the custom spans.
set_tracing_disabled(disabled=True)
agent = Agent(name="Assistant",
instructions="You are a helpful assistant", model=MODEL_NAME)
result = Runner.run_sync(
agent, "Write a haiku about recursion in programming.")
print(result.final_output)
# Code within the code,
# Functions calling themselves,
# Infinite loop's dance.
柔軟なトレーシング機能により、開発者は組み込み機能とサードパーティ統合の両方を通じてエージェントの動作を追跡し、パフォーマンスと信頼性を確保できます。
よくある質問
OpenAI Agents SDKではどのLLMモデルを使用できますか？
OpenAIモデル（o1、o3-mini、gpt-4o）およびNovita AIのようなOpenAI互換APIを持つサードパーティモデルと互換性があります。
OpenAI Agents SDKはツール統合をどのように処理しますか？
@function_tool デコレータを使用してPython関数をツールに変換し、自動スキーマ生成とPydantic検証を提供します。
OpenAI Agents SDKは本番環境に適していますか？
はい、Guardrails、包括的なトレーシング、監視機能などのセキュリティ機能を備えています。
Novita AI は、開発者がシンプルなAPIを使用してAIモデルを簡単にデプロイできるAIクラウドプラットフォームであり、手頃で信頼性の高いGPUクラウドを提供して、構築とスケーリングを支援します。
