OpenAI Agents SDK のエージェントを Weave でトレースする
- Python
- TypeScript
Weave SDK は OpenAI Agents SDK for Python に自動でパッチを適用するため、最小限の設定でエージェントのトレースを取得できます。このガイドでは、Weave を初期化したうえで、OpenAI Agents SDK で構築したマルチターンのリサーチエージェントを実行し、セッション全体を通じて発生するすべてのエージェント呼び出し、Call、ツール呼び出しを Weave で取得する方法を説明します。
前提条件
開始する前に、以下を用意してください。WANDB_API_KEY環境変数として設定した W&B アカウントと APIキー。- OpenAI APIキー。
- Python 3.10+。
パッケージをインストールする
コードで Weave を初期化する
- Python
- TypeScript
project に この例では、1 つの会話内で 3 つのターンを実行します。最初の 2 つのターンでは Wikipedia のルックアップがトリガーされ、3 つ目では、それまでの会話コンテキストを使用して、ツール呼び出し なしで summary を生成します。
weave.init を追加し、W&B のチーム名と project 名を指定してから、通常どおりエージェントを構築します。次のコードでは、wikipedia_search 関数ツールと Research assistant エージェントを定義し、Weave がトレースを取得しながら、OpenAI Agents SDK の Runner で 3 つの質問を実行します。Runner.run を呼び出すたびに、前回の result の input list を次の request として渡すことで、会話を継続します。Agents ビューでエージェントのトレースを確認する
weave.init() によって project へのリンクが出力されます。Agents ビューを開くと、次の内容を確認できます。
- 会話のターンを含むセッション。
- 各ターンは
invoke_agentspan として表示され、その子要素としてchatとexecute_toolがネストされています。 - 各ステップでの入力全体、モデル、出力、トークン使用量、ツールの実行結果。