跳转到主要内容
使用 sessionLimits 可以为 Copilot 会话的当前计费周期设置一个软性的 AI 积分限额。创建会话和恢复会话时都可以设置。

设置限额

将限额传给 SessionLimitsConfig 的 maxAiCredits。用量会在每次模型调用完成后检查,因此单次响应可能会超出设定值。一旦超出限额,运行时会阻止下一次模型调用。
SessionConfig 和 ResumeSessionConfig 的 sessionLimits 都可以接受 SessionLimitsConfig 实例或数组。

限额事件

监听会话事件,即可在限额发生变化时做出响应,并在达到限额时提示用户。 例如,收到 SESSION_LIMITS_EXHAUSTED_REQUESTED 时,可以使用事件数据显示确认界面。

响应限额耗尽

使用 handlePendingSessionLimitsExhausted() 将用户的选择发送回运行时。将 action 设置为 SessionLimitsExhaustedResponseAction 的某个 case。
可用的 action 如下:
  • Add:在当前限额基础上增加指定的 AI 积分。需设置 additionalAiCredits。
  • Set:将限额更改为新的绝对值。需设置 maxAiCredits。
  • Unset:移除会话限额。
  • Cancel:取消被阻止的模型请求,不更改限额。
使用 session_limits_exhausted.requested 和 session_limits_exhausted.completed 的限额耗尽确认流程以及相关的响应 API 目前处于实验阶段,将来可能会更改或移除。
最后修改于 2026年10月26日