# Hur integrerar man Hermes Agent med Atlas Cloud? > Anslut Hermes Agent till Atlas Cloud genom att lagra Atlas Cloud-nyckeln i ~/.hermes/.env, välja leverantör: custom, ställa in bas-URL till https://api.atlascloud.ai/v1, och välja ett live-modell-ID från /v1/models. Hermes Agent kan använda [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) som en anpassad OpenAI-kompatibel inferensleverantör. Integrationen kräver tre saker: en Atlas Cloud API-nyckel, bas-URL:en `https://api.atlascloud.ai/v1` och ett [modell-ID från Atlas Clouds modellista](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new). När dessa finns i Hermes Agents aktuella `model:`-konfiguration kan agenten köras via Atlas Cloud utan en leverantörsspecifik SDK. > **Viktiga insikter** > > * Installera Hermes Agent med den officiella installationsprogrammet och förvara sedan Atlas Cloud-nyckeln i `~/.hermes/.env` snarare än i versionshantering. > * Konfigurera Hermes Agent med `provider: custom` och `base_url: https://api.atlascloud.ai/v1`. > * Fråga `/v1/models` innan du väljer en modell. Modellnamn ändras snabbare än integrationskoden, så det levande svaret är säkrare än att kopiera ett gammalt ID från en handledning. > * Kör `hermes doctor` innan du startar en långvarig agent och använd sedan `hermes` för att testa den första konversationen. > * Atlas Clouds enhetliga API gör det möjligt att byta språkmodell senare utan att bygga om Hermes-integrationen. ## Vad är Hermes Agent och Atlas Cloud? [Hermes Agent](https://github.com/NousResearch/hermes-agent) är en öppen källkod, självförbättrande agent byggd av Nous Research. Den innehåller ett terminalgränssnitt, beständigt minne, färdigheter, schemalagda automatiseringar, meddelandegateways och stöd för flera inferensleverantörer. Den nuvarande Hermes Agent-dokumentationen betonar att modeller kan bytas utan att skriva om agenten. [Atlas Clouds huvudplattform](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) exponerar hundratals språk-, bild-, video- och ljudmodeller genom ett enhetligt API. För Hermes Agent är den viktiga delen dess OpenAI-kompatibla inferensyta: Hermes kan behandla Atlas Cloud som en anpassad leverantör och skicka vanlig chattkompletteringstrafik till den. Denna kombination är användbar när du vill att Hermes Agent ska förbli oberoende av en enda modellleverantör. Agentkonfigurationen förblir stabil medan den valda Atlas Cloud-modellen kan ändras när kraven, prissättningen eller tillgängligheten förändras. ## Innan du börjar Du behöver: 1. En Linux-, macOS-, WSL2- eller Windows-miljö som stöds. 2. En fungerande Hermes Agent-installation. 3. Ett Atlas Cloud-konto och en API-nyckel. 4. Tillräcklig Atlas Cloud-balans eller kontotillgång för modellen du väljer. Klistra inte in en riktig API-nyckel i ett offentligt arkiv, ärende, skärmdump eller delad konfigurationsfil. Hermes Agent stöder en lokal `.env`-fil specifikt så att hemligheter kan hållas separata från vanlig konfiguration. ## Steg 1: Installera Hermes Agent På Linux, macOS eller WSL2, använd installationsprogrammet som publicerats av Nous Research: ```bash curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` Ladda om ditt skal efter installation: ```bash source ~/.zshrc ``` Om du använder Bash, ladda om `~/.bashrc` istället. Bekräfta sedan att CLI är tillgängligt: ```bash hermes --help ``` Det officiella projektet stöder även inbyggd Windows via sitt PowerShell-installationsprogram. Följ den aktuella [Hermes Agent installationsdokumentationen](https://hermes-agent.nousresearch.com/docs/) istället för att översätta Unix-kommandot till PowerShell själv. ## Steg 2: Skapa en Atlas Cloud API-nyckel Logga in på Atlas Cloud-konsolen och skapa en API-nyckel för denna Hermes Agent-distribution. Använd en dedikerad nyckel när dina kontokontroller tillåter det; att separera agenttrafik gör senare rotation och användningsgranskning enklare. Förvara nyckeln i Hermes Agents lokala miljöfil: ```bash printf '\nOPENAI_API_KEY=%s\n' 'ersätt-med-din-atlas-cloud-nyckel' >> ~/.hermes/.env ``` Ersätt platshållaren lokalt. Inkludera inte den riktiga nyckeln i `config.yaml` om den filen kommer att säkerhetskopieras, synkroniseras eller checkas in. Varför använda `OPENAI_API_KEY`? Hermes Agents nuvarande anpassade leverantörsväg löser den miljövariabeln när en explicit OpenAI-kompatibel bas-URL är konfigurerad. Atlas Cloud använder bäraren-token-autentisering på det kompatibla gränssnittet. ## Steg 3: Hämta ett levande Atlas Cloud-modell-ID Gissa inte modell-ID:t. Kontrollera [Atlas Clouds modellista](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new), fråga sedan API:et efter den aktuella katalogen: ```bash export ATLASCLOUD_API_KEY='ersätt-med-din-atlas-cloud-nyckel' curl https://api.atlascloud.ai/v1/models \ -H "Authorization: Bearer $ATLASCLOUD_API_KEY" ``` Välj en textmodell som stöder det beteende din Hermes-distribution behöver, särskilt verktygsanvändning, resonemang, kontextlängd och förväntad latens. Kopiera det exakta `id` som returneras av API:et. För en beständig agent, börja med en generell, verktygskapabel modell snarare än att optimera enbart för det billigaste tokenpriset. När integrationen fungerar kan du testa billigare modeller för sammanfattning eller andra rutinuppgifter. ## Steg 4: Peka Hermes Agent mot Atlas Cloud Öppna `~/.hermes/config.yaml` och konfigurera den aktuella toppnivåns `model:`-sektion: ```yaml model: default: "ersätt-med-ett-levande-atlas-cloud-modell-id" provider: "custom" base_url: "https://api.atlascloud.ai/v1" ``` Förvara nyckeln i `~/.hermes/.env`; YAML-filen behöver bara leverantören, slutpunkten och modell-ID:t. Denna detalj är viktig eftersom äldre Hermes Agent-exempel kan använda ett `inference:`-block. Den nuvarande officiella konfigurationsprovet använder `model:`. Om din installerade version beter sig annorlunda, kör `hermes update` och kontrollera konfigurationsdokumentationen som medföljer den versionen innan du ändrar fler inställningar. ## Steg 5: Diagnostisera konfigurationen Kör Hermes Agents inbyggda kontroller: ```bash hermes doctor ``` Starta sedan agenten: ```bash hermes ``` Skicka en liten testförfrågan som inte behöver externa verktyg, till exempel: ```text Svara med modellnamnet du använder, sammanfatta sedan vilka verktyg som är tillgängliga i denna Hermes-session. ``` Ett normalt strömmat svar bekräftar att Hermes kan autentisera, nå Atlas Cloud-slutpunkten och anropa den konfigurerade modellen. ## Vanliga integrationsproblem ### Autentiseringsfel Kontrollera att `OPENAI_API_KEY` finns i `~/.hermes/.env`, innehåller Atlas Cloud-nyckeln utan extra citattecken eller mellanslag och laddas av samma Hermes-installation du kör. Rotera nyckeln om den har exponerats. ### Okända modellfel Anropa `https://api.atlascloud.ai/v1/models` igen och kopiera det exakta levande ID:t. Ta inte bort ett leverantörsprefix eller förkorta identifieraren om inte API-svaret själv använder den kortare formen. ### Hermes anropar fel leverantör Bekräfta att den aktiva konfigurationen innehåller båda: ```yaml provider: "custom" base_url: "https://api.atlascloud.ai/v1" ``` Att välja en inbyggd leverantör kan dirigera begäran till den leverantörens egen slutpunkt istället för Atlas Cloud. ### Konfigurationen matchar en gammal handledning men misslyckas Hermes Agent utvecklas snabbt. Jämför din fil med den aktuella [officiella konfigurationsreferensen](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) och använd `hermes config get` för att inspektera den aktiva profilen. Kontrollera särskilt om din version förväntar sig den nuvarande `model:`-strukturen. ## Hur man byter modeller utan att bygga om integrationen När Atlas Cloud är konfigurerad som den anpassade leverantören kräver byte av modeller bara ett nytt ID från den [levande modellkatalogen](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new): 1. Fråga `/v1/models`. 2. Uppdatera `model.default` i `~/.hermes/config.yaml`. 3. Kör `hermes doctor`. 4. Starta en ny testkonversation. Slutpunkten och hanteringen av autentiseringsuppgifter förblir desamma. Detta är det praktiska värdet av ett enhetligt API för en agent: modellevaluering blir en konfigurationsändring istället för en ny SDK-integration. ## När denna installation är ett bra val Atlas Cloud-integrationen är ett bra val när: * Du vill att Hermes Agent ska ha tillgång till flera modellfamiljer via ett konto. * Du förväntar dig att utvärdera eller byta ut huvudmodellen över tid. * Du vill ha en OpenAI-kompatibel slutpunkt snarare än leverantörsspecifik klientkod. * Dina framtida Hermes-färdigheter kan behöva tillgång till bild- eller videomodeller från samma plattform. En direkt modell-leverantörsintegration kan vara enklare om agenten permanent kommer att använda en leverantör och du inte behöver Atlas Clouds bredare modellkatalog. Rätt val beror på om flexibilitet och centraliserad åtkomst väger tyngre än att ha den kortast möjliga installationen med en enda leverantör. ## Slutlig checklista Innan du lämnar Hermes Agent igång obevakad, verifiera alla fem punkter: - Atlas Cloud-nyckeln förvaras utanför versionshantering. - `provider` är inställd på `custom`. - `base_url` är exakt `https://api.atlascloud.ai/v1`. - `model.default` matchar ett ID från den levande modellslutpunkten. - `hermes doctor` och en enkel konversation lyckas båda. Med dessa kontroller utförda är Hermes Agent integrerad med Atlas Cloud. Du kan nu utvärdera olika språkmodeller bakom samma agent utan att ändra dess verktyg, minne, färdigheter eller användargränssnitt. ## FAQ ### Har Hermes Agent en inbyggd Atlas Cloud-leverantör? En dedikerad Atlas Cloud-leverantör krävs inte. Hermes Agent kan ansluta via sin anpassade OpenAI-kompatibla leverantör med Atlas Cloud bas-URL och API-nyckel. ### Vad är Atlas Cloud bas-URL för Hermes Agent? Använd https://api.atlascloud.ai/v1 som den OpenAI-kompatibla bas-URL:en. ### Var ska jag lagra Atlas Cloud API-nyckeln? Lagra den i ~/.hermes/.env som OPENAI_API_KEY och håll den riktiga nyckeln borta från konfigurationsfiler, skärmdumpar och versionshantering. ### Vilken Atlas Cloud-modell ska Hermes Agent använda? Fråga https://api.atlascloud.ai/v1/models och välj en aktuell textmodell som uppfyller dina krav på verktygsanvändning, resonemang, kontext, latens och kostnad. ### Hur kan jag verifiera integrationen? Kör hermes doctor, starta Hermes med hermes-kommandot, och skicka en liten testprompt. Autentiserings- eller okänd-modell-fel pekar vanligtvis på API-nyckeln, bas-URL:en eller modell-ID:t.