# Wie integrieren Sie Hermes Agent mit Atlas Cloud? > Verbinde Hermes Agent mit Atlas Cloud, indem du den Atlas-Cloud-Schlüssel in ~/.hermes/.env speicherst, den Anbieter auf „custom“ setzt, die Basis-URL auf https://api.atlascloud.ai/v1 festlegst und eine Live-Modell-ID aus /v1/models auswählst. Hermes Agent kann [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) als benutzerdefinierten OpenAI-kompatiblen Inferenzanbieter nutzen. Für die Integration werden drei Dinge benötigt: ein Atlas Cloud API-Schlüssel, die Basis-URL `https://api.atlascloud.ai/v1` und eine [Modell-ID aus der Atlas-Cloud-Modellliste](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new). Sobald diese in der aktuellen `model:`-Konfiguration von Hermes Agent eingetragen sind, kann der Agent über Atlas Cloud ausgeführt werden, ohne ein anbieterspezifisches SDK. > **Wichtige Erkenntnisse** > > * Installieren Sie Hermes Agent mit dem offiziellen Installer und bewahren Sie den Atlas-Cloud-Schlüssel in `~/.hermes/.env` auf, nicht in der Versionsverwaltung. > * Konfigurieren Sie Hermes Agent mit `provider: custom` und `base_url: https://api.atlascloud.ai/v1`. > * Fragen Sie `/v1/models` ab, bevor Sie ein Modell auswählen. Modellnamen ändern sich schneller als Integrationscode, daher ist die Live-Antwort sicherer als das Kopieren einer alten ID aus einem Tutorial. > * Führen Sie `hermes doctor` aus, bevor Sie einen langlebigen Agenten starten, und verwenden Sie dann `hermes`, um die erste Konversation zu testen. > * Die einheitliche API von Atlas Cloud ermöglicht es, das Sprachmodell später zu ändern, ohne die Hermes-Integration neu aufbauen zu müssen. ## Was sind Hermes Agent und Atlas Cloud? [Hermes Agent](https://github.com/NousResearch/hermes-agent) ist ein quelloffener, selbstverbessernder Agent, der von Nous Research entwickelt wurde. Er umfasst ein Terminal-Interface, persistenten Speicher, Fähigkeiten, geplante Automatisierungen, Messaging-Gateways und Unterstützung für mehrere Inferenzanbieter. Die aktuelle Dokumentation von Hermes Agent betont, dass Modelle geändert werden können, ohne den Agenten neu zu schreiben. [Die Hauptplattform von Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) stellt hunderte Sprach-, Bild-, Video- und Audiomodelle über eine einheitliche API bereit. Für Hermes Agent ist der wichtige Teil die OpenAI-kompatible Inferenzoberfläche: Hermes kann Atlas Cloud als benutzerdefinierten Anbieter behandeln und normale Chat-Completion-Anfragen an ihn senden. Diese Kombination ist nützlich, wenn Hermes Agent unabhängig von einem einzelnen Modellanbieter bleiben soll. Die Agentenkonfiguration bleibt stabil, während das ausgewählte Atlas-Cloud-Modell je nach Anforderungen, Preisen oder Verfügbarkeit geändert werden kann. ## Bevor Sie beginnen Sie benötigen: 1. Eine Linux-, macOS-, WSL2- oder unterstützte Windows-Umgebung. 2. Eine funktionierende Hermes-Agent-Installation. 3. Ein Atlas-Cloud-Konto und einen API-Schlüssel. 4. Ausreichend Atlas-Cloud-Guthaben oder Kontozugriff für das ausgewählte Modell. Fügen Sie keinen echten API-Schlüssel in ein öffentliches Repository, Issue, einen Screenshot oder eine gemeinsame Konfigurationsdatei ein. Hermes Agent unterstützt eine lokale `.env`-Datei, damit Geheimnisse von der normalen Konfiguration getrennt bleiben können. ## Schritt 1: Hermes Agent installieren Unter Linux, macOS oder WSL2 verwenden Sie den von Nous Research veröffentlichten Installer: ```bash curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` Laden Sie Ihre Shell nach der Installation neu: ```bash source ~/.zshrc ``` Wenn Sie Bash verwenden, laden Sie stattdessen `~/.bashrc` neu. Bestätigen Sie dann, dass die CLI verfügbar ist: ```bash hermes --help ``` Das offizielle Projekt unterstützt auch natives Windows über seinen PowerShell-Installer. Folgen Sie der aktuellen [Hermes Agent Installationsdokumentation](https://hermes-agent.nousresearch.com/docs/), anstatt den Unix-Befehl selbst in PowerShell zu übersetzen. ## Schritt 2: Atlas Cloud API-Schlüssel erstellen Melden Sie sich in der Atlas-Cloud-Konsole an und erstellen Sie einen API-Schlüssel für diese Hermes-Agent-Bereitstellung. Verwenden Sie einen dedizierten Schlüssel, wenn Ihr Konto dies zulässt. Die Trennung des Agentenverkehrs erleichtert spätere Rotation und Nutzungsüberprüfung. Speichern Sie den Schlüssel in der lokalen Umgebungsdatei von Hermes Agent: ```bash printf '\nOPENAI_API_KEY=%s\n' 'ersetzen-sie-durch-ihren-atlas-cloud-schlüssel' >> ~/.hermes/.env ``` Ersetzen Sie den Platzhalter lokal. Fügen Sie den echten Schlüssel nicht in `config.yaml` ein, wenn diese Datei gesichert, synchronisiert oder committet wird. Warum `OPENAI_API_KEY` verwenden? Der aktuelle benutzerdefinierte Anbieter-Pfad von Hermes Agent löst diese Umgebungsvariable auf, wenn eine explizite OpenAI-kompatible Basis-URL konfiguriert ist. Atlas Cloud verwendet die Bearer-Token-Authentifizierung auf dieser kompatiblen Schnittstelle. ## Schritt 3: Eine Live-Atlas-Cloud-Modell-ID abrufen Raten Sie nicht die Modell-ID. Überprüfen Sie die [Atlas-Cloud-Modellliste](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new) und fragen Sie dann die API nach dem aktuellen Katalog: ```bash export ATLASCLOUD_API_KEY='ersetzen-sie-durch-ihren-atlas-cloud-schlüssel' curl https://api.atlascloud.ai/v1/models \ -H "Authorization: Bearer $ATLASCLOUD_API_KEY" ``` Wählen Sie ein Textmodell, das das Verhalten unterstützt, das Ihre Hermes-Bereitstellung benötigt, insbesondere Tool-Nutzung, Reasoning, Kontextlänge und erwartete Latenz. Kopieren Sie die exakte `id`, die von der API zurückgegeben wird. Für einen persistenten Agenten beginnen Sie mit einem Allzweck-Tool-fähigen Modell, anstatt nur auf den günstigsten Token-Preis zu optimieren. Nachdem die Integration funktioniert, können Sie kostengünstigere Modelle für Zusammenfassungen oder andere Routineaufgaben testen. ## Schritt 4: Hermes Agent auf Atlas Cloud ausrichten Öffnen Sie `~/.hermes/config.yaml` und konfigurieren Sie den aktuellen obersten `model:`-Abschnitt: ```yaml model: default: "ersetzen-sie-durch-eine-live-atlas-cloud-modell-id" provider: "custom" base_url: "https://api.atlascloud.ai/v1" ``` Bewahren Sie den Schlüssel in `~/.hermes/.env` auf; die YAML-Datei benötigt nur den Anbieter, den Endpunkt und die Modell-ID. Dieses Detail ist wichtig, weil ältere Hermes-Agent-Beispiele möglicherweise einen `inference:`-Block verwenden. Das aktuelle offizielle Konfigurationsbeispiel verwendet `model:`. Wenn Ihre installierte Version sich anders verhält, führen Sie `hermes update` aus und überprüfen Sie die mit dieser Version ausgelieferte Konfigurationsdokumentation, bevor Sie weitere Einstellungen ändern. ## Schritt 5: Konfiguration diagnostizieren Führen Sie die integrierten Prüfungen von Hermes Agent aus: ```bash hermes doctor ``` Starten Sie dann den Agenten: ```bash hermes ``` Senden Sie eine kleine Testanfrage, die keine externen Tools benötigt, z. B.: ```text Antworte mit dem Modellnamen, den du verwendest, und fasse dann zusammen, welche Tools in dieser Hermes-Sitzung verfügbar sind. ``` Eine normale gestreamte Antwort bestätigt, dass Hermes sich authentifizieren, den Atlas-Cloud-Endpunkt erreichen und das konfigurierte Modell aufrufen kann. ## Häufige Integrationsprobleme ### Authentifizierungsfehler Überprüfen Sie, ob `OPENAI_API_KEY` in `~/.hermes/.env` existiert, den Atlas-Cloud-Schlüssel ohne zusätzliche Anführungszeichen oder Leerzeichen enthält und von derselben Hermes-Installation geladen wird, die Sie ausführen. Rotieren Sie den Schlüssel, wenn er offengelegt wurde. ### Unbekannte Modellfehler Rufen Sie `https://api.atlascloud.ai/v1/models` erneut auf und kopieren Sie die exakte Live-ID. Entfernen Sie keinen Anbieterpräfix oder kürzen Sie die Kennung, es sei denn, die API-Antwort selbst verwendet die kürzere Form. ### Hermes ruft den falschen Anbieter auf Stellen Sie sicher, dass die aktive Konfiguration beides enthält: ```yaml provider: "custom" base_url: "https://api.atlascloud.ai/v1" ``` Die Auswahl eines integrierten Anbieters kann die Anfrage an den eigenen Endpunkt dieses Anbieters statt an Atlas Cloud leiten. ### Die Konfiguration entspricht einem alten Tutorial, schlägt aber fehl Hermes Agent entwickelt sich schnell weiter. Vergleichen Sie Ihre Datei mit der aktuellen [offiziellen Konfigurationsreferenz](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) und verwenden Sie `hermes config get`, um das aktive Profil zu inspizieren. Überprüfen Sie insbesondere, ob Ihre Version die aktuelle `model:`-Struktur erwartet. ## Wie man Modelle ändert, ohne die Integration neu aufzubauen Sobald Atlas Cloud als benutzerdefinierter Anbieter konfiguriert ist, erfordert der Wechsel von Modellen nur eine neue ID aus dem [Live-Modellkatalog](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new): 1. Fragen Sie `/v1/models` ab. 2. Aktualisieren Sie `model.default` in `~/.hermes/config.yaml`. 3. Führen Sie `hermes doctor` aus. 4. Starten Sie eine neue Testkonversation. Der Endpunkt und die Schlüsselverwaltung bleiben gleich. Dies ist der praktische Wert einer einheitlichen API für einen Agenten: Die Modellevaluierung wird zu einer Konfigurationsänderung anstatt zu einer neuen SDK-Integration. ## Wann dieses Setup geeignet ist Die Atlas-Cloud-Integration ist eine gute Wahl, wenn: * Sie möchten, dass Hermes Agent über ein Konto auf mehrere Modellfamilien zugreifen kann. * Sie erwarten, das Hauptmodell im Laufe der Zeit zu benchmarken oder zu ersetzen. * Sie einen OpenAI-kompatiblen Endpunkt möchten anstatt anbieterspezifischen Client-Code. * Ihre zukünftigen Hermes-Fähigkeiten möglicherweise Zugriff auf Bild- oder Videomodelle von derselben Plattform benötigen. Eine direkte Modellanbieter-Integration kann einfacher sein, wenn der Agent dauerhaft einen Anbieter verwendet und Sie den breiteren Modellkatalog von Atlas Cloud nicht benötigen. Die richtige Wahl hängt davon ab, ob Flexibilität und zentralisierter Zugriff wichtiger sind als die kürzestmögliche Single-Provider-Einrichtung. ## Abschließende Checkliste Bevor Sie Hermes Agent unbeaufsichtigt laufen lassen, überprüfen Sie alle fünf Punkte: - Der Atlas-Cloud-Schlüssel wird außerhalb der Versionsverwaltung gespeichert. - `provider` ist auf `custom` gesetzt. - `base_url` lautet genau `https://api.atlascloud.ai/v1`. - `model.default` entspricht einer ID vom Live-Modelle-Endpunkt. - `hermes doctor` und eine einfache Konversation sind erfolgreich. Mit diesen Prüfungen ist Hermes Agent in Atlas Cloud integriert. Sie können nun verschiedene Sprachmodelle hinter demselben Agenten evaluieren, ohne dessen Tools, Speicher, Fähigkeiten oder Benutzeroberfläche zu ändern. ## FAQ ### Hat Hermes Agent einen integrierten Atlas Cloud-Anbieter? Ein dedizierter Atlas Cloud-Anbieter ist nicht erforderlich. Hermes Agent kann sich über seinen benutzerdefinierten OpenAI-kompatiblen Anbieter unter Verwendung der Atlas Cloud-Basis-URL und des API-Schlüssels verbinden. ### Was ist die Atlas Cloud Basis-URL für Hermes Agent? Verwenden Sie https://api.atlascloud.ai/v1 als die OpenAI-kompatible Basis-URL. ### Wo sollte ich den Atlas Cloud API-Schlüssel speichern? Speichern Sie es in ~/.hermes/.env als OPENAI_API_KEY und halten Sie den echten Schlüssel fern von Konfigurationsdateien, Screenshots und Versionskontrolle. ### Welches Atlas Cloud Modell sollte Hermes Agent verwenden? Rufen Sie https://api.atlascloud.ai/v1/models ab und wählen Sie ein aktuelles Textmodell aus, das Ihre Anforderungen an Werkzeugnutzung, logisches Denken, Kontext, Latenz und Kosten erfüllt. ### Wie kann ich die Integration überprüfen? Führen Sie hermes doctor aus, starten Sie Hermes mit dem Befehl hermes und senden Sie eine kleine Testaufforderung. Authentifizierungs- oder unbekannte Modellfehler weisen normalerweise auf den API-Schlüssel, die Basis-URL oder die Modell-ID hin.