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. Weave 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. Weave affiche les données capturées dans la vue Agents de votre projet.

Tracer les agents du SDK OpenAI Agents avec Weave

Le SDK Weave patche automatiquement le SDK OpenAI Agents pour Python. Vous pouvez ainsi capturer les traces de vos agents avec une configuration minimale. Ce guide explique comment initialiser Weave, puis exécuter sur plusieurs tours de conversation un agent de recherche créé avec le SDK OpenAI Agents. Weave capture ainsi 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 ou version ultérieure.

Installer les paquets

Installez les paquets suivants dans votre environnement de développement afin que votre script puisse accéder à Weave et au SDK.

Initialiser Weave dans votre code

Ajoutez weave.init au projet, en indiquant les noms de votre équipe et de votre projet CoreWeave Forge, puis créez votre agent comme d’habitude. Le code suivant définit un outil de fonction wikipedia_search et un agent Research assistant, puis soumet trois questions au Runner du SDK OpenAI Agents pendant que Weave capture la trace.
L’exemple enchaîne trois tours de conversation au sein d’une seule et même conversation. Les deux premiers tours déclenchent des recherches sur Wikipédia, et le troisième s’appuie sur le contexte déjà accumulé 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 nouvelle requête.

Consulter les traces de votre agent dans la vue Agents

Une fois le script exécuté, weave.init() affiche un lien vers votre projet. Ouvrez la vue Agents pour examiner :
  • Une session regroupant les tours de conversation.
  • Chaque tour de conversation, représenté par un span invoke_agent contenant des spans enfants imbriqués chat et execute_tool.
  • L’entrée complète, le modèle, la sortie, l’utilisation des jetons et les résultats des outils à chaque étape.
Pour en savoir plus sur l’affichage des données Agents dans Weave, consultez Afficher l’activité des agents.
Dernière modification le 30 septembre 2026