# Hoe integreer je Hermes Agent met Atlas Cloud? > Verbind Hermes Agent met Atlas Cloud door de Atlas Cloud-sleutel op te slaan in ~/.hermes/.env, de provider op custom te zetten, de basis-URL in te stellen op https://api.atlascloud.ai/v1, en een live model-ID te kiezen uit /v1/models. Hermes Agent kan [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) gebruiken als een aangepaste OpenAI-compatibele inferenceprovider. De integratie vereist drie dingen: een Atlas Cloud API-sleutel, de basis-URL `https://api.atlascloud.ai/v1` en een [model-ID uit de modelenlijst van Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new). Zodra deze in de huidige `model:`-configuratie van Hermes Agent staan, kan de agent via Atlas Cloud draaien zonder een providerspecifieke SDK. > **Belangrijkste punten** > > * Installeer Hermes Agent met de officiële installer en bewaar de Atlas Cloud-sleutel in `~/.hermes/.env` in plaats van in versiebeheer. > * Configureer Hermes Agent met `provider: custom` en `base_url: https://api.atlascloud.ai/v1`. > * Raadpleeg `/v1/models` voordat u een model kiest. Modelnamen veranderen sneller dan integratiecode, dus de live-respons is veiliger dan het kopiëren van een oude ID uit een tutorial. > * Voer `hermes doctor` uit voordat u een langlopende agent start en gebruik vervolgens `hermes` om het eerste gesprek te testen. > * De unified API van Atlas Cloud maakt het mogelijk om later van taalmodel te wisselen zonder de Hermes-integratie opnieuw te bouwen. ## Wat zijn Hermes Agent en Atlas Cloud? [Hermes Agent](https://github.com/NousResearch/hermes-agent) is een open-source, zelfverbeterende agent gebouwd door Nous Research. Het omvat een terminalinterface, persistente geheugen, vaardigheden, geplande automatiseringen, berichtengateways en ondersteuning voor meerdere inferenceproviders. De huidige documentatie van Hermes Agent benadrukt dat modellen kunnen worden gewijzigd zonder de agent te herschrijven. [Het hoofdplatform van Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) biedt honderden taal-, beeld-, video- en audiomodellen via een unified API. Voor Hermes Agent is het belangrijkste onderdeel de OpenAI-compatibele inference-interface: Hermes kan Atlas Cloud behandelen als een aangepaste provider en er normale chat-completion-verkeer naartoe sturen. Deze combinatie is handig als u wilt dat Hermes Agent onafhankelijk blijft van één enkele modelleverancier. De agentconfiguratie blijft stabiel, terwijl het geselecteerde Atlas Cloud-model kan veranderen naarmate vereisten, prijzen of beschikbaarheid veranderen. ## Voordat u begint U heeft nodig: 1. Een Linux-, macOS-, WSL2- of ondersteunde Windows-omgeving. 2. Een werkende Hermes Agent-installatie. 3. Een Atlas Cloud-account en API-sleutel. 4. Voldoende Atlas Cloud-saldo of accounttoegang voor het geselecteerde model. Plak geen echte API-sleutel in een openbare repository, issue, screenshot of gedeeld configuratiebestand. Hermes Agent ondersteunt een lokaal `.env`-bestand, specifiek zodat geheimen gescheiden kunnen blijven van gewone configuratie. ## Stap 1: Installeer Hermes Agent Gebruik op Linux, macOS of WSL2 de installer die door Nous Research is gepubliceerd: ```bash curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` Herlaad uw shell na installatie: ```bash source ~/.zshrc ``` Als u Bash gebruikt, herlaad dan `~/.bashrc`. Bevestig vervolgens dat de CLI beschikbaar is: ```bash hermes --help ``` Het officiële project ondersteunt ook native Windows via de PowerShell-installer. Volg de huidige [Hermes Agent-installatiedocumentatie](https://hermes-agent.nousresearch.com/docs/) in plaats van het Unix-commando zelf naar PowerShell te vertalen. ## Stap 2: Maak een Atlas Cloud API-sleutel aan Meld u aan bij de Atlas Cloud-console en maak een API-sleutel aan voor deze Hermes Agent-implementatie. Gebruik een speciale sleutel wanneer uw accountinstellingen dit toestaan; het scheiden van agentverkeer maakt later roteren en gebruikscontrole eenvoudiger. Bewaar de sleutel in het lokale omgevingsbestand van Hermes Agent: ```bash printf '\nOPENAI_API_KEY=%s\n' 'replace-with-your-atlas-cloud-key' >> ~/.hermes/.env ``` Vervang de placeholder lokaal. Neem de echte sleutel niet op in `config.yaml` als dat bestand wordt geback-upt, gesynchroniseerd of gecommit. Waarom `OPENAI_API_KEY` gebruiken? Het huidige pad voor aangepaste providers van Hermes Agent lost die omgevingsvariabele op wanneer een expliciete OpenAI-compatibele basis-URL is geconfigureerd. Atlas Cloud gebruikt bearer-token-authenticatie op die compatibele interface. ## Stap 3: Haal een live Atlas Cloud-model-ID op Raad de model-ID niet. Controleer de [modelenlijst van Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new) en vraag vervolgens de API om de huidige catalogus: ```bash export ATLASCLOUD_API_KEY='replace-with-your-atlas-cloud-key' curl https://api.atlascloud.ai/v1/models \ -H "Authorization: Bearer $ATLASCLOUD_API_KEY" ``` Kies een tekstmodel dat het gedrag ondersteunt dat uw Hermes-implementatie nodig heeft, met name toolgebruik, redeneren, contextlengte en verwachte latentie. Kopieer de exacte `id` die door de API wordt geretourneerd. Begin voor een persistente agent met een algemeen, tool-capable model in plaats van alleen te optimaliseren voor de goedkoopste tokenprijs. Nadat de integratie werkt, kunt u goedkopere modellen testen voor samenvattingen of andere routinetaken. ## Stap 4: Wijs Hermes Agent naar Atlas Cloud Open `~/.hermes/config.yaml` en configureer de huidige `model:`-sectie op het hoogste niveau: ```yaml model: default: "replace-with-a-live-atlas-cloud-model-id" provider: "custom" base_url: "https://api.atlascloud.ai/v1" ``` Bewaar de sleutel in `~/.hermes/.env`; het YAML-bestand heeft alleen de provider, endpoint en model-ID nodig. Dit detail is belangrijk omdat oudere Hermes Agent-voorbeelden een `inference:`-blok kunnen gebruiken. Het huidige officiële configuratievoorbeeld gebruikt `model:`. Als uw geïnstalleerde versie zich anders gedraagt, voer dan `hermes update` uit en raadpleeg de configuratiedocumentatie die bij die versie wordt geleverd voordat u meer instellingen wijzigt. ## Stap 5: Diagnosticeer de configuratie Voer de ingebouwde controles van Hermes Agent uit: ```bash hermes doctor ``` Start vervolgens de agent: ```bash hermes ``` Stuur een klein testverzoek dat geen externe tools nodig heeft, bijvoorbeeld: ```text Antwoord met de naam van het model dat je gebruikt, en vat vervolgens samen welke tools beschikbaar zijn in deze Hermes-sessie. ``` Een normale gestreamde respons bevestigt dat Hermes kan authenticeren, het Atlas Cloud-eindpunt kan bereiken en het geconfigureerde model kan aanroepen. ## Veelvoorkomende integratieproblemen ### Authenticatiefouten Controleer of `OPENAI_API_KEY` bestaat in `~/.hermes/.env`, de Atlas Cloud-sleutel bevat zonder extra aanhalingstekens of spaties, en wordt geladen door dezelfde Hermes-installatie die u gebruikt. Roteer de sleutel als deze is blootgesteld. ### Onbekende modelfouten Roep `https://api.atlascloud.ai/v1/models` opnieuw aan en kopieer de exacte live-ID. Verwijder geen providerprefix of verkort de identifier tenzij de API-respons zelf de kortere vorm gebruikt. ### Hermes roept de verkeerde provider aan Bevestig dat de actieve configuratie beide bevat: ```yaml provider: "custom" base_url: "https://api.atlascloud.ai/v1" ``` Het selecteren van een ingebouwde provider kan het verzoek naar het eigen endpoint van die provider sturen in plaats van naar Atlas Cloud. ### De configuratie komt overeen met een oude tutorial maar faalt Hermes Agent ontwikkelt zich snel. Vergelijk uw bestand met de huidige [officiële configuratiereferentie](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) en gebruik `hermes config get` om het actieve profiel te inspecteren. Controleer met name of uw versie de huidige `model:`-structuur verwacht. ## Hoe modellen te wijzigen zonder de integratie opnieuw te bouwen Zodra Atlas Cloud is geconfigureerd als de aangepaste provider, vereist het wisselen van modellen alleen een nieuwe ID uit de [live modelencatalogus](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new): 1. Vraag `/v1/models` op. 2. Werk `model.default` bij in `~/.hermes/config.yaml`. 3. Voer `hermes doctor` uit. 4. Start een nieuw testgesprek. Het endpoint en de afhandeling van inloggegevens blijven hetzelfde. Dit is de praktische waarde van een unified API voor een agent: modelevaluatie wordt een configuratiewijziging in plaats van een nieuwe SDK-integratie. ## Wanneer deze opstelling een goede keuze is De Atlas Cloud-integratie is een goede keuze wanneer: * U met Hermes Agent toegang wilt tot meerdere modelfamilies via één account. * U verwacht het hoofdmodel in de loop van de tijd te benchmarken of te vervangen. * U een OpenAI-compatibel endpoint wilt in plaats van providerspecifieke clientcode. * Uw toekomstige Hermes-vaardigheden mogelijk toegang nodig hebben tot beeld- of videomodellen van hetzelfde platform. Een directe modelproviderintegratie kan eenvoudiger zijn als de agent permanent één provider gebruikt en u de bredere modelcatalogus van Atlas Cloud niet nodig heeft. De juiste keuze hangt af van of flexibiliteit en gecentraliseerde toegang belangrijker zijn dan de kortst mogelijke opstelling met één provider. ## Definitieve checklist Voordat u Hermes Agent onbeheerd laat draaien, controleert u alle vijf punten: - De Atlas Cloud-sleutel is buiten versiebeheer opgeslagen. - `provider` is ingesteld op `custom`. - `base_url` is exact `https://api.atlascloud.ai/v1`. - `model.default` komt overeen met een ID van het live modellen-eindpunt. - `hermes doctor` en een eenvoudig gesprek zijn beide succesvol. Met deze controles voltooid, is Hermes Agent geïntegreerd met Atlas Cloud. U kunt nu verschillende taalmodellen evalueren achter dezelfde agent zonder de tools, het geheugen, de vaardigheden of de gebruikersinterface te wijzigen. ## FAQ ### Heeft Hermes Agent een ingebouwde Atlas Cloud-provider? Een speciale Atlas Cloud provider is niet vereist. Hermes Agent kan verbinding maken via zijn eigen OpenAI-compatibele provider met behulp van de Atlas Cloud basis-URL en API-sleutel. ### Wat is de basis-URL van Atlas Cloud voor Hermes Agent? Gebruik https://api.atlascloud.ai/v1 als de OpenAI-compatibele basis-URL. ### Waar moet ik de Atlas Cloud API-sleutel opslaan? Bewaar het in ~/.hermes/.env als OPENAI_API_KEY en houd de echte sleutel uit configuratiebestanden, schermafbeeldingen en versiebeheer. ### Welk Atlas Cloud-model moet Hermes Agent gebruiken? Raadpleeg https://api.atlascloud.ai/v1/models en kies een actueel tekstmodel dat voldoet aan uw vereisten op het gebied van toolgebruik, redeneren, context, latentie en kosten. ### Hoe kan ik de integratie verifiëren? Voer hermes doctor uit, start Hermes met het hermes-commando en stuur een kleine testprompt. Authenticatiefouten of fouten met een onbekend model wijzen meestal op de API-sleutel, basis-URL of model-ID.