Skip to main content
Le SDK CoreWeave Forge trace automatiquement les appels que vous effectuez avec le SDK Anthropic pour Python et Node.js. Une fois le traçage initialisé, chaque appel effectué dans une conversation est enregistré dans Agent Lens sous forme de span LLM, avec ses messages, ses appels d’outil, ses médias, les paramètres de la requête, l’utilisation des jetons et l’utilisation du cache de prompts. Vous n’avez rien à modifier dans votre façon d’appeler le SDK Anthropic. L’intégration trace l’API Messages, y compris le streaming, le helper de flux Messages et le parsing des sorties structurées. En TypeScript, elle trace également les appels à l’API Message Batches en tant qu’opérations d’outil.

Prérequis

  • Un compte CoreWeave Forge et une clé API définie dans la variable d’environnement WANDB_API_KEY.
  • Une clé API Anthropic définie dans la variable d’environnement ANTHROPIC_API_KEY.
  • Pour Python : Python 3.10 ou version ultérieure et anthropic 0.18.0 ou version ultérieure.
  • Pour TypeScript : Node.js 18.19 ou version ultérieure (ou 20.6 ou version ultérieure) et @anthropic-ai/sdk 0.52.0 ou version ultérieure.

Installer les paquets

Tracer les conversations Anthropic

Appelez tracing.init() avec les noms de votre équipe et de votre projet Forge. En Python, tracing.init() patche le SDK Anthropic, que vous l’importiez avant ou après l’appel. En TypeScript, démarrez Node avec l’option d’instrumentation indiquée dans l’onglet TypeScript. Agent Lens n’affiche que les appels exécutés au sein d’une conversation. Un appel effectué en dehors d’une conversation n’a pas d’ID de conversation et n’apparaît donc pas dans Agent Lens. Créez une conversation par session d’agent, puis démarrez un tour de conversation pour chaque message utilisateur. Tous les tours partagent l’ID de la conversation : Agent Lens les regroupe donc en une seule conversation, et chaque appel devient un span LLM du tour dans lequel il s’exécute.
Pour ajouter ultérieurement des tours à une conversation existante, par exemple dans une application web qui traite un tour de conversation par requête, transmettez le même conversation_id (Python) ou conversationId (TypeScript) chaque fois que vous créez la conversation. Pour en savoir plus sur les conversations, les tours de conversation et les autres types de spans, consultez Tracer vos agents.

Désactiver le patching automatique

En Python, passez autopatch_integrations=False à tracing.init(). Vous pouvez ensuite appliquer et retirer vous-même le patch du SDK Anthropic avec tracing.integrations.patch_anthropic() et tracing.integrations.unpatch_anthropic(). En TypeScript, exécutez votre code sans l’option --import=@coreweave/forge-sdk/instrument, puis encapsulez avec integrations.wrapAnthropic() uniquement les clients que vous souhaitez tracer.

Afficher vos traces

Dans CoreWeave Forge, sélectionnez Agent Lens dans le menu des produits, choisissez votre projet dans le sélecteur de projet en haut du menu latéral, puis sélectionnez Conversations. Pour plus d’informations, voir Afficher l’activité des agents.
Dernière modification le 30 septembre 2026