Docs · La doctrine · Section 10
Observabilité et maîtrise du coût
Un système agentique non observé est ingouvernable et imprévisible en coût. L'observabilité n'est pas une option de fin de projet, c'est une propriété de conception, portée par la chaîne de middleware. Et la trace qu'elle produit ne sert pas qu'au tableau de bord : c'est le même flux qui nourrit l'évaluation comportementale continue (section 12) et la provenance (section 08).
Trois niveaux d'observabilité indépendants
| Niveau | Quoi | Usage |
|---|---|---|
| Journaux structurés | Une ligne par événement, contexte typé (module, identifiant de requête, session). | Agrégation standard, recherche, alerte. |
| Événements de cycle | Chaque étape de l'orchestrateur et chaque appel d'outil persistés. | Rejeu d'une trajectoire, audit comportemental. |
| Métriques par appel de modèle | Jetons entrée et sortie, cache, niveau utilisé, durée, statut, tentative. | Suivi du coût et de la performance par agent. |
La propagation d'un identifiant de requête
Un identifiant unique est propagé de l'entrée jusqu'à chaque appel d'outil et de modèle, et jusqu'aux sous-agents via la lignée parent et enfant. C'est lui qui permet de reconstituer une trajectoire complète a posteriori, condition de l'auditabilité exigée en environnement régulé.
Reconstruire le contexte d'une décision passée
Auditer une décision, ce n'est pas seulement retrouver qu'un appel a eu lieu, c'est reconstruire le contexte tel qu'il était au moment où l'agent a décidé. Or la mémoire de travail consolide et oublie (section 06). L'observabilité doit donc pouvoir déplier un souvenir compressé vers les faits bruts dont il provient, à l'horodatage exact de la décision, en suivant les pointeurs déposés à la consolidation. L'exécution courante reste légère ; l'explication d'une décision passée reste possible, même après que la mémoire de travail l'a résumée. C'est la condition d'un audit qui tient en environnement régulé.
Une conséquence souvent oubliée : ces traces contiennent les prompts et les sorties, donc de la donnée. Les exporter vers un service d'observabilité tiers est une exfiltration comme une autre ; elles suivent le même régime de souveraineté que la donnée qu'elles transportent (section 15).
Le coût se pilote par l'architecture, pas par la chance
Trois leviers, tous structurels, gardent le coût sous contrôle :
- Frontière du modèle : tout ce qui est déterministe ne paie pas le prix d'un appel de modèle.
- Routage par niveau : la complexité estimée d'une tâche choisit le niveau rapide, équilibré ou profond. En cas de doute, on monte d'un niveau plutôt que de risquer une mauvaise réponse.
- Cache et stabilité des prompts : les segments stables du prompt sont positionnés pour être réutilisés. La stabilité du contenu prime sur la seule réduction de jetons.
! Plafonds explicites en exploitation continue
Pour un système qui tourne en fond, un compteur de coût agrégé par tâche racine et des plafonds par fenêtre de temps sont indispensables. Au dépassement, l'orchestrateur s'arrête et rend une synthèse, plutôt que de poursuivre sans contrôle. Le coût récurrent devient ainsi une grandeur pilotée, pas subie.