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。
Add:在目前的上限上追加指定的 AI Credits。請指定additionalAiCredits。Set:將上限變更為新的絕對值。請指定maxAiCredits。Unset:移除 Session 上限。Cancel:不變更上限,取消被阻擋的模型請求。