# 헤르메스 에이전트를 아틀라스 클라우드와 어떻게 통합하나요? > Atlas Cloud 키를 ~/.hermes/.env에 저장하고, provider를 custom으로 선택한 후 기본 URL을 https://api.atlascloud.ai/v1로 설정하고, /v1/models에서 라이브 모델 ID를 선택하여 Hermes Agent를 Atlas Cloud에 연결하십시오. Hermes Agent는 [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud)를 사용자 정의 OpenAI 호환 추론 제공자로 사용할 수 있습니다. 통합을 위해 필요한 세 가지는 Atlas Cloud API 키, 기본 URL `https://api.atlascloud.ai/v1`, 그리고 [Atlas Cloud의 모델 목록에서 모델 ID](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new)입니다. 이 세 가지를 Hermes Agent의 현재 `model:` 설정에 추가하면 에이전트는 제공자별 SDK 없이 Atlas Cloud를 통해 실행될 수 있습니다. > **주요 내용** > > * 공식 설치 프로그램으로 Hermes Agent를 설치한 다음, Atlas Cloud 키를 소스 제어가 아닌 `~/.hermes/.env`에 보관하세요. > * Hermes Agent를 `provider: custom` 및 `base_url: https://api.atlascloud.ai/v1`로 구성하세요. > * 모델을 선택하기 전에 `/v1/models`를 조회하세요. 모델 이름은 통합 코드보다 빠르게 변경되므로, 튜토리얼에서 오래된 ID를 복사하는 것보다 실시간 응답을 사용하는 것이 더 안전합니다. > * 장기 실행 에이전트를 시작하기 전에 `hermes doctor`를 실행한 다음 `hermes`를 사용하여 첫 대화를 테스트하세요. > * Atlas Cloud의 통합 API를 사용하면 Hermes 통합을 다시 빌드하지 않고도 나중에 언어 모델을 변경할 수 있습니다. ## Hermes Agent와 Atlas Cloud란? [Hermes Agent](https://github.com/NousResearch/hermes-agent)는 Nous Research에서 구축한 오픈 소스 자체 개선 에이전트입니다. 터미널 인터페이스, 영구 메모리, 스킬, 예약된 자동화, 메시징 게이트웨이 및 여러 추론 제공자를 지원합니다. 현재 Hermes Agent 문서는 에이전트를 다시 작성하지 않고도 모델을 변경할 수 있음을 강조합니다. [Atlas Cloud의 주요 플랫폼](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud)은 통합 API를 통해 수백 개의 언어, 이미지, 비디오 및 오디오 모델을 제공합니다. Hermes Agent에게 중요한 부분은 OpenAI 호환 추론 표면입니다. Hermes는 Atlas Cloud를 사용자 정의 제공자로 취급하고 일반 채팅 완성 트래픽을 보낼 수 있습니다. 이 조합은 Hermes Agent가 단일 모델 공급업체에 종속되지 않도록 하려는 경우 유용합니다. 에이전트 구성은 안정적으로 유지되는 반면, 선택한 Atlas Cloud 모델은 요구 사항, 가격 또는 가용성이 변경됨에 따라 바뀔 수 있습니다. ## 시작하기 전에 필요한 것: 1. Linux, macOS, WSL2 또는 지원되는 Windows 환경. 2. 작동하는 Hermes Agent 설치. 3. Atlas Cloud 계정 및 API 키. 4. 선택한 모델에 충분한 Atlas Cloud 잔액 또는 계정 액세스 권한. 실제 API 키를 공개 저장소, 이슈, 스크린샷 또는 공유 구성 파일에 붙여넣지 마세요. Hermes Agent는 로컬 `.env` 파일을 지원하므로 비밀을 일반 구성과 분리할 수 있습니다. ## 1단계: Hermes Agent 설치 Linux, macOS 또는 WSL2에서 Nous Research에서 게시한 설치 프로그램을 사용하세요: ```bash curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` 설치 후 셸을 다시 로드하세요: ```bash source ~/.zshrc ``` Bash를 사용하는 경우 `~/.bashrc`를 대신 다시 로드하세요. 그런 다음 CLI를 사용할 수 있는지 확인하세요: ```bash hermes --help ``` 공식 프로젝트는 PowerShell 설치 프로그램을 통해 기본 Windows도 지원합니다. Unix 명령을 직접 PowerShell로 변환하는 대신 현재 [Hermes Agent 설치 문서](https://hermes-agent.nousresearch.com/docs/)를 따르세요. ## 2단계: Atlas Cloud API 키 생성 Atlas Cloud 콘솔에 로그인하고 이 Hermes Agent 배포용 API 키를 생성하세요. 계정 제어가 허용하는 경우 전용 키를 사용하세요. 에이전트 트래픽을 분리하면 나중에 키 순환 및 사용량 검토가 더 쉬워집니다. 키를 Hermes Agent의 로컬 환경 파일에 저장하세요: ```bash printf '\nOPENAI_API_KEY=%s\n' 'replace-with-your-atlas-cloud-key' >> ~/.hermes/.env ``` 로컬에서 플레이스홀더를 교체하세요. `config.yaml`이 백업, 동기화 또는 커밋될 경우 실제 키를 포함하지 마세요. 왜 `OPENAI_API_KEY`를 사용하나요? Hermes Agent의 현재 사용자 정의 제공자 경로는 명시적인 OpenAI 호환 기본 URL이 구성된 경우 해당 환경 변수를 확인합니다. Atlas Cloud는 해당 호환 인터페이스에서 Bearer 토큰 인증을 사용합니다. ## 3단계: 실시간 Atlas Cloud 모델 ID 가져오기 모델 ID를 추측하지 마세요. [Atlas Cloud 모델 목록](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new)을 확인한 다음 API에 현재 카탈로그를 요청하세요: ```bash export ATLASCLOUD_API_KEY='replace-with-your-atlas-cloud-key' curl https://api.atlascloud.ai/v1/models \ -H "Authorization: Bearer $ATLASCLOUD_API_KEY" ``` Hermes 배포에 필요한 동작(특히 도구 사용, 추론, 컨텍스트 길이 및 예상 지연 시간)을 지원하는 텍스트 모델을 선택하세요. API에서 반환된 정확한 `id`를 복사하세요. 영구 에이전트의 경우 가장 저렴한 토큰 가격만 최적화하지 말고 범용 도구 지원 모델부터 시작하세요. 통합이 작동하면 요약 또는 기타 일상 작업에 더 저렴한 모델을 테스트할 수 있습니다. ## 4단계: Hermes Agent를 Atlas Cloud로 연결 `~/.hermes/config.yaml`을 열고 현재 최상위 `model:` 섹션을 구성하세요: ```yaml model: default: "replace-with-a-live-atlas-cloud-model-id" provider: "custom" base_url: "https://api.atlascloud.ai/v1" ``` 키는 `~/.hermes/.env`에 보관하세요. YAML 파일에는 제공자, 엔드포인트 및 모델 ID만 필요합니다. 이 세부 사항은 이전 Hermes Agent 예제에서 `inference:` 블록을 사용할 수 있기 때문에 중요합니다. 현재 공식 구성 샘플은 `model:`을 사용합니다. 설치된 버전이 다르게 동작하는 경우 `hermes update`를 실행하고 해당 버전과 함께 제공되는 구성 문서를 확인한 후 더 많은 설정을 변경하세요. ## 5단계: 구성 진단 Hermes Agent의 내장 검사를 실행하세요: ```bash hermes doctor ``` 그런 다음 에이전트를 시작하세요: ```bash hermes ``` 외부 도구가 필요하지 않은 작은 테스트 요청을 보내세요. 예: ```text 사용 중인 모델 이름으로 응답한 다음 이 Hermes 세션에서 사용 가능한 도구를 요약하세요. ``` 정상적인 스트리밍 응답은 Hermes가 인증하고, Atlas Cloud 엔드포인트에 도달하고, 구성된 모델을 호출할 수 있음을 확인합니다. ## 일반적인 통합 문제 ### 인증 오류 `~/.hermes/.env`에 `OPENAI_API_KEY`가 존재하고, 추가 따옴표나 공백 없이 Atlas Cloud 키를 포함하고 있으며, 실행 중인 Hermes 설치와 동일한 설치에서 로드되고 있는지 확인하세요. 키가 노출된 경우 순환하세요. ### 알 수 없는 모델 오류 `https://api.atlascloud.ai/v1/models`를 다시 호출하고 정확한 실시간 ID를 복사하세요. API 응답 자체에서 더 짧은 형식을 사용하지 않는 한 제공자 접두사를 제거하거나 식별자를 줄이지 마세요. ### Hermes가 잘못된 제공자를 호출함 활성 구성에 다음이 모두 포함되어 있는지 확인하세요: ```yaml provider: "custom" base_url: "https://api.atlascloud.ai/v1" ``` 내장 제공자를 선택하면 요청이 Atlas Cloud 대신 해당 제공자의 자체 엔드포인트로 라우팅될 수 있습니다. ### 구성이 오래된 튜토리얼과 일치하지만 실패함 Hermes Agent는 빠르게 발전하고 있습니다. 파일을 현재 [공식 구성 참조](https://hermes-agent.nousresearch.com/docs/user-guide/configuration)와 비교하고 `hermes config get`을 사용하여 활성 프로필을 검사하세요. 특히 버전이 현재 `model:` 구조를 예상하는지 확인하세요. ## 통합을 다시 빌드하지 않고 모델을 변경하는 방법 Atlas Cloud가 사용자 정의 제공자로 구성되면 모델 전환은 [실시간 모델 카탈로그](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new)에서 새 ID를 가져오기만 하면 됩니다: 1. `/v1/models`를 조회합니다. 2. `~/.hermes/config.yaml`에서 `model.default`를 업데이트합니다. 3. `hermes doctor`를 실행합니다. 4. 새 테스트 대화를 시작합니다. 엔드포인트와 자격 증명 처리는 동일하게 유지됩니다. 이것이 에이전트를 위한 통합 API의 실질적인 가치입니다. 모델 평가가 새로운 SDK 통합 대신 구성 변경이 됩니다. ## 이 설정이 적합한 경우 Atlas Cloud 통합은 다음과 같은 경우에 적합합니다: * Hermes Agent가 하나의 계정으로 여러 모델 제품군에 액세스하기를 원하는 경우. * 시간이 지남에 따라 주요 모델을 벤치마킹하거나 교체할 계획이 있는 경우. * 제공자별 클라이언트 코드 대신 OpenAI 호환 엔드포인트를 원하는 경우. * 향후 Hermes 스킬이 동일한 플랫폼에서 이미지나 비디오 모델에 액세스해야 할 수 있는 경우. 에이전트가 영구적으로 하나의 제공자를 사용하고 Atlas Cloud의 더 넓은 모델 카탈로그가 필요하지 않다면 직접 모델 제공자 통합이 더 간단할 수 있습니다. 올바른 선택은 유연성과 중앙 집중식 액세스가 가장 짧은 단일 제공자 설정보다 중요한지 여부에 달려 있습니다. ## 최종 체크리스트 Hermes Agent를 무인으로 실행하기 전에 다섯 가지 항목을 모두 확인하세요: - Atlas Cloud 키가 버전 관리 외부에 저장되었습니다. - `provider`가 `custom`으로 설정되었습니다. - `base_url`이 정확히 `https://api.atlascloud.ai/v1`입니다. - `model.default`가 실시간 모델 엔드포인트의 ID와 일치합니다. - `hermes doctor`와 간단한 대화가 모두 성공합니다. 이러한 확인이 완료되면 Hermes Agent가 Atlas Cloud와 통합되었습니다. 이제 도구, 메모리, 스킬 또는 사용자 인터페이스를 변경하지 않고도 동일한 에이전트 뒤에서 다양한 언어 모델을 평가할 수 있습니다. ## FAQ ### Hermes Agent는 내장된 Atlas Cloud 제공자를 가지고 있나요? 전용 Atlas Cloud 공급자는 필요하지 않습니다. Hermes Agent는 Atlas Cloud 기본 URL과 API 키를 사용하여 자체 OpenAI 호환 공급자를 통해 연결할 수 있습니다. ### Atlas Cloud의 Hermes Agent 기본 URL은 무엇인가요? https://api.atlascloud.ai/v1을 OpenAI 호환 기본 URL로 사용하십시오. ### Atlas Cloud API 키를 어디에 저장해야 하나요? ~/.hermes/.env 파일에 OPENAI_API_KEY로 저장하고, 실제 키는 설정 파일, 스크린샷, 버전 관리에서 제외하세요. ### Hermes Agent는 어떤 Atlas Cloud 모델을 사용해야 하나요? Query https://api.atlascloud.ai/v1/models를 조회하고 도구 사용, 추론, 컨텍스트, 지연 시간 및 비용 요구 사항을 충족하는 현재 텍스트 모델을 선택하세요. ### 통합을 어떻게 확인할 수 있나요? hermes doctor를 실행하고, hermes 명령어로 Hermes를 시작한 후 작은 테스트 프롬프트를 보내세요. 인증 오류나 알 수 없는 모델 오류는 일반적으로 API 키, 베이스 URL 또는 모델 ID에 문제가 있음을 나타냅니다.