Hermes Agent

Hermes Agent est un agent de terminal qui peut lire et écrire des fichiers, exécuter des commandes et appeler des outils après autorisation.

Ce tutoriel utilise le Custom Endpoint intégré à Hermes Agent, sans autre gestionnaire de configuration, pour connecter Chat Completions d’AGTCloud et valider la conversation de base. Les fichiers, la recherche Web, MCP, Skills et les extensions ne sont pas couverts par cette validation.

Prérequis

Avant de commencer, vérifiez que vous avez :

Préparé un système et un terminal pris en charge par Hermes Agent ;
Créé un compte AGTCloud et ouvert une session ;
Créé une API Key AGTCloud dans API Keys ;
Copié dans le catalogue de modèles un ID accessible à l’API Key et compatible Chat Completions ;
Préparé un répertoire de test sans code sensible ni identifiants de production.

Installer Hermes Agent

Choisissez la méthode officielle adaptée. La première version macOS prend en charge Apple Silicon ; les Mac Intel, Homebrew et PyPI ne font pas partie du support officiel actuel.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Après installation, rouvrez le terminal et vérifiez la version et l’environnement :

hermes version
hermes doctor

hermes doctor vérifie l’installation, la configuration et les problèmes courants d’environnement. Si hermes est introuvable, rouvrez le terminal, puis vérifiez PATH. Consultez les plateformes officiellement prises en charge pour les autres limites.

Configurer AGTCloud

Hermes Agent propose un assistant de fournisseur de modèles. Exécutez la commande suivante dans un terminal ordinaire, pas dans une conversation Hermes déjà ouverte :

hermes model

Choisir Custom Endpoint

Dans Provider, choisissez Custom endpoint. Selon la version, le nom complet peut être Custom endpoint (self-hosted / VLLM / etc.).

Renseigner la connexion AGTCloud

Suivez l’assistant actuel dans cet ordre :

Champ Hermes Agent	Valeur
`Provider Name` (si présent)	`AGTCloud`
`API Base URL`	`https://api.agtcloud.cn/v1`
`API Key`	`your-api-key`
`API / Wire Mode`	`Chat Completions` ou `chat_completions`
`Model`	`MODEL_ID`
`Context Length`	Laisser vide au début pour permettre une détection automatique par le client

Remplacez your-api-key par l’API Key AGTCloud et MODEL_ID par un modèle accessible à celle-ci.

Enregistrer

Vérifiez le résumé de l’assistant, puis enregistrez. Les paramètres ordinaires vont dans ~/.hermes/config.yaml ; Hermes Agent conserve les valeurs sensibles telles que l’API Key dans ~/.hermes/.env.

La Base URL doit contenir /v1

Utilisez directement https://api.agtcloud.cn/v1, pas seulement l’API Origin, ni l’adresse complète /v1/chat/completions, et n’ajoutez pas un second /v1.

Privilégiez l’assistant officiel

Les champs peuvent évoluer avec les versions. hermes model laisse la version actuelle écrire le Provider et le mode de transport corrects, sans édition YAML manuelle. N’inscrivez pas de véritable API Key dans des exemples partagés.

Vérifier la configuration

Après l’assistant, vérifiez les paramètres avec :

hermes config
hermes config get model
hermes config check

hermes config ouvre ou affiche l’interface de configuration ;
hermes config get model vérifie les paramètres du modèle ;
hermes config check vérifie le format et les champs nécessaires.

Ne copiez pas et ne partagez pas l’API Key complète affichée. Si un autre Provider reste configuré, relancez hermes model et terminez Custom Endpoint.

Démarrer et valider la connexion

Ouvrir un répertoire de test sûr

cd /path/to/safe/test-project

N’effectuez pas la première connexion dans un répertoire contenant des identifiants de production, des données clients ou des sources non publiques.

Démarrer Hermes Agent

hermes

Vous pouvez aussi lancer une session interactive via hermes chat.

Valider la conversation de base

