Passer au contenu principal
Il s’agit d’un notebook interactif. Vous pouvez l’exécuter localement ou utiliser les liens suivants :

Importer des traces depuis des systèmes tiers

Ce notebook vous montre comment importer des traces historiques de conversation à partir d’un fichier CSV dans W&B Weave afin de les analyser, de comparer le comportement des modèles et d’exécuter des évaluations sur des données générées en dehors d’une application instrumentée avec Weave. Il arrive parfois que vous ne puissiez pas instrumenter votre code Python ou JavaScript avec l’intégration Weave afin d’obtenir des traces en temps réel de votre application GenAI. Souvent, ces traces sont ensuite disponibles au format CSV ou JSON. Ce notebook utilise l’API Python de bas niveau de Weave pour extraire des données d’un fichier CSV et les importer dans Weave afin que vous puissiez les analyser et les évaluer. Le jeu de données d’exemple utilisé dans ce cookbook a la structure suivante :
Pour comprendre les choix d’import dans ce notebook, rappelez-vous que les traces Weave ont des relations parent-enfant continues de type 1:N. Cela signifie qu’un parent peut avoir plusieurs enfants, mais qu’il peut lui-même être l’enfant d’un autre parent. Ce notebook utilise conversation_id comme identifiant du parent, et turn_index comme identifiant de l’enfant afin de disposer d’une journalisation complète des conversations. Vous devez modifier les variables dans les sections suivantes pour qu’elles correspondent à votre propre jeu de données, à vos chemins de fichiers et à votre projet W&B.

Configurer l’environnement

Installez et importez tous les packages nécessaires. Définissez WANDB_API_KEY dans votre environnement afin de pouvoir vous connecter avec wandb.login() (fournissez-la à Colab comme secret). Définissez le nom du fichier que vous téléversez dans Colab dans name_of_file, et le projet W&B dans lequel vous souhaitez enregistrer dans name_of_wandb_project.
name_of_wandb_project peut aussi être au format [TEAM_NAME]/[PROJECT_NAME] pour indiquer l’équipe dans laquelle enregistrer les traces.
Ensuite, récupérez un client Weave en appelant weave.init().

Charger les données

Une fois l’environnement prêt, vous pouvez charger et structurer les données CSV afin qu’elles correspondent à la structure parent-enfant attendue par Weave. Chargez les données dans un DataFrame pandas, puis triez-les par conversation_id et turn_index pour garantir que les éléments parents et enfants sont correctement ordonnés. Vous obtenez ainsi un DataFrame pandas à deux colonnes, avec les tours de conversation regroupés dans un tableau sous conversation_data.

Enregistrer les traces dans Weave

Une fois les données structurées en conversations et en tours de conversation, l’étape suivante consiste à importer ces enregistrements dans Weave sous forme d’appels parents et enfants. Parcourez le DataFrame pandas :
  • Créez un appel parent pour chaque conversation_id.
  • Parcourez le tableau des tours de conversation pour créer des appels enfants triés selon leur turn_index.
Concepts importants de l’API Python bas niveau :
  • Un appel Weave est équivalent à une trace Weave. Cet appel peut avoir un parent ou des enfants associés.
  • Un appel Weave peut aussi avoir d’autres éléments associés, comme le feedback et les métadonnées. Cet exemple associe uniquement les inputs et l’output, mais vous pouvez ajouter ces autres éléments lors de l’importation si les données les fournissent.
  • Un appel Weave passe par les états created et finished, car il est conçu pour être suivi en temps réel. Comme il s’agit ici d’une importation a posteriori, vous créez et terminez l’appel une fois que les objets sont définis et liés entre eux.
  • La valeur op d’un appel indique comment Weave catégorise les appels de même type. Dans cet exemple, tous les appels parents sont de type Conversation et tous les appels enfants sont de type Turn. Vous pouvez modifier cela comme bon vous semble.
  • Un appel peut avoir des inputs et un output. Les inputs sont définis lors de la création, et l’output est défini lorsque l’appel est terminé.

Résultat : traces enregistrées dans Weave

À ce stade, vos données CSV ont été importées dans Weave. Vous pouvez désormais parcourir les conversations et leurs tours de conversation dans l’interface Weave, regroupés sous les opérations Conversation et Turn que vous avez définies. Traces :
Traces de conversation importées dans l’interface Weave
Opérations :
Opérations Conversation et Turn dans l’interface Weave

Facultatif : exportez vos traces pour lancer des évaluations

Une fois vos traces dans Weave et après avoir compris à quoi ressemblent les conversations, vous pouvez les exporter vers un autre processus afin d’exécuter des évaluations Weave.
Exportation de traces depuis un projet Weave
Pour ce faire, récupérez toutes les conversations à partir de W&B via l’API de requête, puis créez un jeu de données à partir de celles-ci.

Résultat

Le jeu de données exporté est désormais republié vers Weave et est prêt à être utilisé comme entrée pour une évaluation.
Jeu de données publié dans l'interface Weave, prêt à être utilisé dans une évaluation
Pour en savoir plus sur les évaluations, consultez le Démarrage rapide pour apprendre à utiliser le jeu de données que vous venez de créer afin d’évaluer votre application RAG.