AUDR by Chargebee

AUDR은 에이전트 사용 상세 레코드(Agent Usage Detail Record)의 약자다. 대시보드가 아니라 명세다. 계측 대상 작업마다 JSON 객체 하나를 만들고, 에이전트 하네스와 라우터, 모델 제공자, 과금 시스템이 모두 쓰고 읽을 수 있는 스키마를 정한다. Chargebee가 초안을 잡았고 Apache 2.0으로 공개한다.

이 표준이 메우는 구멍은 귀속이다. 애플리케이션은 어느 고객이 실행을 시작했는지 안다. 라우터는 토큰 수를 안다. 도구 계층은 샌드박스가 4분 동안 열려 있었다는 사실을 안다. 각 시스템은 따로 관측되지만, 지난 화요일 Acme의 지원 에이전트가 38센트 들었다고 답하는 시스템은 없다. 대부분의 팀은 이 문제를 에이전트 비용 추적 문제로 먼저 겪는다. 월간 모델 청구서만 봐서는 어느 기능이 예산을 먹는지 보이지 않는다.

설계는 통신업에서 가져왔다. 통신사들은 어떤 교환기가 처리하든 한 통의 전화를 공통 형식으로 기술하려고 통화 상세 레코드(Call Detail Record)에 합의했다. AUDR은 같은 원리를 에이전트 실행에 적용한다. 공유 실행 ID, 필드마다 하나의 권한 있는 기록자, 싱크가 추측 없이 적용하는 병합 규칙이다.

범위의 경계도 중요하다. AUDR은 사용량을 기술하고 청구서는 기술하지 않는다. 토큰을 청구 가능한 금액으로 바꾸는 레이팅 단계는 명세 밖에 있고, 싱크는 검증과 중복 제거, 저장만 맡는다.

Getting Started

1. 스택에 맞는 코어 패키지를 설치한다. pip install audr 또는 npm install @openaudr/audr을 쓰고, 싱크는 테스트용 로컬 JSONL 파일이나 과금용 Chargebee 중에서 고른다.
2. 그 싱크와 emitter 블록으로 클라이언트를 만든다. 컴포넌트와 앱 이름, 버전을 적는다.
3. 이미 쓰는 런타임의 어댑터를 등록한다. LiteLLM, Vercel AI SDK, Mastra, NeMo Relay 등이 있다. 직접 client.record()를 호출해도 된다.
4. 요청마다 귀속 정보를 넘긴다. 보통 계정 ID나 구독 ID에 환경 이름을 붙인다. 그다음 JSONL 출력이나 과금 시스템에서 병합된 레코드를 읽는다.