用量統計

組織設定「用量統計」頁的完整說明：篩選條件、用量概覽與快取節省、各分頁（Agent、角色、成員、對話平台、聯絡人、語音助理、計費類別）的欄位定義、角色用量的計算方式、「未知」代表什麼，以及為什麼和額度頁的數字不同。

用量統計 是管理員查看組織用量的主要入口：可以依時間區間看整體趨勢，也能從 Agent、角色、成員、對話平台、聯絡人等角度排名，找出用量最多的對象，並匯出 Excel。Credits 計費的組織還能查看 Credit 消耗、各計費類別的明細與快取節省。

誰可以使用

• 需要角色權限 組織權限 底下的 用量統計權限（組織擁有者預設具備；設定方式見編輯角色權限）。

• Credits 指標、Credit 欄位與 計費類別 分頁，只在採用 Credits 計費的組織出現（見 Credits 計費制度）。

進入方式

從左側選單點選 組織設定 → 用量統計。

篩選條件

頁面最上方的篩選列會套用到整頁：

篩選	選項
時間粒度	每小時、每日（預設）、每月，決定圖表橫軸的間隔
日期區間	預設為最近 30 天
指標	Token、字數、訊息、對話、Credits，決定圖表與排名依哪個數字計算
時區	當地時區、UTC 時區，只影響圖表時間軸的顯示

按 重置篩選 可回到預設值。切到 語音助理 分頁時，指標選單會換成 STT 秒數、TTS 字數、語音模型 Token 數 與 Credits。

用量概覽

用量概覽 以卡片顯示所選期間的總量：

卡片	內容
字數	輸入、輸出與合計的字數
TOKEN	輸入、輸出與合計的 Token 數
訊息總數／對話總數	所選期間的訊息與對話數量
Credit 消耗（Credits 計費組織）	Credit 消耗、快取節省、錢包 餘額，以及依期間日均消耗推算的 預估剩餘 天數（僅供參考）
STT / TTS 用量、語音模型 Token 總數	第二列，顯示語音通話的 STT 總秒數、TTS 總字數與語音模型 Token 數

快取節省 是平台自動啟用 Prompt 快取後，所選期間累計省下的 Credits；淨節省大於 0 時才會顯示。快取的運作方式見 Prompt Cache 快取用量。

各分頁

分頁	內容
趨勢	所選指標的 使用量趨勢：每個時間點的用量與累積用量
AI 助理	依 Agent 統計
角色	依角色統計，計算方式見角色分頁怎麼算
成員	依成員統計，含 成員名稱 與 成員 Email，是查看「每個人用了多少」的地方
對話平台	依對話平台統計；類型 欄會區分網頁、內部、API 等來源
聯絡人	依聯絡人統計，每一列是「聯絡人 × Agent」，外部訪客的用量在這裡查
語音助理	依 Agent 統計語音通話的 STT 秒數、語音模型 Token、TTS 字數與 語音對話次數
計費類別	指標切到 Credits 才會出現，依計費類別（例如 AI 文字生成與理解模型、知識庫與向量檢索系統）列出 Credit 消耗，可展開看各供應商與模型的消耗，以及各成員的消耗明細

除了 趨勢 與 計費類別，每個分頁都有三張圖（時間序列、Top 10 排名、使用佔比）和一張明細表。明細表上方可依 ID 或名稱搜尋，並可按 匯出 Excel 依目前分頁、日期區間與搜尋條件下載資料。

用量會在訊息處理完成後由背景作業累計，最新的對話可能需要稍候才會出現在統計中。計費類別 的數字來自定期預聚合，可能因非同步扣款與小數四捨五入，和即時帳單有些許出入。

欄位定義

