# AI 用量與預算

查看各專案、模型與代理程式的 token 用量、預估費用與活動。

從助理的用量計數器開啟用量報告。它把內建助理與 CLI 代理程式的活動整合在同一個檢視中，包括已完成的工作，以及用掉 token 的中斷執行。

## 閱讀報告

可依專案、代理程式、供應商、模型或工作階段篩選，並用 **起始** 與 **結束** 設定日期，或使用 **7 天**、**本月** 這類快速區間。日期與時間都採用 UTC。每日 token 與每小時活動會顯示工作發生的時間；分組合計則協助你比較用量花在哪裡。**匯出 CSV** 會儲存報告。

當執行環境提供相關資料時，報告會把輸入、輸出、快取讀取與快取建立分開列出。一項量測值可能是回報的、預估的，或無法取得。**未知** 表示執行環境沒有提供足夠的資訊；它不代表零。

## 了解費用估算

API 費用估算使用現有的模型價格與 token 量測值。CLI 代理程式可能採用訂閱或其他計費方式。它們的 token 數不是帳單，也不代表帳戶的剩餘額度。

實際的扣款金額請以供應商自己的帳單頁面為準。

## 設定專案預算

開啟專案後，在 **設定 → AI 助理 → 供應商與金鑰** 下設定 **AI 預算**。輸入以美元計的金額並選擇 **儲存預算**；**清除預算** 會移除它。卡片會顯示目前為止的預估支出。

專案預算可以在已記錄的用量達到上限的 80% 時，於內建助理執行之前發出警告，並在達到上限時阻止新的執行。這是開始工作前的檢查，而不是在回覆進行中途切斷。

預算檢查並未涵蓋每個外部代理程式或研究任務的執行環境。如果你需要由服務端強制執行的支出上限，請使用供應商端的限制。
