Observabilité et débogage
L'observabilité relie les résultats aux étapes qui les produisent.
Ce que vous apprendrez
- Expliquer : les erreurs nécessitent des chemins explicites
- Appliquer l'idée dans un exemple : observabilité et débogage
- Reconnaître les limites et vérifier le résultat de l'exercice
L'observabilité relie les résultats aux étapes qui les produisent. Les données de diagnostic devraient aider sans révéler de secrets.
Vous pouvez suivre ce cours sans compte ni programmation. Les exemples utilisent des données synthétiques et les résultats de l’IA doivent être vérifiés.
Comment ça marche, étape par étape
Les erreurs nécessitent des chemins explicites
Un délai d'attente diffère d'une erreur d'autorisation. Réessayez uniquement les erreurs transitoires, avec des tentatives limitées et des délais croissants. Une opération avec des effets secondaires peut s'exécuter avant que sa réponse ne soit perdue ; réessayer sans clé d'idempotence peut dupliquer l'effet. Le streaming montre la progression mais ne garantit pas l'achèvement. Les points de contrôle peuvent permettre la reprise des étapes ayant échoué dans les limites d'exécution. Stockez l'identifiant d'exécution, l'étape, la durée et l'erreur tout en supprimant les secrets des journaux. Mesurez les chemins lents ainsi que les moyennes.
Définir le succès avant d’optimiser
Préparer les demandes représentatives et les réponses ou propriétés attendues. Incluez les cas ordinaires, les ambiguïtés, les données manquantes et les erreurs d'outils. Pour RAG, mesurez la récupération des preuves séparément de l’exactitude des réponses. Recall@k mesure la part de preuves pertinentes trouvées dans les k premiers résultats ; précision@k mesure la part des résultats renvoyés qui sont pertinents. Pour les agents, suivez également les actions, les autorisations et les arrêts. Un LLM en tant que juge peut accélérer l'évaluation mais doit être calibré par rapport aux humains. Ne modifiez pas simultanément l'invite, le modèle et l'index si vous souhaitez comprendre ce qui a amélioré les résultats.
Vérifier l'accès avant utilisation
Les autorisations doivent être appliquées par les serveurs et la couche de données. Ne laissez pas le modèle décider si un utilisateur peut voir un document. Filtrez les sources avant qu'elles n'entrent dans le contexte, et non après avoir généré la réponse. Utilisez des informations d'identification à accès minimal, gardez-les à l'écart des invites, des captures d'écran et du code du navigateur, et faites pivoter les clés exposées. Une liste blanche de domaines de widgets ne remplace pas l'authentification API. L'authentification vous identifie ; l’autorisation détermine les opérations et les données que vous pouvez utiliser. Test d'accès refusé également.
Le schéma explicatif
Suivez les flèches pleines pour le flux principal. Les flèches bleues en pointillés fournissent des données ou un contexte ; les flèches roses en pointillés affichent des commentaires ou des résultats renvoyés. Les couleurs et les formes distinguent les modèles, les magasins, les décisions et les sorties. Sur un petit écran, faites défiler horizontalement pour suivre le schéma complet.
Un exemple complet
Une réponse lente a une récupération de 0,2 s, un reclassement de 0,4 s et un outil externe de 8 s. Un identifiant d'exécution relie les étapes ; les versions d'invite et de modèle sont enregistrées.
Essayez-le vous-même
- Créez une chronologie avec l'étape, la durée, le résultat et l'identifiant de l'exécution.
- Enregistrez l’entrée, la source et le résultat attendu avant d’exécuter l’expérience. Utilisez uniquement les données fictives de l'exemple.
- Suivez les étapes du diagramme. À chaque étape, enregistrez les informations reçues et produites ; ne confondez pas le résultat intermédiaire avec le résultat final.
- Répétez après avoir supprimé les informations nécessaires ou rendu la saisie ambiguë. Vérifiez si le système clarifie, arrête ou invente une réponse.
- Comparez avec la solution expliquée. Conservez la configuration, la date, le résultat et une explication des différences. Changez une chose et retestez.
Une solution expliquée
Identifiez l'outil comme source de latence et conservez le contexte d'erreur sans informations d'identification. Un exercice réussi vous permet de montrer le lien entre les contributions, les étapes et les résultats. Lorsqu’une information manque, une réponse prudente est plus utile que des détails inventés. Comparez bien plus que le style : vérifiez également les conditions, les sources et les opérations.
Quand cette approche est utile et quelles sont ses limites
Les outils de traçage externes ne sont pas considérés comme des contrôles de l’interface utilisateur. Choisissez cette approche lorsqu’elle améliore un besoin mesuré. Gardez une base de référence simple et comparez les résultats en utilisant des entrées identiques. Un exemple réussi n’établit pas la fiabilité dans toutes les situations.
Vérifiez vos connaissances
Un délai d'attente prouve-t-il que l'opération n'a pas été exécutée ?
Non. Vérifiez l’état avant de réessayer une action avec des effets secondaires.
Un bon score de style prouve-t-il le succès d’un agent ?
Non. L’agent peut écrire magnifiquement après avoir utilisé le mauvais outil ou les mauvaises données.
Quel résultat cet exercice devrait-il produire ?
Identifiez l'outil comme source de latence et conservez le contexte d'erreur sans informations d'identification.
Les mots à retenir
- Idempotence: Répétition contrôlée sans dupliquer un effet.
- Régresie / Régression: Un changement qui brise un cas précédemment correct.
- Autoriser / Autorisation: Vérification du droit d'accès à une opération ou une ressource.
Sources et votre prochaine étape
Pour préparer : E03 — Évaluer les agents et les équipes