Hermes Agent에서 Muapi 사용

Muapi를 사용자 지정 OpenAI 호환 엔드포인트로 설정해 Hermes Agent에서 텍스트 모델을 이용하세요.

1. 키 생성 및 모델 선택

Muapi 대시보드에서 API 키를 만들고 텍스트 모델을 조회합니다.

curl -s "https://api.muapi.ai/v1/models?type=text" \
  -H "Authorization: Bearer $MUAPI_API_KEY"

capabilities.tools: true인 모델을 고르세요. Hermes 에이전트 워크플로에는 최소 64,000 토큰의 컨텍스트 창이 필요하므로 모델의 제한을 확인하세요.

2. Hermes Agent 설정

모델 설정 마법사를 실행합니다.

hermes model

Custom endpoint를 선택하고 https://api.muapi.ai/v1, Muapi API 키, 목록의 정확한 모델 ID를 입력합니다.

또는 ~/.hermes/config.yaml을 설정합니다.

model:
  default: YOUR_MODEL_ID
  provider: custom
  base_url: https://api.muapi.ai/v1
  key_env: MUAPI_API_KEY

키는 ~/.hermes/.env에 저장합니다.

MUAPI_API_KEY=your-muapi-api-key

YOUR_MODEL_ID를 Muapi 목록의 정확한 ID로 바꾸세요.

3. Hermes Agent 시작

hermes
# 또는:
hermes --tui

도구를 쓰는 작은 작업을 시도하세요. 모델이 작동하면 hermes gateway setup으로 메시징 플랫폼을 연결할 수 있습니다.

문제 해결

  • URL 끝이 /v1인지, 키가 사용 가능한지, 모델 ID가 정확한지 확인하세요.
  • 도구 호출이 안 되면 capabilities.tools: true인 모델을 선택하세요.
  • Hermes에는 64K 이상의 컨텍스트 창이 필요합니다.
  • 작은 작업부터 시작하고 Muapi 대시보드에서 사용량을 확인하세요.

자세한 내용은 Hermes Agent 공급자 문서와 설정 가이드를 참조하세요.