AUDR par Chargebee est une spécification ouverte et une boîte à outils d'instrumentation qui enregistre l'utilisation des agents, les facteurs bruts de coût et l'attribution métier à travers des environnements d'exécution distribués.
Fonction du produit et positionnement officiel
AUDR, abréviation d'Agent Usage Detail Record, est une norme ouverte conçue pour capturer la télémétrie de bout en bout et l'attribution des coûts pour les flux d'agents IA à travers des couches d'exécution distribuées. Lorsqu'un agent interagit avec des harnais applicatifs, des routeurs de modèles et des environnements d'exécution d'outils, AUDR relie directement la consommation de calcul brute — comme le décompte de jetons, les appels d'outils et la durée d'exécution — aux métadonnées métier telles que les comptes clients, les fonctionnalités et les environnements opérationnels.
La norme repose sur trois règles fondamentales : la création d'un identifiant d'exécution partagé à travers chaque couche participante, le maintien d'une autorité claire par champ afin que chaque information provienne d'une source unique faisant autorité, et l'application de règles de fusion strictes au niveau du récepteur de destination. Soutenu par des bibliothèques centrales en Python et TypeScript, AUDR émet des enregistrements de manière asynchrone et hors bande, sans inspecter le texte des invites ni les sorties générées.
Cas d’usage étayés par les sources officielles
Corrèle la consommation de ressources à travers les routeurs et les exécutions d'outils externes avec les identifiants de clients et de fonctionnalités fournis par le harnais applicatif.
Transmet des enregistrements d'utilisation structurés directement vers le stockage local, les entrepôts de données ou les points de terminaison de facturation sans imposer de logique tarifaire prédéfinie.
Le parcours documenté, lorsqu’il est disponible
Installer un adaptateur d'écosystème ou initialiser le SDK central pour surveiller les complétions de modèles, les plongements, les portées d'outils et les appels de reclassement.
Créer un identifiant d'exécution partagé dans le harnais et associer les métadonnées d'exécution, telles que les identifiants clients et les balises d'environnement, aux requêtes sortantes.
Permettre aux routeurs et aux couches intermédiaires d'exécution de mesurer le nombre de jetons et la durée de calcul tout en préservant l'identifiant d'exécution partagé.
Fusionner les données d'exécution et de span correspondantes au niveau du récepteur désigné, en appliquant les règles d'autorité de champ et en transmettant la sortie vers des fichiers ou des points d'ingestion.
AUDR adapte le concept des enregistrements détaillés des communications (Call Detail Records) des télécommunications pour répondre à la fragmentation des données dans les architectures d'agents IA multiniveaux. Un harnais applicatif crée un identifiant d'exécution partagé et le transmet en aval dans les métadonnées de requête. Comme les routeurs et outils intermédiaires renvoient cet identifiant, les composants indépendants peuvent signaler des métriques opérationnelles sans perdre le contexte racine de l'exécution.
L'intégrité des données est maintenue grâce à une propriété sans ambiguïté des champs et à un comportement de fusion strict. Le harnais applicatif détient l'autorité exclusive sur les champs d'attribution tels que les identifiants clients et les environnements, tandis que les couches de routage détiennent l'autorité exclusive sur le nombre de jetons et les métriques des fournisseurs. Les récepteurs assemblent ces enregistrements à partir des identifiants d'exécution et de span, en rejetant les soumissions contradictoires et en traitant toute mise à jour comme un enregistrement de correction distinct plutôt que comme une modification sur place.
Vérifications à effectuer avec vos contenus et votre flux de travail
Sources vérifiées et date de la vérification
Réponses fondées sur la fiche produit dont les sources ont été vérifiées
AUDR standardise la manière dont les métriques d'exécution des agents et les métadonnées d'attribution sont enregistrées à travers plusieurs couches applicatives, routeurs et outils.
AUDR s'appuie sur les conventions sémantiques GenAI d'OpenTelemetry et peut émettre des spans directement vers des collecteurs OpenTelemetry tout en ajoutant une sémantique de livraison d'enregistrements durable.
Aucune plateforme de facturation externe ni aucun backend hébergé n'est requis, car les enregistrements peuvent être enregistrés dans des fichiers locaux, des entrepôts de données ou des systèmes d'observabilité.
AUDR émet les enregistrements de manière asynchrone et hors bande, évitant ainsi d'ajouter une latence synchrone sur le chemin de la requête, à moins que le contrôle budgétaire préalable facultatif ne soit activé.
Les adaptateurs capturent les identifiants d'exécution, l'utilisation des jetons, les appels d'outils et les durées opérationnelles, sans enregistrer les textes d'invite ni les sorties générées.