Saisissez :

Répondez uniquement : connexion AGTCloud réussie. N’appelez aucun outil.

Une réponse normale confirme la Base URL, l’API Key, le modèle et la connexion Chat Completions de base. Cette étape entraîne une consommation API normale.

Facultatif : valider les appels d’outils

Si le modèle prend en charge les outils, saisissez dans un répertoire de test avec README.md :

Veuillez lire uniquement README.md et résumer l’objectif du projet en trois points. Ne modifiez aucun fichier et n’exécutez aucune autre commande.

Conservez l’approbation humaine par défaut, examinez l’opération prévue et décidez ensuite de l’autoriser.

Ne désactivez pas l’approbation lors du premier usage

N’utilisez pas --yolo et ne désactivez pas l’approbation des actions dangereuses. Hermes Agent peut exécuter des commandes et accéder aux fichiers : confirmez chaque demande d’outil lors de la première validation.

Changer de modèle

Pour ajouter un modèle, modifier l’Endpoint ou changer l’API Key, quittez la session et exécutez :

hermes model

Dans une session ouverte, /model bascule entre les Provider et modèles déjà configurés. Il ne crée pas de nouveau Custom Endpoint : configurez d’abord un modèle absent avec la commande de terminal hermes model.

MODEL_ID est fictif. Utilisez toujours l’ID complet accessible à votre API Key dans le catalogue de modèles, sans dépendre de recommandations fixes susceptibles de changer.

Questions fréquentes

Symptôme	Vérifier en priorité	Solution
Commande `hermes` introuvable	Installation et `PATH`	Rouvrez le terminal, exécutez `hermes version`, puis relancez l’installation officielle adaptée si nécessaire
Anomalie dans `hermes doctor`	Python, outils système et répertoire	Corrigez l’environnement selon le diagnostic, sans mélanger plusieurs sources d’installation
Réponse `401`	API Key et état du Token	Copiez une clé valide, sans espaces superflus
Réponse `403`	Autorisations et état du compte	Vérifiez la clé et les modèles accessibles dans la console
Réponse `404`	Base URL, doublon `/v1` et ID du modèle	Utilisez `https://api.agtcloud.cn/v1`, sans Endpoint complet, et recopiez l’ID complet
Modèle indisponible	Modèles accessibles et protocole	Choisissez un modèle accessible à l’API Key et compatible Chat Completions
Un autre Provider reste utilisé	Sélection et enregistrement dans `hermes model`	Relancez l’assistant, choisissez Custom Endpoint et vérifiez via `hermes config check`
La conversation fonctionne, mais pas les outils	Capacités et format de réponse	Choisissez un modèle avec outils, désactivez les outils complexes et validez une seule lecture
Détection du contexte impossible	Métadonnées et valeur manuelle	Relancez `hermes model` ; saisissez une limite manuelle uniquement si vous connaissez la limite réelle
Identifiants d’extension absents	Services distincts des outils auxiliaires	Ces capacités peuvent exiger des services et identifiants supplémentaires, hors de la clé du modèle principal AGTCloud

En cas de problème non identifié, exécutez hermes doctor et hermes config check, consignez l’heure, l’API Base URL, l’ID du modèle, le code HTTP et l’erreur expurgée, puis consultez Erreurs et dépannage. Ne fournissez pas d’API Key complète.

Conseils de sécurité

N’inscrivez pas l’API Key dans les fichiers de projet, Git, historiques de commandes, captures d’écran, journaux ou configurations partagées ;
Utilisez d’abord un répertoire sûr et examinez chaque accès aux fichiers, commandes et réseau ;
Ne désactivez pas les confirmations dangereuses avec --yolo ou la configuration ;
Pour du code non fiable, une isolation telle que Docker réduit le risque, mais vérifiez toujours les montages et les identifiants ;
En cas de fuite présumée, désactivez ou supprimez immédiatement l’API Key dans la console, puis créez-en une nouvelle.