Guida alla configurazione di Hermes Agent
I modelli, i fornitori e gli endpoint personalizzati per l'agente Hermes sono memorizzati in ~/.hermes/config.yaml; informazioni sensibili come API Key vengono memorizzate ~/.hermes/.env. ai2save utilizza l'interfaccia compatibile OpenAI e l'URL di base è https://ai2save.com/v1.
1. Crea una chiave API
- Aprite!https://ai2save.com/keys](https://ai2save.com/keys).
- Creare una chiave e selezionare il gruppo che contiene il modello di destinazione.
- Copiare il completo
sk-...Chiave. - Registrare il vero modello ID visualizzato nella console, ad esempio,
gpt-5.5.
2. Utilizza la procedura guidata integrata (consigliato)
Correre nel terminal:
hermes model
Selezionare secondo le istruzioni:
Custom endpoint (self-hosted / vLLM / etc.)
Inserire in ordine:
API base URL: https://ai2save.com/v1
API key: sk-your-api-key
Model name: gpt-5.5
Il mago scriverà questi valori in ~/.hermes/config.yaml. Non scrivere l'URL di base a .env; Hermes stipula ufficialmente che la configurazione endpoint modello viene da config.yaml.
3. Modifica manualmente il file di configurazione
Modifica ~/.hermes/config.yaml:
model:
provider: custom
default: gpt-5.5
base_url: https://ai2save.com/v1
key_env: AI2SAVE_API_KEY
Descrizione del campo:
provider: custom: Utilizzare qualsiasi punto finale compatibile OpenAI.default: ID modello predefinito, deve corrispondere l'ID del modello aperto nella console esattamente.base_url: Deve includere/v1, Hermes sarà richiesta/chat/completionssulla base di questo.key_env: Punti al nome variabile dell'ambiente in cui viene memorizzata la chiave.
Modifica ~/.hermes/.env:
AI2SAVE_API_KEY=sk-your-api-key
.env memorizza informazioni sensibili, config.yaml memorizza la configurazione del modello non sensibile. Non impegnare .env a Git.
4. Scrivi le impostazioni tramite i comandi di configurazione
È inoltre possibile utilizzare i comandi forniti da Hermes per evitare errori di indentazione YAML:
hermes config set model.provider custom
hermes config set model.default gpt-5.5
hermes config set model.base_url https://ai2save.com/v1
hermes config set model.key_env AI2SAVE_API_KEY
hermes config set AI2SAVE_API_KEY sk-your-api-key
hermes config check
AI2SAVE_API_KEY è un nome variabile dell'ambiente superiore, e Hermes scriverà automaticamente ~/.hermes/.env.
5. Riavvia e verifica
- Esci completamente dall'attuale sessione di Hermes o Gateway.
- Riavviare Hermes.
- Avviare una nuova sessione e inviare una breve domanda.
- Inserisci
/modelnella sessione per confermare che il modello attuale ècustom/gpt-5.5ogpt-5.5.
Utilizzare temporaneamente un modello specificato:
hermes chat --provider custom --model gpt-5.5
Per la prima verifica, si consiglia di disabilitare le attività parallele e gli strumenti complessi ed inviare solo testi brevi. Dopo l'autenticazione e la connettività del modello vengono stabiliti, abilitare gradualmente strumenti come terminale, web e file.
6. Errori comuni
- 401 / invalid_api_key:
AI2SAVE_API_KEYnon esiste o il valore è incompleto. Executehermes config get model.key_envper verificare il riferimento. - 404 - Categoria non trovata:
model.defaultnon è un vero modello ID aperto nella console. - La connessione non è riuscita:
base_urldovrebbe esserehttps://ai2save.com/v1; non scriverlo comehttps://ai2save.com. - Configurazione non efficace: Il vecchio
OPENAI_BASE_URLsolo colpisceopenai-apiFornitore, non si applica automaticamente acustom; Verificaconfig.yamlpermodel.base_url. - YAML parsing fallito: Non hanno duplicato
model:blocchi; unire tutti i campi nello stesso blocco. - Esclusione chiamata strumento: In primo luogo assicurarsi che il modello supporta la chiamata degli strumenti e utilizzare una breve richiesta di testo per stabilire una linea base prima di abilitare gli utensiliet.