메인 콘텐츠로 건너뛰기
sessionLimits를 사용하면 Copilot 세션의 현재 집계 기간에 대해 소프트 AI 크레딧 한도를 설정할 수 있습니다. 세션 생성 시와 재개 시 모두 설정할 수 있습니다.

한도 설정

SessionLimitsConfig의 maxAiCredits에 한도를 전달합니다. 사용량은 각 모델 호출이 완료된 후에 확인되므로, 하나의 응답이 설정값을 초과할 수 있습니다. 한도를 초과하면 런타임은 다음 모델 호출을 차단합니다.
SessionConfig와 ResumeSessionConfig 모두 sessionLimits를 SessionLimitsConfig 인스턴스 또는 배열로 받습니다.

한도 이벤트

세션 이벤트를 수신하여 한도 변경에 대응하고, 한도에 도달했을 때 사용자에게 확인을 요청할 수 있습니다. 예를 들어 SESSION_LIMITS_EXHAUSTED_REQUESTED를 수신하면 이벤트 데이터를 사용해 확인 UI를 표시합니다.

한도 소진에 응답하기

handlePendingSessionLimitsExhausted()로 사용자의 선택을 런타임에 반환합니다. action에는 SessionLimitsExhaustedResponseAction의 케이스를 지정합니다.
사용 가능한 액션은 다음과 같습니다.
  • Add: 현재 한도에 지정한 AI 크레딧을 추가합니다. additionalAiCredits를 지정합니다.
  • Set: 한도를 새로운 절대값으로 변경합니다. maxAiCredits를 지정합니다.
  • Unset: 세션 한도를 해제합니다.
  • Cancel: 한도를 변경하지 않고 차단된 모델 요청을 취소합니다.
session_limits_exhausted.requested와 session_limits_exhausted.completed를 사용하는 한도 소진 프롬프트 흐름 및 관련 응답 API는 실험적 기능입니다. 향후 변경되거나 삭제될 수 있습니다.
마지막 수정일 2026년 10월 26일