모델과 사용량
사용할 수 있는 모델, 추론 강도, 토큰 사용량, 한도 소진 시 동작을 설명합니다.
사용할 수 있는 모델
헬피코드가 쓰는 모델은 기관 단위로 결정됩니다.
- 앱 시작과 기관 변경 시, 엘리스 서버에서 헬피코드용 모델 목록을 기관 기준으로 불러옵니다.
- 기관 관리자가 모델 설정에서 활성화한 모델만 구성원에게 보입니다.
- 모델 호출은 모두 엘리스 서버를 거쳐 처리되며, 토큰 사용량은 대화 단위로 집계됩니다.
- 모델별 입력 형식(text / image / pdf)과 컨텍스트·출력 한도는 서버가 내려주는 메타데이터를 따릅니다.
- 모델 목록을 불러오지 못하면 앱은 모델 없는 상태로 시작하지 않고 시작 실패로 처리합니다.
모델 선택과 추론 강도는 대화 사용법을 참고하세요.
추론 강도(variants)
각 모델은 자신이 지원하는 추론 강도를 선언합니다. 입력창에는 빠른 응답(변형 없음), medium, high 중 모델이 지원하는 것만 표시됩니다.
사용량 확인
사용량은 기관 관리자가 설정 > 기관 관리자 > 사용량에서 확인합니다.
플랜 카드
- 무료/유료/엔터프라이즈 플랜 이름
- 부여 토큰, 사용량, 진행률(
사용량/부여량 tokens (n%)) - 만료 예정일, 토큰 갱신일(유료 월간 플랜에만 표시), 플랜 기간(개월)
- 상태 안내: "기한이 만료되었습니다", "무료 토큰이 모두 소진되었습니다", "플랜이 종료되었습니다"
개인 토큰 한도 카드
내 한도 대비 사용량(사용량/한도 tokens)을 보여 줍니다. 유료이면서 종료되지 않은 플랜에서만 표시됩니다.
이용 내역
구성원 / 기능 토글로 헬피코드 사용분의 상세 내역을 봅니다. 사용 내역이 없으면 "헬피코드에서 채팅을 시작한 후 상세 이용 내역을 확인할 수 있습니다."가 표시됩니다.
한도 소진 시 동작
한도에 도달하면 입력창과 첨부가 비활성화되고, 대화 화면 위에 안내 배너가 나타납니다. 배너는 닫을 수 있습니다.
| 상황 | 관리자에게 | 구성원에게 |
|---|---|---|
| 무료 토큰 만료 | 베이직 플랜 시작 안내 | 기관 관리자에게 문의 안내 |
| 유료 플랜 종료 | 플랜 시작 안내 | 기관 관리자에게 문의 안내 |
| 개인 토큰 한도 소진 | 토큰 한도 수정 안내 | 기관 관리자에게 문의 안내 |
| 기관 보유 토큰 소진 | 토큰 갱신일까지 기다리라는 안내(갱신일이 있을 때) | 동일 |
한도는 구성원 관리에서 정합니다.
토큰을 아끼는 방법
- 큰 탐색은 서브에이전트에게 맡겨 메인 컨텍스트를 줄입니다.
- 대화가 길어지면
/compact로 요약합니다. - 간단한 작업은 빠른 응답으로, 어려운 작업에만
high를 씁니다. AGENTS.md는 짧게 유지합니다. 매 대화의 컨텍스트에 들어갑니다.document_vision은 오래 걸리고 많이 쓰므로, 스캔 문서·표·차트에만 사용합니다.