sessionLimits를 사용하면 Copilot 세션의 현재 집계 기간에 대해 소프트 AI 크레딧 한도를 설정할 수 있습니다. 세션 생성 시와 재개 시 모두 설정할 수 있습니다.
한도 설정
SessionLimitsConfig의 maxAiCredits에 한도를 전달합니다. 사용량은 각 모델 호출이 완료된 후에 확인되므로, 하나의 응답이 설정값을 초과할 수 있습니다. 한도를 초과하면 런타임은 다음 모델 호출을 차단합니다.
SessionConfig와 ResumeSessionConfig 모두 sessionLimits를 SessionLimitsConfig 인스턴스 또는 배열로 받습니다.
한도 이벤트
세션 이벤트를 수신하여 한도 변경에 대응하고, 한도에 도달했을 때 사용자에게 확인을 요청할 수 있습니다.
예를 들어
SESSION_LIMITS_EXHAUSTED_REQUESTED를 수신하면 이벤트 데이터를 사용해 확인 UI를 표시합니다.
한도 소진에 응답하기
handlePendingSessionLimitsExhausted()로 사용자의 선택을 런타임에 반환합니다. action에는 SessionLimitsExhaustedResponseAction의 케이스를 지정합니다.
Add: 현재 한도에 지정한 AI 크레딧을 추가합니다.additionalAiCredits를 지정합니다.Set: 한도를 새로운 절대값으로 변경합니다.maxAiCredits를 지정합니다.Unset: 세션 한도를 해제합니다.Cancel: 한도를 변경하지 않고 차단된 모델 요청을 취소합니다.