跳轉到主要內容
使用 sessionLimits 可為 Copilot Session 目前的計費週期設定 AI Credits 的軟性上限。建立 Session 與恢復 Session 時皆可設定。

設定上限

將上限值傳給 SessionLimitsConfig 的 maxAiCredits。用量會在每次模型呼叫完成後檢查,因此單一回應可能會超過設定值。超過上限後,runtime 會阻擋下一次的模型呼叫。
SessionConfig 與 ResumeSessionConfig 的 sessionLimits 皆可接受 SessionLimitsConfig 實例或陣列。

上限相關事件

監聽 Session 事件,即可因應上限的變更,並在達到上限時向使用者確認。 例如收到 SESSION_LIMITS_EXHAUSTED_REQUESTED 時,可使用事件資料顯示確認 UI。

回應上限用盡

使用 handlePendingSessionLimitsExhausted() 將使用者的選擇回傳給 runtime。action 請指定 SessionLimitsExhaustedResponseAction 的 case。
可用的 action 如下:
  • Add:在目前的上限上追加指定的 AI Credits。請指定 additionalAiCredits。
  • Set:將上限變更為新的絕對值。請指定 maxAiCredits。
  • Unset:移除 Session 上限。
  • Cancel:不變更上限,取消被阻擋的模型請求。
使用 session_limits_exhausted.requested 與 session_limits_exhausted.completed 的上限用盡確認流程及相關的回應 API 為實驗性功能。未來可能會變更或移除。
最後修改於 2026年10月26日