1. 설정 단계
1단계: Custom Endpoints 열기
왼쪽 메뉴에서 Providers → Custom Endpoints로 이동한 뒤, 아래의 New endpoint를 클릭하여 새 엔드포인트를 생성합니다.
2단계: Gravitex 게이트웨이 정보 입력
Edit Endpoint 양식에 다음과 같이 입력합니다:
Use for new chats와 Discover models에 체크하고 Test를 클릭하여 연결을 확인한 뒤, Save를 클릭하여 저장합니다.
3단계: Gateway Connection 모드 확인
왼쪽 메뉴에서 Gateways로 이동하여 Connection mode를 확인합니다. 기본값은 Local gateway(로컬 실행, 오프라인 지원)이며, Gravitex 연동 시에는 일반적으로 변경할 필요가 없습니다. Hermes 백엔드를 원격지나 클라우드에서 실행해야 할 경우에만 Hermes Cloud / Remote gateway / Connect via SSH로 전환하세요.
4단계: Model에서 gravitex 선택
왼쪽 메뉴에서 Model로 이동하여, 2단계에서 설정한gravitex를 모델 드롭다운에서 선택하고 Apply를 클릭하여 적용합니다. Vision, Web extract, Compression, Skills hub, Approval, MCP, Title gen 등 보조 작업에 별도 모델을 지정하려면 아래 Auxiliary models에서 항목별로 Change를 클릭하세요. 기본적으로는 모두 메인 모델을 따릅니다 (auto · use main model).
5단계: 메시지 전송 테스트
Chat 페이지로 돌아가 메시지를 전송하여 gravitex 게이트웨이로부터 정상적인 응답을 받는지 확인합니다.2. 성공 확인 방법
- Model 선택기에서
gravitex가 보이고 선택한 뒤 Apply 클릭 시 오류가 없어야 합니다. - Chat에서 메시지를 전송한 후
invalid api key/endpoint unavailable/model_not_found오류 없이 정상적인 응답을 받아야 합니다.
3. 문제 해결
4. 보안 안내
- API Key는 비밀번호와 동일합니다. 공개 문서, 채팅 기록, 스크린샷 또는 코드 저장소에 작성하지 마세요.
- Custom Endpoint 세부 정보에는 환경 변수 형식으로(Key가 표시될 수 있습니다. 공공 장소에서 스크린샷을 공유하지 마세요.
- Key가 채팅, 로그 또는 스크린샷에서 유출된 경우 즉시 Gravitex 콘솔에서 폐기하고 재생성하세요.