revenium/hermes-revenium

hermes-revenium은(는) 무엇을 하나요?

Hermes 에이전트를 위한 예산 집행 및 토큰 계량 스킬입니다. Revenium을 통해 AI 지출을 추적하고, 구성 가능한 예산 가드레일을 적용하며, 사용량을 자동으로 보고하여 에이전트가 토큰 예산을 초과하는 일이 없도록 합니다.

개요

이 스킬은 Hermes 에이전트가 AI API 사용량을 실시간으로 모니터링하고 제어할 수 있도록 지원합니다. Revenium 플랫폼과 통합되어 각 요청의 비용을 추적하고 예산 한도에 도달하면 자동으로 대응합니다.

설치

# Hermes 에이전트에 스킬 추가
hermes install revenium/hermes-revenium

구성

필수 환경 변수를 설정하세요:

export REVENIUM_API_KEY="your-api-key"
export REVENIUM_BUDGET_LIMIT="100"  # USD 단위 예산 한도
export REVENIUM_ALERT_THRESHOLD="80"  # 경고 임계값 (백분율)

사용법

예산 확인

hermes run revenium/hermes-revenium check-budget

사용량 보고서 생성

hermes run revenium/hermes-revenium report-usage

동작 방식

이 스킬은 Hermes 에이전트의 각 API 호출을 가로채어 Revenium에 비용 정보를 전송합니다. 예산 한도에 도달하면 다음과 같은 조치를 취합니다:

• 경고 임계값 초과: 경고 로그 출력 및 알림 전송
• 예산 한도 초과: 추가 API 호출 차단 및 오류 반환

지원 플랫폼

• Claude Code
• Cursor
• Codex
• 기타 Hermes 기반 에이전트

예시

# 예산 상태 확인 예시
response = await hermes.run("revenium/hermes-revenium check-budget")
print(response.status)  # "OK" 또는 "LIMIT_REACHED"

문제 해결

자세한 내용은 Revenium 문서를 참조하세요.