ai2saveai2save

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

  1. Aprite!https://ai2save.com/keys](https://ai2save.com/keys).
  2. Creare una chiave e selezionare il gruppo che contiene il modello di destinazione.
  3. Copiare il completo sk-... Chiave.
  4. 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/completions sulla 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

  1. Esci completamente dall'attuale sessione di Hermes o Gateway.
  2. Riavviare Hermes.
  3. Avviare una nuova sessione e inviare una breve domanda.
  4. Inserisci /model nella sessione per confermare che il modello attuale è custom/gpt-5.5 o gpt-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_KEY non esiste o il valore è incompleto. Execute hermes config get model.key_env per verificare il riferimento.
  • 404 - Categoria non trovata: model.default non è un vero modello ID aperto nella console.
  • La connessione non è riuscita: base_url dovrebbe essere https://ai2save.com/v1; non scriverlo come https://ai2save.com.
  • Configurazione non efficace: Il vecchio OPENAI_BASE_URL solo colpisce openai-api Fornitore, non si applica automaticamente a custom; Verifica config.yaml per model.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.