Skip to main content
OpenAI Agents SDK は、OpenAI の API 上でエージェントやマルチエージェントのワークフローを構築するための軽量なフレームワークです。Weave は、OpenAI Agents SDK で構築されたエージェントを自動的にトレースし、各エージェントの invocation、サブエージェントへのハンドオフ、モデルの Call、ツール呼び出しを記録します。取得したデータは、プロジェクトの Agents ビューに表示されます。

Weave で OpenAI Agents SDK のエージェントをトレースする

Weave SDK は OpenAI Agents SDK for Python に自動でパッチを適用するため、最小限のセットアップでエージェントのトレースを取得できます。このガイドでは、Weave を初期化したうえで、OpenAI Agents SDK で構築したマルチターンのリサーチエージェントを実行し、セッション全体のすべてのエージェントの invocation、モデルの Call、ツール呼び出しを Weave で取得する方法を説明します。

前提条件

開始する前に、以下を用意してください。
  • CoreWeave Forge アカウントと、WANDB_API_KEY 環境変数に設定した APIキー。
  • OpenAI APIキー。
  • Python 3.10 以降。

パッケージのインストール

Weave と SDK をスクリプトで利用できるように、開発環境に以下の packages をインストールしてください。

コードで Weave を初期化する

weave.init を project に追加し、CoreWeave Forge のチーム名と project 名を指定してから、通常どおりエージェントを構築します。以下のコードは wikipedia_search 関数ツールと Research assistant エージェントを定義し、OpenAI Agents SDK の Runner を通じて3つの質問を実行します。その間、Weave がトレースを取得します。
この例では、1つの会話で3つのターンを実行します。最初の2つのターンはWikipediaルックアップをトリガーし、3つ目は前の会話コンテキストを使用して、ツール呼び出しなしで要約を生成します。Runner.run への各呼び出しは、前の結果の入力リストを次のリクエストとして渡すことで会話を継続します。

Agents ビューでエージェントのトレースを確認する

スクリプトを実行すると、weave.init() によって project へのリンクが出力されます。Agents ビューを開くと、次の内容を確認できます。
  • 会話のターンを含むセッション
  • invoke_agent スパンとしてレンダリングされた各ターン (子として chat と execute_tool がネストされます)
  • 各ステップの入力、モデル、出力、トークン使用量、ツール結果の全容
Weave で Agents データを表示する方法の詳細については、エージェントのアクティビティを表示するを参照してください。
最終更新日 2026年9月30日