Pourquoi le traçage est nécessaire pour les agents
Les agents effectuent plusieurs appels au LLM et aux outils par requête : sans traces, vous avancez à l’aveugle.
Pourquoi le traçage est nécessaire pour les agents est une leçon AI Agents gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage AI Agents, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours AI Agents comprend 4 leçons au total.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
Les agents sont difficiles à déboguer
Un seul message utilisateur peut déclencher 10 appels à LLM, 5 appels d’outils et 30 secondes de latence. Quand quelque chose se passe mal, « l’agent a donné une réponse étrange » ne vous apprend rien.
Le traçage vous permet de voir ce qui s’est réellement passé.
Ce qu’une trace enregistre
Pour une requête utilisateur :
- Chaque appel à LLM : modèle, messages entrants, réponse sortante, jetons et latence
- Chaque appel d’outil : nom, arguments, résultat et erreur
- L’ordre et le minutage de toutes les étapes
- La réponse finale visible par l’utilisateur
Les journaux ne suffisent pas
Les journaux simples (instructions d’affichage) perdent la structure d’une trace : vous ne pouvez pas savoir quel appel à LLM correspond à quelle requête utilisateur ni comment les étapes s’organisent en arbre.
Les outils de traçage structuré résolvent ce problème.
Span ou trace
Notions empruntées à OpenTelemetry :
- Trace — toute l’exécution de l’agent (une requête utilisateur)
- Span — une étape de la trace (appel à LLM, appel d’outil ou récupération)
- Les span ont des parents et forment ainsi un arbre
A Concrete Trace Tree
Trace: user asks 'What is our return policy?'
|-- Span: retrieve_docs (12 ms)
|-- Span: llm_call_planner (820 ms)
| |-- tool_call: search_kb
|-- Span: tool_call: search_kb (340 ms)
|-- Span: llm_call_synthesise (1100 ms)
Total: 2.3 s, 8400 tokens, $0.012Pourquoi le traçage est meilleur que les journaux
- La structure arborescente montre les relations parent-enfant
- La cascade des durées révèle les étapes lentes
- Les jetons et les coûts sont agrégés par trace
- Rejouage : réexécutez une trace avec un nouveau prompt pour tester les modifications
Quand ajouter le traçage
Dès le premier jour. Le traçage pendant le développement révèle des bogues que vous ne remarqueriez pas lors d’un débogage limité à la conversation. L’ajouter après un incident en production est trop tard.
Vie privée et traçage
Les traces contiennent des données utilisateur. Traitez-les comme des journaux :
- Masquez les PII avant leur exportation
- Chiffrez-les au repos
- Respectez les politiques de conservation
Traçage ou évaluations
Traçage = « ce qui s’est passé lors de cette exécution ». Évaluations = « la qualité des performances de l’agent sur un jeu de test ». Vous avez besoin des deux, mais le traçage vient en premier : vous ne pouvez pas évaluer ce que vous ne pouvez pas inspecter.
Coût du traçage
Le traçage ajoute 1 à 2 % de surcharge de latence et augmente le stockage. Pour les agents très bavards, échantillonnez les traces (par exemple, 10 % intégralement et 100 % des échecs) au lieu de tout capturer.
Instrumentation manuelle ou automatique
Certains frameworks (LangChain, LlamaIndex) instrumentent automatiquement le code : vous obtenez des traces gratuitement. Pour le code personnalisé, entourez vos appels à LLM et vos appels d’outils d’assistants de span.
Identifiants de trace dans les erreurs visibles par l’utilisateur
Lorsque l’agent échoue, renvoyez un identifiant de trace à l’utilisateur :
« Une erreur s’est produite. Identifiant de référence : trace-9c4a... Présentez-le au service d’assistance. »
Le service d’assistance peut ouvrir la trace et voir exactement ce qui s’est passé.
Pourquoi le traçage ?
Pourquoi le traçage structuré est-il préférable à la simple journalisation avec des instructions d’affichage pour les agents ?
Récapitulatif
Le traçage est indispensable. Intégrez-le dès le premier jour. Les prochaines leçons expliquent quoi journaliser et quels outils utiliser.
Questions Fréquemment Posées
La leçon « Pourquoi le traçage est nécessaire pour les agents » est-elle gratuite ?
Oui — le texte complet de « Pourquoi le traçage est nécessaire pour les agents » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours AI Agents, passe à CoddyKit PRO. Le cours AI Agents comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Pourquoi le traçage est nécessaire pour les agents » ?
Les agents effectuent plusieurs appels au LLM et aux outils par requête : sans traces, vous avancez à l’aveugle. Tu pratiques AI Agents avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer AI Agents ?
Aucune expérience préalable n'est requise. AI Agents sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.
Combien de temps prend la leçon « Pourquoi le traçage est nécessaire pour les agents » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon AI Agents ?
Oui. Chaque leçon AI Agents inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Pourquoi le traçage est nécessaire pour les agents
- Journaliser les appels d’outils et les entrées/sorties
- Latence et coût par étape
- Visualiser les exécutions d’agents (Langfuse, LangSmith)