Hermes Agent에서 RunAPI를 사용자 지정 endpoint로 사용할 수 있나요?

네. Hermes Agent는 모델 선택과 사용자 지정 endpoint를 지원합니다. 이름 있는 custom provider에 RunAPI /v1 base URL을 설정하고, API key는 RUNAPI_API_KEY에 두고, gpt-5.2 같은 RunAPI 모델을 선택하세요.

hermes model을 사용해야 하나요, 아니면 config 파일을 편집해야 하나요?

안내형 선택기를 원하면 hermes model을 사용하세요. 서버나 공유 환경에서 반복 가능한 설정이 필요하면 config 파일을 편집하세요. 두 경우 모두 이후 hermes doctor로 확인하는 것이 좋습니다.

Hermes Agent용 RUNAPI_API_KEY는 어디에 설정해야 하나요?

Hermes Agent를 실행하는 같은 shell, service unit 또는 gateway 환경에 RUNAPI_API_KEY를 설정하세요. GUI 또는 daemon 실행은 대화형 shell 변수를 항상 상속하지는 않습니다.

RunAPI를 추가한 뒤에도 Hermes Agent에서 다른 provider를 사용할 수 있나요?

네. RunAPI를 custom:runapi로 추가해도 다른 Hermes Agent 모델 옵션은 제거되지 않습니다. 설정된 모델 사이를 전환하려면 hermes model 또는 /model 명령을 사용하세요.

HERMES AGENT 가이드

Hermes Agent에서 RunAPI를 사용하세요.

Hermes Agent는 채팅 모델용 OpenAI 호환 사용자 지정 endpoint를 사용할 수 있습니다. Prompt를 Hermes Agent에 붙여넣고 custom provider 생성을 맡기세요. 정확한 YAML이 필요할 때만 config 탭을 사용하면 됩니다.

무료 API Key 받기 문서 읽기

Prompt 복사 · 하나의 RunAPI key · Hermes CLI workflow

Configure this Hermes Agent install to use RunAPI.

Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Add a custom provider named runapi.
- Use base_url "https://runapi.ai/v1".
- Use key_env RUNAPI_API_KEY.
- Use api_mode chat_completions.
- Set model.provider to custom:runapi.
- Set the default model to gpt-5.2.
- Run `hermes doctor` and report any config problems before starting a session.
- If RUNAPI_API_KEY is missing, ask me to set it before starting Hermes Agent.

custom_providers:
  - name: runapi
    base_url: "https://runapi.ai/v1"
    key_env: RUNAPI_API_KEY
    api_mode: chat_completions

model:
  provider: custom:runapi
  default: gpt-5.2

export RUNAPI_API_KEY="runapi_xxx"
hermes model
hermes doctor
hermes

Copy prompt first /v1

개요

이 설정이 바꾸는 것

Hermes Agent는 hermes model을 통한 모델 선택을 지원하며 이름이 있는 사용자 지정 endpoint와 함께 동작할 수 있습니다. 가장 빠른 방법은 RunAPI 설정 Prompt를 Hermes Agent에 붙여넣고 agent가 자체 config를 업데이트하게 하는 것입니다. key는 RUNAPI_API_KEY에 유지하고, base URL은 RunAPI /v1 endpoint로 설정한 뒤 긴 세션을 시작하기 전에 hermes doctor를 실행하세요.

설정

Prompt로 Hermes Agent에 RunAPI 설치

설정 Prompt 붙여넣기

첫 번째 탭의 Prompt를 Hermes Agent에 복사하세요. 이 Prompt는 Hermes Agent가 RUNAPI_API_KEY를 읽고 RunAPI를 이름 있는 custom provider로 추가하도록 지시합니다.

Prompt 복사

생성된 config 확인

Hermes Agent는 provider를 custom:runapi로 설정하고 기본값을 gpt-5.2로 두며 key_env가 RUNAPI_API_KEY를 가리키게 해야 합니다.

provider: custom:runapi

진단 실행

config를 수정한 뒤 hermes doctor를 실행하고, Hermes Agent를 열어 짧은 테스트 Prompt를 보낸 다음 더 큰 작업에 사용하세요.

hermes doctor

참고

설정 필드

필드	값	목적
`custom_providers.name`	`runapi`	Hermes Agent가 custom:runapi로 선택할 수 있는 이름 있는 사용자 지정 endpoint를 만듭니다.
`base_url`	`https://runapi.ai/v1`	Hermes Agent가 RunAPI의 OpenAI 호환 API 표면을 바라보게 합니다.
`key_env`	`RUNAPI_API_KEY`	RunAPI key를 하드코딩하지 않고 환경 변수에서 읽습니다.
`api_mode`	`chat_completions`	OpenAI 호환 chat request 형식을 사용합니다.

FAQ

Hermes Agent 설정 질문

Hermes Agent 안에서 하나의 RunAPI key를 사용하세요.

카탈로그에서 모델을 선택하고 사용자 지정 endpoint를 설정한 뒤 다음 agent 실행 전에 Hermes Agent를 확인하세요.

모델 보기 →