Skip to main content
AutoGen est un framework de Microsoft permettant de créer des agents et des applications d’IA. Il simplifie la création de systèmes multi-agents complexes. AutoGen propose des composants pour l’IA conversationnelle (AgentChat), les fonctionnalités multi-agents de base (Core) et les intégrations avec des services externes (Extensions). AutoGen fournit également un Studio pour prototyper des agents sans code. Pour plus de détails, consultez la documentation officielle d’AutoGen.
Ce guide suppose que vous avez des connaissances de base sur AutoGen.
Weave s’intègre à AutoGen pour vous aider à tracer et à visualiser l’exécution de vos applications multi-agents. Dès que vous initialisez Weave, celui-ci suit automatiquement les interactions au sein de autogen_agentchat, autogen_core et autogen_ext. Ce guide vous explique comment configurer Weave avec AutoGen et présente des exemples complets portant sur les clients de modèles, les agents dotés d’outils, les chats de groupe, la mémoire, les flux de travail RAG, les runtimes d’agents, les flux de travail séquentiels et les exécuteurs de code. À l’issue de ce guide, vous saurez capturer des traces détaillées de vos applications AutoGen dans Weave afin de déboguer le comportement des agents, de surveiller l’utilisation des LLM et de comprendre comment les agents interagissent au sein de flux de travail complexes.

Prérequis

Avant de commencer, vous devez avoir installé AutoGen et Weave. Vous aurez également besoin des SDK des fournisseurs de LLM que vous comptez utiliser (par exemple, OpenAI ou Anthropic).
Configurez vos clés API en tant que variables d’environnement pour permettre aux clients de modèles de s’authentifier auprès des fournisseurs de LLM utilisés dans les exemples suivants :

Configuration de base

Initialisez Weave au début de votre script pour commencer à capturer les traces. Une fois initialisé, Weave instrumente automatiquement les appels AutoGen dans le reste de votre script.
Une fois cet extrait exécuté, Weave est configuré pour envoyer les traces au projet autogen-demo et capture automatiquement toute activité AutoGen ultérieure de votre script.

Traces d’un client de modèle

Les sections suivantes décrivent comment Weave trace les appels effectués directement auprès des clients de modèle dans AutoGen, notamment les appels uniques, les réponses en streaming et les réponses mises en cache.

Traces d’un appel create du client

Cet exemple montre comment tracer un appel à un OpenAIChatCompletionClient.
autogen-simple-client.png

Traces d’un appel create du client avec streaming

Weave prend également en charge le traçage des réponses en streaming.
autogen-streaming-client.png

Traces des appels client mis en cache

Vous pouvez utiliser le ChatCompletionCache d’AutoGen : Weave trace alors ces interactions et indique si une réponse provient du cache ou d’un nouvel appel.
autogen-cached-client.png

Traces d’un agent avec des appels d’outils

Cette section montre comment Weave trace les agents et leur utilisation des outils, afin de vous offrir une visibilité sur la manière dont les agents sélectionnent et exécutent les outils. L’exemple suivant définit un outil météo et le joint à un AssistantAgent.
autogen-agent-tools.png

Traces pour un GroupChat round-robin

Weave trace les interactions au sein des chats de groupe, comme RoundRobinGroupChat, ce qui vous permet de suivre le déroulement de la conversation entre les agents. Pour regrouper tous les tours de conversation des agents sous une seule trace parente et en simplifier l’inspection, encapsulez la fonction du chat de groupe avec @weave.op. Cette étape est facultative, mais recommandée.
round_robin_group_chat.png

Traces de la mémoire

Weave peut tracer les composants de mémoire d’AutoGen. Utilisez @weave.op() pour regrouper les opérations de mémoire dans une seule trace et gagner en lisibilité : les appels d’ajout et de récupération en mémoire apparaissent ainsi aux côtés du run de l’agent qui les utilise.
autogen-memory.png

Traces pour les flux de travail RAG

Weave peut tracer les flux de travail de génération augmentée par récupération (RAG), y compris l’indexation et la récupération de documents avec des systèmes de mémoire tels que ChromaDBVectorMemory. Pour visualiser l’ensemble du flux et regrouper l’indexation, la récupération et l’appel LLM qui en découle dans une seule trace, décorez le processus RAG avec @weave.op().
L’exemple RAG nécessite chromadb. Installez-le avec pip install chromadb.
autogen-rag.png

Traces pour les runtimes d’agents

Weave peut tracer les opérations au sein des runtimes d’agents d’AutoGen, comme SingleThreadedAgentRuntime. Encapsulez la fonction d’exécution du runtime avec @weave.op() afin de regrouper les traces associées et de visualiser la séquence complète des gestionnaires de messages déclenchés pendant l’exécution du runtime.
autogen-runtime.png

Traces pour les flux de travail séquentiels

Vous pouvez tracer des flux de travail d’agents complexes qui définissent des séquences d’interactions entre agents. Utilisez @weave.op() pour fournir une trace globale de l’ensemble du flux de travail, de sorte que la contribution de chaque agent soit imbriquée dans un seul appel parent. L’exemple suivant enchaîne un extracteur de concepts, un rédacteur, un agent de mise en forme et de relecture, ainsi qu’un agent utilisateur pour produire un texte marketing soigné.
autogen-sequential-workflow.png

Traces pour les exécuteurs de code

Docker requis Cet exemple fait appel à une exécution de code reposant sur Docker et peut ne pas fonctionner dans tous les environnements (par exemple, directement dans Colab). Si vous souhaitez l’essayer, assurez-vous que Docker est en cours d’exécution en local.
Weave trace la génération et l’exécution de code par les agents AutoGen. Vous pouvez examiner à la fois le code produit par un agent assistant et la sortie renvoyée par un agent exécuteur lors de l’exécution de ce code.
autogen-codegen.png

En savoir plus

Lisez les guides suivants pour mieux comprendre le traçage Weave et les ops. Ce guide constitue un point de départ pour intégrer Weave à AutoGen. Explorez l’interface de Weights & Biases pour consulter les traces détaillées des interactions de votre agent, des appels de modèle et de l’utilisation des outils.
Dernière modification le 30 septembre 2026