sessionLimits 可以为 Copilot 会话的当前计费周期设置一个软性的 AI 积分限额。创建会话和恢复会话时都可以设置。
设置限额
将限额传给SessionLimitsConfig 的 maxAiCredits。用量会在每次模型调用完成后检查,因此单次响应可能会超出设定值。一旦超出限额,运行时会阻止下一次模型调用。
SessionConfig 和 ResumeSessionConfig 的 sessionLimits 都可以接受 SessionLimitsConfig 实例或数组。
限额事件
监听会话事件,即可在限额发生变化时做出响应,并在达到限额时提示用户。
例如,收到
SESSION_LIMITS_EXHAUSTED_REQUESTED 时,可以使用事件数据显示确认界面。
响应限额耗尽
使用handlePendingSessionLimitsExhausted() 将用户的选择发送回运行时。将 action 设置为 SessionLimitsExhaustedResponseAction 的某个 case。
Add:在当前限额基础上增加指定的 AI 积分。需设置additionalAiCredits。Set:将限额更改为新的绝对值。需设置maxAiCredits。Unset:移除会话限额。Cancel:取消被阻止的模型请求,不更改限额。