SDK TypeScript

​

Installation et importation

npm install @coreweave/forge-sdk

import {tracing, integrations} from '@coreweave/forge-sdk/agentlens';

​

Avant de tracer

• tracing.init() prend un nom entity/project et lit votre clé API dans la variable d’environnement WANDB_API_KEY, sauf si vous transmettez apiKey.
• Encapsulez chaque requête ou run d’agent dans tracing.runIsolated(). L’état du traçage est limité à ce callback, y compris au-delà des await, et les fonctions start*() lèvent une exception si aucune portée n’est active.
• Pour tracer automatiquement les appels OpenAI, Anthropic ou Google Gen AI, démarrez Node.js avec le préchargement du SDK, ou encapsulez chaque client avec une fonction wrap*() de la section Intégrations :
  node --import=@coreweave/forge-sdk/instrument app.mjs
  

import {tracing} from '@coreweave/forge-sdk/agentlens';

await tracing.init('[ENTITY]/[PROJECT]');

await tracing.runIsolated(async () => {
  const conversation = tracing.startConversation({agentName: 'research-agent'});
  const turn = conversation.startTurn({userMessage: 'What is the weather in Tokyo?'});
  try {
    // Appelez votre modèle et vos outils ici.
  } finally {
    turn.end();
    conversation.end();
  }
});

await tracing.shutdown();

​

Fonctions

• endConversation() : termine la Conversation en cours.
• endLLM() : termine le LLM en cours.
• endTurn() : termine le Turn en cours.
• forceFlush()
• getCurrentConversation()
• getCurrentLLM()
• getCurrentTurn()
• init()
• runIsolated() : attribue à une requête ou à un run d’agent son propre état de traçage, y compris à travers les await.
• shutdown()
• startConversation() : démarre une nouvelle Conversation et la définit comme conversation en cours.
• startLLM() : démarre un span LLM en tant qu’enfant du Turn en cours.
• startSubagent() : démarre un span SubAgent.
• startTool() : démarre un span Tool.
• startTurn() : démarre un nouveau Turn.

​

Classes

• Conversation : une Conversation regroupe des objets Turn sous un même gen_ai.conversation.id.
• LLM : un appel LLM.
• SubAgent
• Tool : un appel d’outil.
• Turn : un appel d’agent.

​

Interfaces

• ConversationInit
• LLMInit
• Message
• Reasoning
• SubAgentInit
• ToolEndOptions
• ToolInit
• TracingInitOptions
• TurnInit
• Usage

​

Alias de type

• JsonObject : un objet dont les propriétés sont représentables en JSON.
• JsonValue : une valeur représentable en JSON.
• MessagePart : une partie de message dans le modèle de parties des conventions sémantiques GenAI.
• Modality
• Role

​

Intégrations

• instrumentAnthropic()
• instrumentGoogleGenAI() : enregistre l’instrumentation automatique ESM et CommonJS pour @google/genai.
• instrumentOpenAI()
• patchAnthropicModule() : applique l’intégration Anthropic au namespace d’un module ESM.
• patchGoogleGenAIModule() : applique l’intégration Google Gen AI à un namespace ESM ou CommonJS.
• patchOpenAIModule() : applique l’intégration OpenAI au namespace d’un module ESM.
• wrapAnthropic() : encapsule explicitement un client Anthropic.
• wrapGoogleGenAI() : encapsule explicitement un client Google Gen AI.
• wrapOpenAI() : encapsule explicitement un client OpenAI.