欄位	定義
輸入字數／輸出字數／總字數	訊息內容的字元數。使用者發送的訊息計入輸入，Agent 的回覆計入輸出
輸入 Token／輸出 Token／總 Token	模型處理的 Token 數。總 Token＝輸入＋輸出，不含快取
快取寫入／快取讀取	寫入 Prompt 快取、以及從快取讀取的 Token 數
快取命中率	快取讀取 ÷（輸入 Token＋快取寫入＋快取讀取）
訊息數	每則訊息計 1 次，使用者的訊息與 Agent 的回覆都會計入
對話數	新對話的第一則訊息出現時計 1 次
Credits	所選期間的 Credit 消耗
交易次數	Credit 扣款的筆數。一次對話可能產生多筆，例如模型用量、快取與工具呼叫各自計費

指標選 Token 時，排名圖與佔比圖的數字會把快取寫入與快取讀取一起算進去，因此可能比表格的 總 Token 大。

各分頁上方的總數（成員分頁的 成員數、Agent 分頁的 Agent 數等，API 回應中為 totalMembers、totalChatbots）是所選期間內有用量紀錄的對象數（去重），不是組織目前的成員或 Agent 總數。例如要知道「這週有多少人問過問題」，把期間設為本週後看成員分頁的成員數即可；期間依所選日期的整天計算。

角色分頁怎麼算

角色的用量是該角色目前所有成員的個人用量加總，不是「透過這個角色產生的用量」：

• 成員同時屬於多個角色時，他的用量會完整計入每一個角色。例如一位成員同屬 3 個角色、期間內只有他有用量，這 3 個角色會顯示一模一樣的數字。

• 因此各角色的數字加總，可能大於組織實際的總用量。

• 以查詢當下的角色成員名單計算：成員加入角色之前的用量也會算進這個角色；成員離開角色後，他的用量就不再計入。

「未知」代表什麼

指標切到 Credits 時，成員、對話平台 等分頁的排名圖與佔比圖可能出現「未知」。它代表這部分 Credit 消耗無法歸屬到某位成員；在 對話平台 分頁則代表不屬於任何對話平台的消耗，例如知識庫儲存。成員 分頁的「未知」常見來源有：

來源	說明	去哪裡看明細
外部訪客	透過網頁 Web Chat、LINE 等對話平台與 Agent 對話的訪客，不是組織成員	聯絡人 分頁
已停用或已移除的成員	消耗發生時，對應的成員已不是組織的有效成員	—
系統計費	不由特定成員觸發的計費，例如知識庫儲存的每日計費，或找不到發起成員的自動作業	計費類別 分頁

為什麼和額度頁的數字不同

Credits 頁的 額度分配，以及成員帳號頁的 Credit 額度，「使用量」以「已用／上限」顯示。例如 7,000.00 / 10,000.00 代表這筆額度已用 7,000 Credits、上限 10,000 Credits。它和用量統計的數字常常對不起來，原因如下：

差異	用量統計	額度
計算期間	篩選列選的日期區間（預設最近 30 天）	這筆額度生效、或上次重置之後的累計
計入範圍	歸屬於該成員的所有用量	只計入額度適用範圍內的消耗
角色	以目前的角色成員，加總他們在期間內的全部用量	消費發生的當下，計入該成員所屬的每個受管控角色，且只從角色額度生效後開始累計（見角色額度）
更新時間	背景累計，計費類別為定期預聚合	每次扣款時累計

要核對單筆扣款，請到 Credits → 消耗記錄（見 Credits 管理面板）。

常見問題

Q：找不到 計費類別 分頁？

請先把指標切到 Credits，分頁才會出現；停在這個分頁時，指標選單會鎖定為 Credits。若指標選單沒有 Credits，代表組織不是 Credits 計費。

Q：好幾個角色的數字一模一樣，是統計錯了嗎？

通常不是。同一位成員屬於多個角色時，他的用量會完整計入每個角色；如果期間內只有這位成員有用量，這些角色就會顯示相同數字。詳見角色分頁怎麼算。

Q：要怎麼產出每位成員的用量報表？

切到 成員 分頁、設定日期區間後按 匯出 Excel。需要看 Credits 時，先把指標切到 Credits 再匯出。

Q：外部訪客的用量算在哪裡？

外部訪客不是組織成員，不會出現在 成員 分頁的表格，請到 聯絡人 或 對話平台 分頁查看；以 Credits 檢視成員排名時，這部分會歸在「未知」。