Skip to main content
Le SDK OpenAI Agents est un framework léger qui permet de créer des agents et des flux de travail multi-agents à partir de l’API d’OpenAI. CoreWeave Agent Lens trace automatiquement les agents créés avec le SDK OpenAI Agents, notamment chaque appel d’agent, chaque transfert vers un sous-agent, chaque appel de modèle et chaque appel d’outil.
This integration uses the Weights & Biases Weave SDK (weave), because the CoreWeave Forge SDK doesn’t support this framework yet. Traces you send with Weave appear in Agent Lens, because both products share the same trace data.

Tracer des agents du SDK OpenAI Agents avec Agent Lens

Le SDK Weave patche automatiquement le SDK OpenAI Agents pour Python, ce qui vous permet de capturer les traces de vos agents avec une configuration minimale. Ce guide explique comment initialiser Weave, puis exécuter un agent de recherche sur plusieurs tours de conversation conçu avec le SDK OpenAI Agents, afin qu’Agent Lens capture chaque appel d’agent, appel de modèle et appel d’outil tout au long de la session.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :
  • Un compte CoreWeave Forge et une clé API définie dans la variable d’environnement WANDB_API_KEY.
  • Une clé API OpenAI.
  • Python 3.10+.

Installer les packages

Installez les packages suivants dans votre environnement de développement pour que Weave et le SDK OpenAI Agents soient disponibles dans votre script.

Initialiser Agent Lens dans votre code

Ajoutez weave.init au projet en indiquant les noms de votre équipe et de votre projet Forge, puis créez votre agent comme d’habitude. Le code suivant définit un outil fonction wikipedia_search et un agent Research assistant, puis soumet trois questions au Runner du SDK OpenAI Agents pendant qu’Agent Lens capture la trace. Chaque appel à Runner.run démarre sa propre trace ; l’exemple transmet donc à chaque appel un RunConfig contenant un group_id partagé. Weave utilise group_id pour regrouper les traces d’une même conversation et, lorsqu’aucun group_id n’est défini, se rabat sur l’ID propre à chaque trace.
L’exemple enchaîne trois tours de conversation au sein d’une même conversation. Les deux premiers tours de conversation déclenchent des recherches sur Wikipédia, tandis que le troisième s’appuie sur le contexte déjà établi dans la conversation pour produire une synthèse sans appel d’outil. Chaque appel à Runner.run poursuit la conversation en transmettant la liste d’entrées du résultat précédent comme requête suivante, et réutilise le même group_id afin qu’Agent Lens regroupe les trois tours de conversation en une seule conversation dans l’onglet Conversations. Sans group_id commun, chaque tour de conversation se rabat sur son propre ID de trace et apparaît comme une conversation distincte.

View your traces in Agent Lens

After the script runs, weave.init() prints a link to your project in Weave. The same traces appear in Agent Lens, because both products share the same trace data. To view them in Agent Lens:
  1. Navigate to CoreWeave Forge and select Agent Lens from the product menu.
  2. Select your project.
  3. In the Agent Lens side menu, select Conversations, and then select your conversation.
Each turn renders as an invoke_agent span with nested chat and execute_tool spans. Each span shows its input, model, output, token usage, and tool results. For more information, see View agent activity.
Dernière modification le 30 septembre 2026