초과 캡

​

캡 설정

• 캡 금액 — 결제 기간당 달러. 이 위로 요청 거부.
• Notify at — Nora 가 결제 담당에게 이메일하는 임계값 (기본: 캡의 80%).

# 월 $50 초과 캡
nora billing set-overage-cap --cents 5000

# 캡 클리어 — 플랜 기본 사용
nora billing set-overage-cap --clear

​

캡에서 무슨 일

• 미터링 표면 새 요청이 HTTP 402 Payment Required 반환.
• 스케줄 실행 일시정지.
• Foundry 파이프라인 일시정지.
• 기존 진행 중 실행이 정상 완료.
• 채팅 트래픽이 친근한 에러 메시지 얻음 (“이 워크스페이스가 사용량 캡 도달; 관리자에게 연락”).

• 결제 기간이 롤오버 (사용량 카운터 리셋).
• 캡 올림.
• 캡 클리어 (무제한).

​

캡 알림

• 워크스페이스 Owner.
• 결제 담당.
• Settings → Billing → Notification recipients 의 주소.

Trigger: overage_percentage > 80%
Channel: Slack (#nora-billing)

​

플랜 기본 vs. 커스텀 캡

• 캡 설정 없음 → 플랜의 기본 초과 제한 사용.
• 캡 설정 → 커스텀 값이 이김, 플랜 기본보다 낮거나 높아도.

​

캡 설정할 때

• 고정 예산의 Free / Team — 월 상한에 캡.
• Dev / 스테이징 워크스페이스 — 폭주 스크립트가 예산 고갈 안 하도록 낮게 캡.
• 새 워크스페이스 — 한 달 사용량 관찰까지 보수적 캡.
• 고객 계약의 Enterprise — 스코프 크리프 방지 위해 계약별 캡.

​

캡 안 할 때

• 예측 불가 트래픽의 프로덕션 워크스페이스 — 캡 히트가 장애 뜻함. 실제 트래픽 블랙홀할 캡보다 알림 + 수동 상향 선호.
• 컴플라이언스 크리티컬 워크로드 — 캡 히트가 인시던트 됨. 대신 알림 + 모니터.

​

캡과 실행당 비용 제한

• Flow 전역 max cost — Flow 별 캡 (Flow 설정 참고).
• Agent max cost — Agent 별 캡 (nora agents update --set-max-cost 참고).

• Agent 별 캡이 어느 단일 Agent 도 폭주 루프 못하게 방지.
• Flow 전역 캡이 어느 단일 Flow 도 불균형 비용 소비 방지.
• 초과 캡이 워크스페이스 전체 폭주 방지.

​

캡 올리기

​

비용 예측

# 현재 초과 퍼센트
state=$(nora billing state --json)
used=$(echo "$state" | jq '.overage_cents_used')
cap=$(echo "$state" | jq '.overage_cap_cents')
pct=$(echo "$used $cap" | awk '{ if ($2 > 0) printf "%.1f\n", $1/$2*100; else print 0 }')
echo "Overage: ${pct}%"

​

관련

• 결제 개요
• 인보이스
• 알림 — 임계값 크로싱에 알림.
• nora billing set-overage-cap — CLI 레퍼런스.