Skip to main content
Ouvrir dans Colab Ce guide vous explique comment utiliser Weave pour surveiller et tracer des applications multi-agents CrewAI, qu’il s’agisse de Crews ou de Flows. CrewAI est un framework Python permettant de créer des agents d’IA autonomes. Indépendant de LangChain et des autres frameworks d’agents, il prend en charge deux abstractions : les Crews, de haut niveau, et les Flows, de bas niveau. Les applications CrewAI se composent souvent de plusieurs agents qui travaillent ensemble ; il est donc essentiel de comprendre comment ils collaborent et communiquent. Weave capture automatiquement les traces de vos applications CrewAI pour vous permettre de surveiller et d’analyser les performances et les interactions de vos agents. Les sections suivantes expliquent comment tracer un Crew, suivre l’utilisation des outils, tracer un Flow et encapsuler une fonction de garde-fou sous forme d’op Weave.

Premiers pas avec Crew

Pour exécuter cet exemple, installez CrewAI et Weave. Pour en savoir plus sur l’installation de CrewAI, consultez le guide d’installation de CrewAI.
L’exemple suivant crée une Crew CrewAI et trace son exécution avec Weave. Pour activer le traçage, appelez weave.init() au début de votre script. L’argument passé à weave.init() correspond au nom du projet dans lequel Weave journalise les traces.
Weave suit et journalise tous les appels passant par la bibliothèque CrewAI, notamment les interactions des agents, les exécutions de tâches et les appels LLM. Vous pouvez consulter les traces dans l’interface web de Weave. crew_trace.png
CrewAI fournit plusieurs méthodes pour mieux contrôler le processus de lancement : kickoff(), kickoff_for_each(), kickoff_async() et kickoff_for_each_async(). L’intégration prend en charge la journalisation des traces issues de toutes ces méthodes.

Suivre les outils

Les outils CrewAI dotent les agents de capacités telles que la recherche sur le web, l’analyse de données, la collaboration et la délégation de tâches entre collègues. L’intégration en assure également le traçage. L’exemple suivant améliore la qualité du rapport généré dans l’exemple précédent en donnant à l’agent accès à un outil capable d’effectuer des recherches sur Internet et de renvoyer les résultats les plus pertinents. Commencez par installer la dépendance supplémentaire :
Cet exemple utilise l’outil SerperDevTool pour permettre à l’agent ‘Research Analyst’ de rechercher des informations pertinentes sur Internet. Pour en savoir plus sur cet outil et ses exigences en matière d’API, consultez la documentation de SerperDevTool.
Si vous exécutez ce Crew avec un agent disposant d’un accès à Internet, vous obtenez un résultat plus pertinent. Weave trace automatiquement l’utilisation des outils, comme le montre l’image suivante. crew_with_tool_trace.png
L’intégration patche automatiquement tous les outils disponibles dans le dépôt crewAI-tools.

Premiers pas avec Flow

L’exemple suivant définit un Flow CrewAI et le trace avec Weave. Comme pour les Crews, appelez weave.init() avant de définir le Flow afin que Weave capture automatiquement le point d’entrée Flow.kickoff ainsi que les décorateurs @start, @listen, @router, @or_ et @and_.
flow.png
L’intégration patche automatiquement le point d’entrée Flow.kickoff ainsi que tous les décorateurs disponibles (@start, @listen, @router, @or_ et @and_).

Garde-fou Crew : suivre vos propres ops

Les garde-fous de tâche vous permettent de valider et de transformer les sorties d’une tâche avant que CrewAI ne les transmette à la tâche suivante. Vous pouvez utiliser une fonction Python pour valider à la volée l’exécution de l’agent. Encapsuler la fonction de garde-fou avec @weave.op permet de capturer ses entrées, ses sorties et la logique de l’application, afin que vous puissiez déboguer la manière dont les données sont validées à travers vos agents. Le code est également versionné automatiquement au fil de vos expériences, ce qui permet de capturer les modifications ponctuelles qui n’ont pas encore été commitées dans git. L’exemple suivant étend le Crew composé d’un analyste de recherche et d’un rédacteur en y ajoutant un garde-fou qui valide la longueur du rapport généré.
En décorant la fonction garde-fou avec @weave.op, vous pouvez suivre ses entrées et sorties, ainsi que son temps d’exécution, les informations sur les jetons si la fonction utilise un LLM, la version du code, et bien plus encore. guardrail.png

Conclusion

Vous disposez maintenant d’une application CrewAI tracée avec Weave, qui capture les interactions entre agents, l’utilisation des outils, l’exécution des Flows et les validations des garde-fous. Pour suggérer des améliorations ou signaler des problèmes concernant cette intégration, ouvrez une issue sur GitHub. Pour en savoir plus sur la création de systèmes multi-agents avec CrewAI, consultez les exemples et la documentation de CrewAI.
Dernière modification le 30 septembre 2026