# Comment intégrer Hermes Agent avec Atlas Cloud ? > Connectez Hermes Agent à Atlas Cloud en stockant la clé Atlas Cloud dans ~/.hermes/.env, en sélectionnant le fournisseur : custom, en définissant l'URL de base sur https://api.atlascloud.ai/v1, et en choisissant un ID de modèle actif depuis /v1/models. L'agent Hermes peut utiliser [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) comme fournisseur d'inférence personnalisé compatible OpenAI. L'intégration nécessite trois éléments : une clé API Atlas Cloud, l'URL de base `https://api.atlascloud.ai/v1`, et un [identifiant de modèle issu de la liste des modèles d'Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new). Une fois ceux-ci intégrés dans la configuration actuelle `model:` de l'agent Hermes, celui-ci peut fonctionner via Atlas Cloud sans SDK spécifique au fournisseur. > **Points clés à retenir** > > * Installez Hermes Agent avec l'installateur officiel, puis conservez la clé Atlas Cloud dans `~/.hermes/.env` plutôt que dans le système de contrôle de version. > * Configurez Hermes Agent avec `provider: custom` et `base_url: https://api.atlascloud.ai/v1`. > * Interrogez `/v1/models` avant de choisir un modèle. Les noms de modèles évoluent plus vite que le code d'intégration, donc la réponse en direct est plus fiable que de copier un ancien identifiant depuis un tutoriel. > * Exécutez `hermes doctor` avant de lancer un agent long, puis utilisez `hermes` pour tester la première conversation. > * L'API unifiée d'Atlas Cloud permet de changer ultérieurement le modèle de langage sans avoir à reconstruire l'intégration Hermes. ## Que sont Hermes Agent et Atlas Cloud ? [Hermes Agent](https://github.com/NousResearch/hermes-agent) est un agent open source auto-améliorant développé par Nous Research. Il comprend une interface terminal, une mémoire persistante, des compétences, des automations planifiées, des passerelles de messagerie et la prise en charge de plusieurs fournisseurs d'inférence. La documentation actuelle d'Hermes Agent souligne que les modèles peuvent être changés sans réécrire l'agent. [La plateforme principale d'Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) expose des centaines de modèles de langage, d'image, de vidéo et d'audio via une API unifiée. Pour Hermes Agent, la partie importante est sa surface d'inférence compatible OpenAI : Hermes peut traiter Atlas Cloud comme un fournisseur personnalisé et lui envoyer du trafic normal de complétion de chat. Cette association est utile lorsque vous souhaitez qu'Hermes Agent reste indépendant d'un seul fournisseur de modèles. La configuration de l'agent reste stable, tandis que le modèle Atlas Cloud sélectionné peut changer en fonction des besoins, des tarifs ou de la disponibilité. ## Avant de commencer Vous avez besoin : 1. D'un environnement Linux, macOS, WSL2 ou Windows pris en charge. 2. D'une installation fonctionnelle d'Hermes Agent. 3. D'un compte Atlas Cloud et d'une clé API. 4. D'un crédit Atlas Cloud suffisant ou d'un accès au compte pour le modèle que vous sélectionnez. Ne collez pas une vraie clé API dans un dépôt public, un ticket, une capture d'écran ou un fichier de configuration partagé. Hermes Agent prend en charge un fichier `.env` local afin que les secrets puissent rester séparés de la configuration ordinaire. ## Étape 1 : Installer Hermes Agent Sur Linux, macOS ou WSL2, utilisez l'installateur publié par Nous Research : ```bash curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` Rechargez votre shell après l'installation : ```bash source ~/.zshrc ``` Si vous utilisez Bash, rechargez `~/.bashrc` à la place. Confirmez ensuite que la CLI est disponible : ```bash hermes --help ``` Le projet officiel prend également en charge Windows nativement via son installateur PowerShell. Suivez la [documentation d'installation actuelle d'Hermes Agent](https://hermes-agent.nousresearch.com/docs/) plutôt que de traduire vous-même la commande Unix en PowerShell. ## Étape 2 : Créer une clé API Atlas Cloud Connectez-vous à la console Atlas Cloud et créez une clé API pour ce déploiement d'Hermes Agent. Utilisez une clé dédiée lorsque les contrôles de votre compte le permettent ; séparer le trafic de l'agent facilite les rotations ultérieures et la révision de l'utilisation. Stockez la clé dans le fichier d'environnement local d'Hermes Agent : ```bash printf '\nOPENAI_API_KEY=%s\n' 'remplacez-par-votre-clé-atlas-cloud' >> ~/.hermes/.env ``` Remplacez le placeholder localement. N'incluez pas la vraie clé dans `config.yaml` si ce fichier doit être sauvegardé, synchronisé ou versionné. Pourquoi utiliser `OPENAI_API_KEY` ? Le chemin actuel du fournisseur personnalisé d'Hermes Agent résout cette variable d'environnement lorsqu'une URL de base explicite compatible OpenAI est configurée. Atlas Cloud utilise l'authentification par jeton bearer sur cette interface compatible. ## Étape 3 : Obtenir un identifiant de modèle Atlas Cloud en direct Ne devinez pas l'identifiant du modèle. Consultez la [liste des modèles Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new), puis demandez le catalogue actuel à l'API : ```bash export ATLASCLOUD_API_KEY='remplacez-par-votre-clé-atlas-cloud' curl https://api.atlascloud.ai/v1/models \ -H "Authorization: Bearer $ATLASCLOUD_API_KEY" ``` Choisissez un modèle de texte qui prend en charge le comportement dont votre déploiement Hermes a besoin, en particulier l'utilisation d'outils, le raisonnement, la longueur du contexte et la latence attendue. Copiez exactement l'`id` renvoyé par l'API. Pour un agent persistant, commencez par un modèle généraliste compatible avec les outils plutôt que d'optimiser uniquement le prix par token le plus bas. Une fois l'intégration fonctionnelle, vous pourrez tester des modèles moins coûteux pour le résumé ou d'autres tâches courantes. ## Étape 4 : Pointer Hermes Agent vers Atlas Cloud Ouvrez `~/.hermes/config.yaml` et configurez la section `model:` actuelle au niveau supérieur : ```yaml model: default: "remplacez-par-un-identifiant-de-modèle-atlas-cloud-en-direct" provider: "custom" base_url: "https://api.atlascloud.ai/v1" ``` Conservez la clé dans `~/.hermes/.env` ; le fichier YAML n'a besoin que du fournisseur, du point de terminaison et de l'identifiant du modèle. Ce détail est important car les anciens exemples d'Hermes Agent peuvent utiliser un bloc `inference:`. L'exemple de configuration officiel actuel utilise `model:`. Si votre version installée se comporte différemment, exécutez `hermes update` et consultez la documentation de configuration fournie avec cette version avant de modifier d'autres paramètres. ## Étape 5 : Diagnostiquer la configuration Exécutez les vérifications intégrées d'Hermes Agent : ```bash hermes doctor ``` Puis démarrez l'agent : ```bash hermes ``` Envoyez une petite requête de test qui n'a pas besoin d'outils externes, par exemple : ```text Répondez avec le nom du modèle que vous utilisez, puis résumez les outils disponibles dans cette session Hermes. ``` Une réponse en streaming normale confirme qu'Hermes peut s'authentifier, atteindre le point de terminaison Atlas Cloud et appeler le modèle configuré. ## Problèmes d'intégration courants ### Erreurs d'authentification Vérifiez que `OPENAI_API_KEY` existe dans `~/.hermes/.env`, contient la clé Atlas Cloud sans guillemets ni espaces supplémentaires, et qu'elle est chargée par la même installation Hermes que vous utilisez. Faites pivoter la clé si elle a été exposée. ### Erreurs de modèle inconnu Appelez à nouveau `https://api.atlascloud.ai/v1/models` et copiez exactement l'identifiant en direct. Ne supprimez pas un préfixe de fournisseur et ne raccourcissez pas l'identifiant, sauf si la réponse de l'API elle-même utilise la forme plus courte. ### Hermes appelle le mauvais fournisseur Confirmez que la configuration active contient les deux éléments : ```yaml provider: "custom" base_url: "https://api.atlascloud.ai/v1" ``` La sélection d'un fournisseur intégré peut rediriger la requête vers son propre point de terminaison au lieu d'Atlas Cloud. ### La configuration correspond à un ancien tutoriel mais échoue Hermes Agent évolue rapidement. Comparez votre fichier avec la [référence de configuration officielle actuelle](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) et utilisez `hermes config get` pour inspecter le profil actif. Vérifiez notamment si votre version attend la structure `model:` actuelle. ## Comment changer de modèle sans reconstruire l'intégration Une fois Atlas Cloud configuré comme fournisseur personnalisé, changer de modèle nécessite seulement un nouvel identifiant du [catalogue de modèles en direct](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new) : 1. Interrogez `/v1/models`. 2. Mettez à jour `model.default` dans `~/.hermes/config.yaml`. 3. Exécutez `hermes doctor`. 4. Démarrez une nouvelle conversation de test. Le point de terminaison et la gestion des identifiants restent les mêmes. C'est la valeur pratique d'une API unifiée pour un agent : l'évaluation du modèle devient un changement de configuration plutôt qu'une nouvelle intégration SDK. ## Quand cette configuration est pertinente L'intégration Atlas Cloud est particulièrement adaptée lorsque : * Vous souhaitez qu'Hermes Agent accède à plusieurs familles de modèles via un seul compte. * Vous prévoyez d'évaluer ou de remplacer le modèle principal au fil du temps. * Vous souhaitez un point de terminaison compatible OpenAI plutôt qu'un code client spécifique à un fournisseur. * Vos futures compétences Hermes peuvent nécessiter un accès à des modèles d'image ou de vidéo à partir de la même plateforme. Une intégration directe avec un fournisseur de modèles peut être plus simple si l'agent utilise en permanence un seul fournisseur et que vous n'avez pas besoin du catalogue plus large d'Atlas Cloud. Le bon choix dépend de la priorité accordée à la flexibilité et à l'accès centralisé par rapport à la simplicité d'une configuration mono-fournisseur. ## Liste de vérification finale Avant de laisser Hermes Agent fonctionner sans surveillance, vérifiez les cinq points : - La clé Atlas Cloud est stockée en dehors du contrôle de version. - `provider` est défini sur `custom`. - `base_url` est exactement `https://api.atlascloud.ai/v1`. - `model.default` correspond à un identifiant du point de terminaison des modèles en direct. - `hermes doctor` et une conversation simple réussissent tous deux. Une fois ces vérifications effectuées, Hermes Agent est intégré à Atlas Cloud. Vous pouvez maintenant évaluer différents modèles de langage derrière le même agent sans modifier ses outils, sa mémoire, ses compétences ou son interface utilisateur. ## FAQ ### Est-ce que Hermes Agent a un Atlas Cloud provider intégré ? Un fournisseur Atlas Cloud dédié n'est pas requis. Hermes Agent peut se connecter via son fournisseur personnalisé compatible OpenAI en utilisant l'URL de base et la clé API d'Atlas Cloud. ### Quelle est l'URL de base d'Atlas Cloud pour Hermes Agent ? Utilisez https://api.atlascloud.ai/v1 comme URL de base compatible OpenAI. ### Où dois-je stocker la clé API Atlas Cloud ? Stockez-le dans ~/.hermes/.env sous la forme OPENAI_API_KEY et gardez la vraie clé hors des fichiers de configuration, des captures d'écran et du contrôle de version. ### Quel modèle Atlas Cloud l'agent Hermes devrait-il utiliser ? Interrogez https://api.atlascloud.ai/v1/models et choisissez un modèle de texte actuel qui répond à vos exigences en matière d'utilisation d'outils, de raisonnement, de contexte, de latence et de coût. ### Comment puis-je vérifier l'intégration ? Exécutez hermes doctor, démarrez Hermes avec la commande hermes, et envoyez une petite invite de test. Les erreurs d'authentification ou de modèle inconnu indiquent généralement un problème avec la clé API, l'URL de base ou l'identifiant du modèle.