본문으로 건너뛰기

AI 사용량

stub 가이드 (이슈 #1403 pattern — cycle 19 신규) — cycle 18 PR #1452 의 패턴으로 작성된 minimum-viable 가이드. 실제 사용 데이터가 표시된 스크린샷은 운영 시드 작업 (#1159) 후 후속 사이클에서 추가됩니다.

개요​

GenD 의 모든 LLM 호출에서 발생한 토큰 사용량 · 비용을 집계합니다. 기간 / use_case / workspace / provider 별 grouping 으로 비용 출처를 분석하고 quota 정책에 활용합니다.

  • 메뉴 경로: /admin/llm-usage
  • 서비스 도메인: Admin (LLM Provider 관리, Epic #1414)

주요 기능​

  • 기간 필터 (7d / 30d / 90d)
  • group by — use_case / workspace / provider
  • call log 최근 호출 이력
  • quota 알림 임계값

기본 사용 흐름​

  1. 사이드바 또는 직접 URL 로 페이지 진입
  2. 헤더 영역의 새로 만들기 / 새로고침 등 CTA 로 데이터 작업
  3. 행/카드에 hover 하여 노출되는 액션 (상세 / 수정 / 삭제 등) 으로 개별 항목 관리

destructive 액션 (삭제) 은 다이얼로그 confirm 이 필수이며, 가능한 경우 soft delete 로 동작합니다.

관련 API​

/api/v1/llm-usage/summary, /api/v1/llm-usage/log

상세 응답 스키마는 API Reference 의 해당 라우터 섹션을 참조하세요.

관련 가이드​