Guida agli agenti Flaq AI

Guida pratica all'uso di Hermes Agent con i servizi API di Flaq AI

Usa l'endpoint compatibile con Hermes Agent di Flaq AI per configurare rapidamente Hermes Agent con Flaq e accedere ai nostri servizi di modelli dal terminale. Dopo aver configurato la tua chiave API, segui gli esempi in questa guida per scegliere un modello attualmente supportato e verificare la configurazione.

Guide per agenti

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1

Installa

Installare Hermes Agent

Installa Hermes Agent per il tuo sistema, ricarica la shell se necessario, quindi verifica il comando hermes prima di aggiungere le impostazioni Flaq AI. Se l'installer apre la procedura guidata di configurazione, puoi saltare l'accesso a Nous Portal e configurare Flaq manualmente in seguito.

1

Installare Hermes Agent

Scegli l'installer adatto al tuo sistema, quindi esegui il comando di installazione qui sotto.

  • L'installer potrebbe aprire la procedura guidata di configurazione di Hermes.
  • Per la configurazione Flaq, puoi saltare l'accesso a Nous Portal e continuare con la configurazione manuale qui sotto.

Script di installazione ufficiale

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

Ricaricare il profilo shell

Esegui questo dopo l'installazione se il comando hermes non è ancora disponibile. Usa source ~/.bashrc se la tua shell usa bash.

Ricaricare il profilo shell

source ~/.zshrc
3

Verificare Hermes Agent

Conferma che il comando hermes sia disponibile prima di aggiungere le credenziali Flaq AI.

Verificare l'installazione

hermes --version

Configura

Collegare Hermes Agent a Flaq AI

Scegli un modello attualmente supportato dall'endpoint compatibile con OpenAI di Flaq, salva la tua chiave API Flaq in ~/.hermes/.env e punta config.yaml all'URL base dell'API Flaq.

Modello testuale consigliato come default affidabile per un workflow di sviluppo con Hermes Agent.

Usa i comandi Hermes CLI per scrivere la chiave API Flaq e le impostazioni del modello con meno modifiche manuali ai file. Questo aggiorna le impostazioni Hermes locali, quindi esegui prima il backup della configurazione esistente se usi già Hermes.

Scrive la chiave Flaq, il modello selezionato, il provider personalizzato, l'URL base e la lunghezza del contesto tramite comandi di configurazione Hermes.

Configurazione rapida con Hermes CLI

hermes config set FLAQ_API_KEY Your_Api_Keyhermes config set model.default gpt-5.4-text-to-texthermes config set model.provider customhermes config set model.base_url https://api.flaq.ai/api/v1hermes config set model.api_key '${FLAQ_API_KEY}'hermes config set model.context_length 128000hermes config check

Verifica

Verificare Flaq in Hermes Agent

Esegui un rapido comando one-shot di Hermes. Una risposta normale significa che Hermes può chiamare modelli tramite l'endpoint LLM di Flaq.

Avviare la modalità interattiva

hermes

Comando di test rapido

hermes -m gpt-5.4-text-to-text -z "What is 2+2?"

Diagnostica configurazione

hermes config check

Impostare il modello selezionato come default

hermes config set model.default gpt-5.4-text-to-text

Risoluzione dei problemi

FAQ su Hermes Agent

L'uso di questa configurazione della guida può aumentare significativamente l'utilizzo dei token.