前提条件
- CoreWeave Forge のアカウントと、環境変数
WANDB_API_KEYに設定済みの APIキー。 - 環境変数
ANTHROPIC_API_KEYに設定済みの Anthropic APIキー。 - Python の場合: Python 3.10 以降、および
anthropic0.18.0 以降。 - TypeScript の場合: Node.js 18.19 以降 (または 20.6 以降) 、および
@anthropic-ai/sdk0.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 スパンになります。
- Python
- TypeScript
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() でラップします。