Skip to main content
CoreWeave Forge SDK は、Python および Node.js 向けの OpenAI SDK による Call を自動的にトレースします。トレースを初期化すると、会話内の各 Call が LLM スパンとして Agent Lens に記録されます。記録内容には、メッセージ、ツール呼び出し、リクエスト設定、トークン使用量 (キャッシュされたトークンや推論トークンを含む) が含まれます。OpenAI SDK の呼び出し方法を変更する必要はありません。 このインテグレーションでは、チャット補完 (ストリーミングを含む) 、構造化出力のパース、Responses API (ストリーミングを含む) 、画像生成をトレースできます。

前提条件

  • CoreWeave Forge アカウント、および環境変数 WANDB_API_KEY に設定済みの APIキー。
  • 環境変数 OPENAI_API_KEY に設定済みの OpenAI APIキー。
  • Python の場合: Python 3.10 以降、および openai 1.99.9 以降。
  • TypeScript の場合: Node.js 18.19 以降 (または 20.6 以降) 、および openai 4.0.0 以降。

パッケージをインストールする

OpenAI の会話をトレースする

Forge のチーム名と project 名を指定して tracing.init() を呼び出します。Python では、OpenAI SDK をインポートするのが tracing.init() の呼び出しの前でも後でも、tracing.init() によって SDK にパッチが適用されます。TypeScript では、TypeScript タブに示すインストルメンテーションフラグを指定して Node を起動します。 Agent Lens に表示されるのは、会話内で実行された Call のみです。会話の外で行われた Call には会話 ID がないため、Agent Lens には表示されません。エージェントセッションごとに会話を 1 つ作成し、ユーザーメッセージごとにターンを開始してください。すべてのターンが会話の ID を共有するため、Agent Lens はそれらのターンを 1 つの会話にまとめます。また、各 Call は、それが実行されたターンの LLM スパンになります。
リクエストごとに 1 つのターンを処理する Web アプリなどで、既存の会話に後からターンを追加するには、会話を作成するたびに同じ conversation_id (Python) または conversationId (TypeScript) を渡します。 会話、ターン、その他のスパンタイプの詳細については、エージェントをトレースするを参照してください。

自動パッチ適用を無効にする

Python では、tracing.init() に autopatch_integrations=False を渡します。その後は、tracing.integrations.patch_openai() と tracing.integrations.unpatch_openai() を使用して、OpenAI SDK へのパッチの適用と解除を手動で行えます。 TypeScript では、--import=@coreweave/forge-sdk/instrument フラグを指定せずに実行し、トレースしたいクライアントだけを integrations.wrapOpenAI() でラップします。

トレースを表示する

CoreWeave Forge でプロダクトメニューから Agent Lens を選択し、サイドメニュー上部の project セレクターで対象の project を選択してから、Conversations を選択します。詳細については、エージェントのアクティビティを表示するを参照してください。
最終更新日 2026年9月30日