AUDR by Chargebee
Chargebee · 生產力 · 商業
AUDR by Chargebee 是開放 JSON 標準，記錄每次 AI 代理執行由誰發起，以及每個模型與工具呼叫花費多少，讓團隊用同一筆記錄完成計費與預算規劃。
關於 AUDR by Chargebee
What Is AUDR by Chargebee
AUDR 全名是 Agent Usage Detail Record。它是一份規格，不是儀表板：每一筆計量操作對應一個 JSON 物件，任何代理執行環境、路由器、模型供應商或計費系統都能寫入與讀取。Chargebee 起草這份規格，並以 Apache 2.0 授權公開。
它補上的是歸屬關係。應用程式知道是哪位客戶觸發執行，路由器知道權杖數量，工具層知道沙箱開了四分鐘。每個系統各自可觀測，卻沒有任一個能告訴你 Acme 的客服代理上週二花了 38 美分。多數團隊最早感受到的是代理成本追蹤問題：每月模型帳單看不出哪個功能吃掉預算。
設計借鏡電信業。營運商當年採用通話明細記錄（Call Detail Record），讓一通電話能用共通格式描述，不必管是哪家交換機處理。AUDR 對代理執行押同樣的注：共用的執行 ID、每個欄位只有一個權威寫入者，以及接收端不必猜測就能套用的合併規則。
範圍界線要說清楚。AUDR 描述用量，不描述帳單。把權杖換算成應收金額的計價步驟留在規格之外，接收端只負責驗證、去重與儲存。
Getting Started
- 依技術堆疊安裝核心套件，
pip install audr或npm install @openaudr/audr，再挑一個接收端：測試階段用本機 JSONL 檔案，正式計費接 Chargebee。 - 用該接收端建立 client，並設定 emitter 區塊，寫明元件、應用程式與版本。
- 為現有執行環境註冊轉接器，例如 LiteLLM、Vercel AI SDK、Mastra 或 NeMo Relay，也可以自行呼叫
client.record()。 - 每次請求帶上歸屬資訊，通常是帳戶或訂閱 ID 加環境名稱，之後讀取 JSONL 輸出，或在計費系統查看合併後的記錄。
產品資訊
快速了解 AUDR by Chargebee 的定價、支援平台與效能。
適合對象
這項工具最適合的使用者、任務與情境。
使用者
- AI 產品工程師：能拿到每位客戶每一次執行的數字，前提是願意在現有技術堆疊加一次 SDK 呼叫或一個轉接器。
- AI 公司的財務團隊：記錄把支出連到帳戶，而 AI 代理計費仍需要計價層，才能變成發票。
- 負責用量計費的平台工程師：當 Chargebee 或 Lago 已經在流程末端時，接起來最省事。
- 要為代理產品定價的創辦人：輸出提供每次執行的成本基準，不負責告訴你該抓多少毛利。
任務
- 把模型支出歸到客戶：用路由器的權杖數對上執行環境的帳戶 ID，不必再拿平均數推估。
- 稽核工具成本：捕捉沙箱分鐘數、搜尋呼叫與付費 API 請求，這些通常到不了模型路由器。
- 準備用量發票：把合併後的記錄交給計價系統，再依執行次數、成果或點數收費。
- 追查毛利問題：比較某個功能的實際服務成本與定價頁上的售價。
情境
- 客服代理裡有一位客戶的量遠超其他人：逐次執行的記錄能把這個大戶從平均裡拉出來。
- 多模型加上備援路由的架構：路由器與供應商的記錄會在同一個 span 合併，重試不會從總額消失。
- 從固定訂閱轉向用量計價的試辦案：你需要幾個月的每次執行成本歷史，才敢公布價格。
主要功能
跨越每一站的共用執行 ID
執行環境為每次操作產生 run_id 與 span_id，並放進請求中介資料往下傳。路由器、供應商與工具層回傳同一組值。接收端依這兩個值合併記錄，因此三個元件描述的同一次模型呼叫會變成一行，而不是三段碎片。
每個欄位只有一個寫入者
AUDR 劃分所有權，不讓每個元件覆寫同一塊資料。執行環境負責歸屬：客戶、環境、發起者。路由器負責用量：權杖與供應商。衝突會被拒絕，而不是由最後寫入的人決定。
更正只能新增記錄
記錄不可變。要修正錯誤數字，得由同一個 emitter 元件再送一筆，接收端依 record_id 取代舊記錄。你保留稽核軌跡，不會丟掉原始值。
原始計數，而非換算價格
記錄帶的是輸入權杖、輸出權杖、工具呼叫次數、運算秒數等計數。成本物件屬於選填的參考資訊。這樣拆分的好處是供應商調價時可以重算歷史，不必改寫當初測到的數字。
常見代理執行環境的轉接器
現成轉接器涵蓋 LiteLLM、NVIDIA NeMo Relay、Merge Gateway、Vercel AI SDK、Mastra 與 OpenRouter。註冊一個之後，每次模型或工具呼叫都會產生記錄，並附上所屬帳戶。
接通計費系統的接收端
Chargebee 與 Lago 都有參考接收端，本機檔案接收端則適合初期測試。契約很短：驗證、去重、合併、儲存。把同一批記錄送到資料倉儲或佇列，是週末做得完的任務。
優缺點
優點
- Apache 2.0 授權，規格與一致性測試樣本公開，可以在正式投入前先驗證實作。
- 設計上不綁供應商：流量走 OpenRouter、LiteLLM 或自建閘道，記錄格式都一樣。
- 表面積小。一筆記錄就是普通 JSON，三條合併規則一頁寫得完。
- Python 與 TypeScript SDK 加上檔案接收端，一個人一個下午就能產出可用資料。
- 開始使用不需要託管帳號、最低消費或業務洽談。
缺點
- 規格還很年輕。1.1.0 版在 2026 年 10 月才推出，欄位涵蓋範圍還會變動。
- 轉接器與接收端清單偏短。用其他閘道的團隊得自己寫整合。
- 計價不在標準範圍內，你仍需要計費邏輯，才能把用量變成發票。
- 儲存、查詢與告警都沒有附。報表終究是你自己的責任。
常見問題
Agent Usage Detail Record。它是代理系統中單一計量操作的 JSON 規格，涵蓋誰發起以及消耗了什麼。
相關內容
探索與 AUDR by Chargebee 相關的工具、技能與文章。
AUDR by Chargebee 替代方案
Base Code
Base44 (Wix) · 程式設計 · 生產力Base Code 是 Base44 推出的共享雲端開發環境。團隊在對話中描述對既有 GitHub 儲存庫的修改，看著預覽確認結果，再以 Pull Request 交回工程團隊。
Knocket
Knocket (Tencent RTC team) · 生產力 · 商業 · 聊天機器人Knocket 是免費的線上客服與聯絡頁面工具，訪客可從網站、App 或一條分享連結傳訊息，你在 Telegram 或單一收件匣就能回覆。
FloorGen
Vinit Kumar (FloorGen) · 生產力 · 中國 AIFloorGen 是瀏覽器上的平面圖製作工具，能把一句描述或一張草圖變成可編輯的 2D 平面圖與 3D 導覽。可匯出 PDF、DXF 或影片，不註冊也能開始畫。