Skip to main content
CoreWeave Forge SDK は、Python および Node.js 向けの Anthropic SDK を使用した Call を自動的にトレースします。トレースを初期化すると、会話内の各 Call が LLM スパンとして Agent Lens に記録されます。記録には、メッセージ、ツール呼び出し、メディア、リクエスト設定、トークン使用量、プロンプトキャッシュの使用量が含まれます。Anthropic SDK の呼び出し方法を変更する必要はありません。 このインテグレーションは、ストリーミング、Messages ストリームヘルパー、構造化出力のパースを含む Messages API をトレースします。TypeScript では、Message Batches API の呼び出しもツール操作としてトレースされます。

前提条件

  • CoreWeave Forge のアカウントと、環境変数 WANDB_API_KEY に設定済みの APIキー。
  • 環境変数 ANTHROPIC_API_KEY に設定済みの Anthropic APIキー。
  • Python の場合: Python 3.10 以降、および anthropic 0.18.0 以降。
  • TypeScript の場合: Node.js 18.19 以降 (または 20.6 以降) 、および @anthropic-ai/sdk 0.52.0 以降。

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

Anthropic の会話をトレースする

Forge のチーム名と project 名を指定して tracing.init() を呼び出します。Python では、tracing.init() が Anthropic SDK にパッチを適用します。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_anthropic() と tracing.integrations.unpatch_anthropic() を使用して、Anthropic SDK へのパッチの適用と解除を自分で行えるようになります。 TypeScript では、--import=@coreweave/forge-sdk/instrument フラグを付けずに実行し、トレースしたいクライアントだけを integrations.wrapAnthropic() でラップします。

トレースを表示する

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