AUDR by Chargebee

AUDR by Chargebee

Chargebee · Productivité · Entreprise

AUDR by Chargebee est un standard JSON ouvert qui enregistre qui a lancé chaque exécution d'agent IA et le coût de chaque appel au modèle ou à un outil, pour facturer et budgéter depuis un enregistrement commun.

Aperçu de l'interface de AUDR by Chargebee

À propos de AUDR by Chargebee

What Is AUDR by Chargebee

AUDR signifie Agent Usage Detail Record, autrement dit Registre de détail d'usage des agents. Il s'agit d'une spécification, pas d'un tableau de bord : un objet JSON par opération mesurée, avec un schéma que n'importe quel harness d'agents, routeur, fournisseur de modèles ou système de facturation peut écrire et lire. Chargebee l'a rédigée et publie la spécification sous licence Apache 2.0.

Ce qu'AUDR comble, c'est l'attribution. Votre application sait quel client a déclenché l'exécution. Le routeur connaît les tokens. La couche d'outils sait que le sandbox est resté ouvert quatre minutes. Chaque système s'observe seul, et aucun ne vous dit que l'agent de support d'Acme a coûté 38 centimes mardi dernier. La plupart des équipes le ressentent d'abord comme un problème de suivi des coûts d'agents : la facture mensuelle du modèle cache quelle fonctionnalité mange le budget.

Le principe vient des télécoms. Les opérateurs ont adopté le Call Detail Record pour décrire un appel dans un format commun, quel que soit l'exploitant du central. AUDR parie sur la même idée pour les exécutions d'agents : un identifiant partagé, un seul responsable par champ et des règles de fusion que le sink applique sans deviner.

Les limites comptent. AUDR décrit l'usage, pas la facture. La tarification, l'étape qui transforme des tokens en montant facturable, reste hors de la spécification, et le sink se contente de valider, dédupliquer et stocker les enregistrements.

Getting Started

  1. Installez le paquet principal pour votre stack, pip install audr ou npm install @openaudr/audr, puis choisissez un sink : un fichier JSONL local pour les tests ou Chargebee pour la facturation.
  2. Créez un client avec ce sink et un bloc emitter qui indique votre composant, l'application et la version.
  3. Enregistrez un adaptateur pour le runtime que vous utilisez déjà, comme LiteLLM, le SDK Vercel AI, Mastra ou NeMo Relay, ou appelez client.record() vous-même.
  4. Transmettez l'attribution à chaque requête, en général un ID de compte ou d'abonnement et un environnement, puis lisez la sortie JSONL ou les enregistrements fusionnés dans votre système de facturation.

Informations sur le produit

Aperçu des tarifs, des plateformes compatibles et des performances de AUDR by Chargebee.

Offre gratuiteOui
Offres payantesFree (Apache 2.0), $0
PlateformeWeb, Python, TypeScript
DéveloppeurChargebee
CatégorieProductivité · Entreprise
Date de lancementSep 2026
Dernière mise à jourOct 2026
Visites du site2.5M
Classement mondial du site18.1K
Disponibilité de l’APIOui

Idéal pour

Les utilisateurs, tâches et cas d'usage où cet outil convient le mieux.

Utilisateurs

  • Ingénieurs produit IA
  • Équipes finance d'entreprises IA
  • Ingénieurs plateforme en facturation à l'usage
  • Fondateurs qui fixent le prix d'un produit d'agents

Tâches

  • Rattacher la dépense de modèle aux clients
  • Auditer le coût des outils
  • Préparer des factures à l'usage
  • Enquêter sur un problème de marge

Cas d'usage

  • Un agent de support où le volume d'un client écrase les autres
  • Une stack multi-modèles avec bascules
  • Un pilote qui passe de l'abonnement fixe au prix à l'usage

Fonctionnalités clés

Un identifiant d'exécution qui survit à chaque saut

Le harness génère un run_id et un span_id par opération, puis transmet les deux dans les métadonnées de la requête. Routeur, fournisseur et couche d'outils renvoient la même paire. Le sink fusionne les enregistrements qui partagent ces valeurs, donc un appel de modèle décrit par trois composants arrive en une ligne, pas en trois fragments.

Un seul rédacteur par champ

AUDR répartit la propriété au lieu de laisser chaque composant écraser un bloc commun. Le harness détient l'attribution : client, environnement, initiateur. Le routeur détient l'usage : tokens et fournisseur. Les conflits sont rejetés, pas arbitrés par le dernier écrivain.

Des corrections en ajout seul

Les enregistrements sont immuables. Corriger un chiffre suppose d'émettre un nouvel enregistrement depuis le même composant emitter, et le sink remplace le précédent via record_id. Vous gardez une piste d'audit au lieu de perdre la valeur d'origine.

Des compteurs bruts, pas des prix dérivés

L'enregistrement porte les tokens d'entrée, les tokens de sortie, les appels d'outils, les secondes de calcul et des compteurs du même ordre. L'objet de coût est facultatif et informatif. Cette séparation vous permet de recalculer l'historique quand un fournisseur change ses tarifs, sans réécrire ce qui a été mesuré.

Des adaptateurs pour les runtimes courants

Des adaptateurs prêts à l'emploi couvrent LiteLLM, NVIDIA NeMo Relay, Merge Gateway, le SDK Vercel AI, Mastra et OpenRouter. Vous en enregistrez un et chaque appel de modèle ou d'outil émet un enregistrement, avec le compte auquel il appartient.

Des sinks reliés aux systèmes de facturation

Chargebee et Lago fournissent des sinks de référence, et un sink fichier sert aux premiers tests. Le contrat tient en peu de mots : valider, dédupliquer, fusionner, stocker. Diriger les mêmes enregistrements vers votre entrepôt de données ou une file d'attente reste un chantier réaliste pour un week-end.

Avantages et inconvénients

Avantages

  • Licence Apache 2.0 avec schéma public et fixtures de conformité, ce qui permet de tester une implémentation avant de s'engager.
  • Neutre vis-à-vis des fournisseurs : le même enregistrement fonctionne avec du trafic via OpenRouter, LiteLLM ou une passerelle maison.
  • Surface réduite. Un enregistrement est du JSON simple et les trois règles de fusion tiennent sur une page.
  • Les SDK Python et TypeScript plus le sink fichier permettent à une seule personne d'obtenir des données utiles en un après-midi.
  • Aucun compte hébergé, dépense minimale ni appel commercial ne sont nécessaires pour démarrer.

Inconvénients

  • La spécification est jeune. La version 1.1.0 est arrivée en octobre 2026 et la couverture des champs va encore bouger.
  • La liste d'adaptateurs et de sinks reste courte. Les équipes sur d'autres passerelles écrivent leur intégration.
  • La tarification reste hors du standard, il vous faut donc encore une logique de facturation pour transformer l'usage en facture.
  • Rien n'est fourni pour le stockage, les requêtes ou les alertes. Le reporting reste à votre charge.

Questions fréquentes

Agent Usage Detail Record. C'est une spécification JSON pour une opération mesurée dans un système d'agents, qui couvre son déclencheur et sa consommation.