Ecco la traduzione in italiano del contenuto Markdown, seguendo tutte le linee guida fornite.
La maggior parte delle persone installa Hermes Agent e lo usa come chatbot. Scrivono un prompt, ottengono una risposta, chiudono la scheda. Questo copre forse il 10% di ciò che l'agente può fare.
Questo articolo mappa ogni livello di utilizzo di Hermes Agent, dal primo prompt a un sistema che gestisce la tua attività senza di te. 15 livelli, raggruppati in tre fasi. Ogni livello si basa sul precedente, ma puoi saltare a qualsiasi livello adatto alla tua configurazione.
La struttura è la stessa per ogni livello: cos'è, cosa sblocca, come configurarlo e l'errore che fa inciampare le persone in quella fase.
Tutti i dettagli tecnici sono verificati rispetto alla documentazione ufficiale e al codice sorgente di Hermes Agent v0.17.0.
Iscriviti al mio SubStack per altri articoli: https://substack.com/@yanxbt
FASE 1 — FONDAMENTA (Livelli 1-3)
Stai usando Hermes. L'agente risponde a ciò che chiedi.
LIVELLO 1 — PROMPT SINGOLI
Cosa sono: Hai installato Hermes. Scrivi prompt. L'agente risponde con chiamate a strumenti, modifiche a file, ricerche web, comandi da terminale. Interazione di base.
Cosa sbloccano: Hermes esegue attività attraverso il tuo file system, il terminale e il web. Legge file, scrive codice, cerca su internet, esegue comandi shell. Fa cose. Un chatbot parla di cose.
Configurazione:
App desktop: scarica da hermes-agent.nousresearch.com. Installazione con un clic. CLI: hermes setup
Tre modalità di configurazione: → Configurazione rapida (Nous Portal): accesso OAuth, modello + Gateway degli strumenti in un unico comando → Configurazione completa: scorri manualmente ogni provider, strumento e opzione → Foglio bianco: tutto inizia DISATTIVO tranne provider, modello, strumenti per file e terminale. Nessuna ricerca web, nessun browser, nessuna memoria, nessuna delega, nessun cron, nessuna abilità, nessun plugin, nessun MCP. Abiliti solo ciò di cui hai bisogno. Non viene caricato nulla che non hai scelto, nemmeno dopo gli aggiornamenti.
Il foglio bianco è il punto di partenza più pulito per gli utenti che vogliono il pieno controllo su ciò che l'agente può e non può fare.
Connetti un provider di modelli. Inizia a chattare.
L'errore: Trattare Hermes come un motore di ricerca. "Parlami di X" spreca un agente che può FARE cose. "Ricerca X, scrivi un report, salvalo in ~/report/" usa gli strumenti.
Esempio: "cerca i migliori 5 CRM per fondatori singoli, confronta prezzi e funzionalità, salva un report in ~/report/confronto-crm.html" — l'agente cerca, confronta, scrive il file. Fatto in 3 minuti.
LIVELLO 2 — MEMORIA + SOUL.MD
Cosa sono: Hermes si ricorda di te tra una sessione e l'altra. SOUL.md definisce chi è l'agente. MEMORY.md e USER.md memorizzano fatti duraturi sui tuoi progetti, preferenze e contesto aziendale.
Cosa sbloccano: L'agente smette di chiederti di rispiegare le cose. Due persone che fanno la stessa domanda ottengono risposte diverse perché Hermes conosce i loro diversi contesti. Le tue istruzioni, preferenze e dettagli aziendali persistono in ogni sessione.
v0.17.0 ha aggiunto operazioni di memoria atomiche: l'agente può aggiungere, sostituire e rimuovere voci di memoria in blocco con una singola chiamata. Gli aggiornamenti di memoria non falliscono più a metà modifica quando il budget è limitato.
Configurazione:
App desktop / Dashboard: Profilo → SOUL.md → Modifica CLI: apri ~/.hermes/SOUL.md in qualsiasi editor
Scrivi 50-80 righe che coprano identità, voce, operazioni e restrizioni. L'agente legge questo file all'inizio di ogni sessione.
L'errore: Lasciare SOUL.md vuoto e aspettarsi output personalizzati. Hermes senza un SOUL.md è generico per progettazione. Il file di identità è la differenza tra un assistente generico e il TUO assistente.
Esempio: chiedi "dovrei aumentare i prezzi?" Senza SOUL.md: consigli generici sulla strategia dei prezzi. Con SOUL.md che contiene il tuo modello di business, margini e segmenti di clienti: "il tuo livello base converte al 12%. Aumentarlo di $10 rischia l'abbandono nel segmento B dove hai il 60% delle entrate. Testa prima sul segmento A."
https://x.com/IBuzovskyi/status/2065125711401062758
LIVELLO 3 — COMANDI SLASH
Cosa sono: Comandi che cambiano il modo in cui l'agente lavora a metà sessione. La maggior parte degli utenti non li digita mai.
Cosa sbloccano: Lavoro parallelo all'interno di una singola sessione. Smetti di aspettare che un'attività finisca prima di iniziare la successiva.
I comandi:
/background <prompt> Avvia un'attività in background. La tua sessione principale rimane libera. Il risultato appare come pannello una volta completato.
/steer <prompt> Inietta un messaggio nell'esecuzione corrente senza interromperla. Reindirizza l'agente a metà esecuzione.
/queue <prompt> Mette in coda un'azione successiva. Attende che l'attività corrente finisca, poi viene eseguita automaticamente.
/model <nome> Cambia modello a metà sessione. Inizia con Sonnet per la pianificazione. Passa a DeepSeek per l'esecuzione. Passa a Opus per la revisione.
v0.17.0 ha aggiunto grok-composer-2.5-fast tramite Grok OAuth: il modello di codifica con contesto 200K dietro Cursor's Composer, accessibile tramite il tuo abbonamento Grok.
Configura il comportamento predefinito quando scrivi mentre l'agente è occupato:
imposta nell'app desktop, Dashboard o config.yaml:
display: busy_input_mode: steer # o queue, o interrupt
L'errore: Non sapere che esistono. La maggior parte degli utenti scrive un prompt, aspetta che finisca, scrive un altro prompt. Solo /background raddoppia la tua produttività per sessione.
Esempio: stai abbozzando una proposta. A metà sessione: /background ricerca [concorrente] prezzi e posizionamento. Continui a scrivere. 5 minuti dopo appare un pannello con l'analisi competitiva. La incolli nella proposta senza interrompere il flusso.
FASE 2 — LEVA (Livelli 4-7)
Hermes lavora in modo più intelligente. Smetti di fare attività che l'agente può gestire.
LIVELLO 4 — SKILL + MODELLO GIUSTO PER OGNI SKILL
Cosa sono: Le skill sono documenti di conoscenza on-demand e raccolte di strumenti che l'agente carica quando necessario. Ogni skill può essere eseguita su un modello diverso.
Cosa sbloccano: L'agente diventa uno specialista su richiesta. Una skill di ricerca carica una metodologia di ricerca. Una skill di revisione del codice carica schemi di sicurezza. Ogni skill utilizza il modello più adatto al suo compito.
Configurazione:
App desktop / Dashboard: Skills Hub → Sfoglia → Installa CLI: /skills search [argomento]
v0.17.0 ha rinnovato lo Skills Hub: hub connessi (OpenAI, Anthropic, HuggingFace, NVIDIA), sezione in evidenza, anteprime complete delle skill prima dell'installazione e scansione di sicurezza su ogni skill.
v0.17.0 ha anche aggiunto la modifica delle immagini: image_generate ora modifica le immagini sorgente ("rendi questo logo blu", "rimuovi lo sfondo"). Stesso strumento, nuova modalità.
Assegna un modello per skill nell'app desktop o in config.yaml:
ricerca web → DeepSeek V4 Flash ($0.10/M token, il più economico) revisione codice → Claude Opus 4.8 ($5/$25/M, migliori benchmark di codifica) scrittura contenuti → Claude Sonnet 4.6 ($3/$15/M, prosa più forte + chiamata strumenti) codifica (valore) → GPT-5.5 ($2/$12/M, #1 Chatbot Arena, contesto 2M) ricerca con grounding → Gemini 2.5 Pro ($1.25/$10/M, Ricerca Google integrata) lavoro sub-agente in blocco → DeepSeek V4 ($0.30/$0.50/M, sconto cache 90%) giudice /goal → Gemini Flash (più economico, abbastanza veloce per valutazioni binarie fatto/non fatto) auto-ospitato (gratuito) → Qwen 3 8B tramite Ollama (8GB RAM, gestisce attività di routine)
Anche MiniMax M2.7 merita di essere testato. Nous Research e MiniMax stanno collaborando per ottimizzare le versioni future per Hermes. Uno dei modelli più utilizzati all'interno di Hermes a partire da metà 2026.
L'errore: Eseguire ogni skill sul modello più costoso. Una skill di ricerca web di routine che brucia token di Opus è denaro sprecato. Abbina il costo del modello alla complessità dell'attività.
Esempio: esegui una skill di ricerca competitiva su DeepSeek V4 Flash invece che su Opus 4.8. Qualità comparabile per la ricerca web. Da 30 a 50 volte più economico per chiamata. Oltre 30 esecuzioni al mese, i risparmi si accumulano rapidamente.
LIVELLO 5 — MCP (COLLEGA IL TUO MONDO)
Cosa sono: I server MCP (Model Context Protocol) collegano Hermes a strumenti esterni. Gmail, Calendario, Notion, Slack, ClickUp, GitHub, database, API.
Cosa sbloccano: L'agente lavora con i TUOI dati, non solo con il web aperto. Legge le tue email, controlla il tuo calendario, attinge dalla tua bacheca progetti e risponde a domande usando il contesto degli strumenti che già usi.
Configurazione:
App desktop / Dashboard: MCP → Catalogo → sfoglia e installa CLI: hermes mcp
L'errore: Collegare 15 MCP contemporaneamente. Ogni MCP aggiunge schemi di strumenti alla finestra di contesto. 15 MCP con 10 strumenti ciascuno = 150 definizioni di strumenti che il modello legge ogni turno. Installa ciò che usi. Disabilita ciò che non usi. La Ricerca Strumenti (abilitata automaticamente quando gli schemi consumano il 10%+ del contesto) aiuta a gestire questo, ma meno MCP è comunque meglio.
Esempio: "cosa è successo su Slack questa settimana mentre ero immerso nella codifica?" L'agente legge i tuoi canali Slack, filtra per menzioni e argomenti chiave, incrocia con i tuoi obiettivi in memoria. Fornisce un riepilogo di 10 righe. Nessun cambio di scheda. Nessuno scorrere 200 messaggi.
LIVELLO 6 — SUB-AGENTI + ESECUZIONE PARALLELA
Cosa sono: delegate_task genera sub-agenti isolati con la propria finestra di contesto, sessione terminale e set di strumenti.
Cosa sbloccano: Lavoro parallelo attraverso più agenti. Uno ricerca. Uno critica. Uno scrive codice. Il genitore orchestra. Ogni figlio può eseguire un modello diverso.
Configurazione:
L'agente utilizza delegate_task automaticamente quando l'attività trae vantaggio dall'isolamento. Puoi anche chiedere direttamente:
"avvia un sub-agente su DeepSeek per ricercare X mentre un altro su GPT-5.5 critica i risultati"
Configurazione:
imposta nell'app desktop, Dashboard o config.yaml:
delegation: max_concurrent_children: 3 # default max_spawn_depth: 2 # limita la ricorsione
Ruoli:→ foglia (default): esegue, non può ri-delegare → orchestratore: può generare i propri lavoratori
Modalità background (v0.17.0):delegate_task(background=true) invia il sub-agente e ritorna immediatamente. La tua sessione rimane attiva. Il risultato rientra come un nuovo turno quando termina.
L'errore: Usare sub-agenti per attività semplici. La delega ha un sovraccarico (configurazione del contesto, allocazione degli strumenti). Un'attività che l'agente principale può gestire in 3 turni non dovrebbe generare un sub-agente.
Esempio: "ricerca tre concorrenti in parallelo. un agente per concorrente. usa DeepSeek per la ricerca. il genitore su Sonnet sintetizza tutti e tre." Tre report in 10 minuti invece di 30. Ogni agente lavora in isolamento, quindi un'attività di ricerca lenta non blocca le altre.
LIVELLO 7 — OPERAZIONI ASINCRONE
Cosa sono: Tre funzionalità che permettono a Hermes di lavorare senza che tu scriva.
Cosa sbloccano: Il passaggio da "io chiedo, lui risponde" a "lui lavora, io rivedo".
/goal — obiettivi persistenti:Imposta un obiettivo. Un modello giudice valuta dopo ogni turno: fatto o non fatto? L'agente continua automaticamente finché l'obiettivo non è raggiunto, tu lo metti in pausa, o il budget di turni (default 20) si esaurisce.
/goal trova 100 cliniche a Toronto, crea una landing page per ciascuna, scrivi email personalizzate a ogni clinica.
/subgoal aggiunge criteri a metà esecuzione senza resettare il ciclo.
Cron job — attività pianificate:Il gateway ticchetta ogni 60 secondi. Avvia i job in scadenza in nuove sessioni isolate. Consegna i risultati a oltre 27 piattaforme: Telegram, Discord, Slack, WhatsApp, Signal, Matrix, iMessage, Microsoft Teams, Google Chat, LINE, email, SMS e altro.
v0.17.0 aggiunte: → WhatsApp Business Cloud API (adattatore ufficiale Meta, nessun ponte QR) → iMessage tramite Photon Spectrum (nessun relay Mac necessario) → Messaggi ricchi Telegram (Bot API 10.1, formattazione nativa) → Automation Blueprint: modelli cron con un clic nella Dashboard (briefing mattutino, revisione settimanale, digest di notizie, promemoria). Nessuna sintassi cron necessaria.
Tre livelli di costo: → modalità no_agent: lo script È il job, $0 per sempre → gate wakeAgent: lo script decide se è necessario un LLM, $0 finché qualcosa non cambia → context_from: collega gli output dei job in pipeline senza un framework
Rete di sicurezza — checkpoint:Abilita i checkpoint prima di eseguire operazioni autonome. L'agente cattura un'istantanea della directory di lavoro prima delle modifiche. /rollback ripristina lo stato se qualcosa va storto durante la notte.
imposta nell'app desktop, Dashboard o config.yaml:
checkpoints: enabled: true
L'errore: Scrivere prompt cron vaghi. Ogni esecuzione cron parte da zero. Nessuna memoria, nessuna cronologia chat. "Controlla quel problema sul server" non significa nulla. "SSH in 10.0.0.5, controlla lo stato di nginx, verifica che la porta 443 restituisca 200" funziona.
Esempio: 8:00. Telegram pinga. Non l'hai chiesto. Cron lo ha consegnato: "3 nuovi articoli arXiv nella tua nicchia. Il concorrente ha aggiornato la pagina dei prezzi. Il repository GitHub che segui ha integrato una modifica radicale. Azione: rivedi i prezzi del concorrente prima della tua chiamata delle 11."
https://x.com/IBuzovskyi/status/2066145326780518736
FASE 3 — AUTONOMIA (Livelli 8-15)
Hermes lavora senza di te. Il sistema si accumula nel tempo.
LIVELLO 8 — ARCHITETTURA MULTI-PROFILO
Cosa sono: Profili Hermes separati, ciascuno con il proprio SOUL.md, configurazione, memoria, skill, cron job e modello. Agenti completamente isolati su una macchina.
Cosa sbloccano: Lavoratori specializzati invece di un generalista sovraccarico. Un profilo Scout trova segnali. Un profilo Analista sintetizza la ricerca. Un profilo Programmatore pubblica funzionalità. Ognuno fa bene un lavoro con il modello giusto per quel lavoro.
Configurazione:
App desktop / Dashboard: Profili → Crea (procedura guidata in 5 passaggi: Identità → Modello → Skill → MCP → Revisione) CLI: hermes profile create [nome]
Ogni profilo diventa un comando a sé stante:
hermes -p scout chat hermes -p analyst chat
L'errore: Dare a ogni profilo lo stesso SOUL.md. L'intero punto è l'isolamento. Uno Scout che cerca di analizzare spreca token. Un Analista che cerca fonti duplica il lavoro dello Scout. Un lavoro per profilo.
Esempio: Scout ha trovato 12 fonti durante la notte. Analista le ha sintetizzate in 4 voci wiki entro le 10. Relatore ha fornito un riepilogo di 5 punti alle 8. Lo leggi mentre prendi il caffè. Nessuno di loro condivide la memoria. Ognuno ha fatto un lavoro con il modello giusto per quel lavoro.
https://x.com/IBuzovskyi/status/2067313826492547483
LIVELLO 9 — BASE DI CONOSCENZA AUTO-MIGLIORANTE
Cosa sono: La skill LLM Wiki, basata sullo schema di Andrej Karpathy. Una base di conoscenza auto-migliorante costruita come file markdown interconnessi. Inclusa in Hermes.
Cosa sbloccano: Conoscenza a lungo termine che si accumula oltre il limite della memoria. La memoria incorporata di Hermes gestisce il contesto conversazionale. Il wiki gestisce la conoscenza di dominio: articoli, trascrizioni, appunti di riunioni, risultati di ricerche. I riferimenti incrociati rimangono collegati. Le contraddizioni vengono segnalate automaticamente.
Configurazione:
imposta nell'app desktop, Dashboard o config.yaml:
WIKI_PATH=~/obsidian-wiki
Al primo avvio, la skill chiede il tuo dominio per creare SCHEMA.md con la tassonomia di tag corretta.
Connettiti a Obsidian per la vista a grafo: imposta OBSIDIAN_VAULT_PATH sulla stessa directory.
Alimentalo: "indicizza questo articolo nel mio wiki: [incolla URL o testo]"
L'errore: Non alimentare mai il wiki. Una base di conoscenza vuota non aggiunge nulla. Il valore deriva dall'accumulo. Mese 1: 50 voci. Mese 3: oltre 300 voci con riferimenti incrociati. L'agente diventa più acuto perché la base di conoscenza è diventata più acuta.
Esempio: chiedi "come gestisce l'onboarding il concorrente X?" Senza wiki: l'agente cerca sul web, ti dà informazioni generiche. Con 3 mesi di voci wiki: l'agente recupera le tue note di ricerca, le trascrizioni di riunioni in cui un cliente ha menzionato il concorrente X e un articolo che hai indicizzato il mese scorso. La risposta include un contesto che nessuna ricerca web potrebbe trovare.
LIVELLO 10 — ORCHESTRAZIONE KANBAN
Cosa sono: Una bacheca attività SQLite durevole condivisa tra tutti i profili. Gli stati fluiscono da triage → todo → ready → running → blocked → done → archived. Il dispatcher si attiva ogni 60 secondi.
Cosa sbloccano: Progetti multi-step complessi con catene di dipendenze. Ogni carta può eseguire il proprio ciclo /goal (goal_mode). Le carte con carte genitore non completate attendono automaticamente. Più profili possono prelevare le carte loro assegnate.
Configurazione:
/kanban create "Ricerca 100 cliniche" \ --assignee scout --goal --goal-max-turns 15
/kanban create "Crea landing page" \ --assignee coder --goal --goal-max-turns 20 \ --depends-on "Ricerca 100 cliniche"
CLI: hermes kanban o /kanban in chat.
Kanban vs cron vs delegate_task:→ Kanban: coda attività durevole, persiste tra i riavvii, multi-profilo → Cron: pianificazione basata sul tempo, attività ricorrenti → delegate_task: esecuzione parallela una tantum all'interno di una sessione
L'errore: Usare Kanban per semplici pipeline lineari. Tre profili in linea retta (Scout → Analista → Relatore) funzionano bene con il coordinamento basato su file. Kanban aggiunge valore quando hai alberi di dipendenze, rami paralleli o oltre 10 attività da tracciare.
Esempio: Analisi competitiva trimestrale come progetto Kanban. 12 carte: 3 concorrenti × 4 dimensioni (prezzi, funzionalità, posizionamento, segnali di assunzione). La carta prezzi dipende dalla carta di web scraping. La carta assunzioni dipende dalla carta di ricerca su LinkedIn. Gli agenti raccolgono il lavoro man mano che le dipendenze vengono risolte. Rivedi il report finale sintetizzato.
LIVELLO 11 — MODALITÀ VOCALE
Cosa sono: Riconoscimento vocale e sintesi vocale su tutte le piattaforme di messaggistica. Sei provider STT, cinque provider TTS.
Cosa sbloccano: Parla con Hermes tramite messaggi vocali su Telegram, Discord, WhatsApp. L'agente trascrive, elabora e può rispondere con voce sintetizzata. Conversazioni vocali complete senza scrivere.
Provider STT:→ faster-whisper (gratuito, funziona sul dispositivo) → wrapper comando locale → Groq (cloud veloce) → OpenAI Whisper API → Mistral → xAI
Provider TTS:→ Edge TTS (gratuito, predefinito) → ElevenLabs (migliore qualità, a pagamento) → OpenAI TTS → MiniMax → NeuTTS (gratuito)
L'errore: Usare costosi provider STT cloud per messaggi vocali di routine. faster-whisper locale gestisce bene la maggior parte delle lingue e non costa nulla. Riserva i provider STT a pagamento per audio complessi o ambienti rumorosi.
Esempio: Stai guidando verso una riunione. Messaggio vocale su Telegram: "c'è qualcosa dalla ricerca di ieri che dovrei sapere prima della mia chiamata delle 11?" L'agente risponde con un riepilogo audio di 30 secondi. Ascolti invece di leggere. Mani sul volante.
LIVELLO 12 — AUTOMAZIONE DEL BROWSER
Cosa sono: Hermes può controllare un browser per navigare siti web, compilare moduli, estrarre dati e interagire con applicazioni web.
Cosa sbloccano: Attività che richiedono una sessione browser: scraping di pagine dinamiche, compilazione di moduli web, interazione con strumenti che non hanno API. L'agente vede la pagina e agisce su di essa.
Configurazione:
Incluso nel Gateway degli Strumenti per gli abbonati a Nous Portal:
hermes setup --portal
Oppure configura l'automazione del browser separatamente tramite la dashboard.
L'errore: Usare l'automazione del browser per attività che hanno un'API. L'automazione del browser è più lenta, più fragile e più costosa di una chiamata API diretta. Usala solo quando non esiste un'API.
Esempio: Il concorrente non ha un'API pubblica. L'agente apre la loro pagina dei prezzi tramite browser, estrae piani e prezzi attuali, li confronta con l'istantanea del mese scorso archiviata nel tuo wiki. Rilevata una modifica: hanno eliminato il livello gratuito. Segnalato nel tuo briefing mattutino.
LIVELLO 13 — SERVER API
Cosa sono: Hermes esposto come endpoint HTTP compatibile con OpenAI. Agente completo con strumenti, memoria e skill accessibili tramite formato API standard.
Cosa sbloccano: Qualsiasi frontend che parli il formato OpenAI si connette a Hermes come backend: Open WebUI, LobeChat, LibreChat, ChatBox, applicazioni personalizzate, integrazioni Excel. L'agente diventa un'API su cui costruire.
Configurazione:
imposta nell'app desktop, Dashboard o .env:
API_SERVER_ENABLED=true API_SERVER_KEY=tua_chiave_segreta
Avvia il gateway: App desktop / Dashboard: Gateway → Avvia CLI: hermes gateway
Endpoint: http://127.0.0.1:8642/v1/chat/completions
Configurazione multi-utente: Crea un profilo per utente su porte diverse. Ogni utente ha configurazione, memoria e skill isolate.
L'errore: Esporre il server API a internet pubblico senza autenticazione. Il server si lega a 127.0.0.1 per impostazione predefinita. Accedi da remoto tramite tunnel SSH, non tramite esposizione pubblica. v0.17.0 ha aggiunto un gate OAuth su ogni endpoint che richiede token e autenticazione websocket per la dashboard.
Esempio: La tua ricerca competitiva è eseguita come endpoint API. Una dashboard personalizzata interroga Hermes per le ultime informazioni. Il tuo team vede i dati competitivi su una pagina interna live. Nessuno apre Telegram. I dati si servono da soli.
LIVELLO 14 — INTEGRAZIONE IDE (ACP)
Cosa sono: Hermes viene eseguito come server ACP (Agent Communication Protocol) all'interno di VS Code, Zed e editor JetBrains.
Cosa sbloccano: Chat, attività degli strumenti, diff dei file e comandi del terminale vengono visualizzati all'interno dell'editor. L'agente lavora nella directory del tuo progetto con il contesto del tuo editor. Stesso core dell'agente, stessi strumenti, stessa memoria della CLI e del gateway.
Configurazione:
hermes acp start
In VS Code: installa l'estensione ACP, puntala a Hermes.
Cosa include ACP:→ Strumenti file: read_file, write_file, patch, search_files → Esecuzione terminale → Interfaccia chat nell'editor → Richieste di approvazione per comandi pericolosi
Cosa esclude ACP (per progettazione):→ Consegna messaggi → Gestione cron job → Funzionalità specifiche del gateway
L'errore: Pensare che ACP sostituisca il gateway. ACP è per sessioni di codifica all'interno di un editor. Il gateway gestisce la messaggistica, il cron e la consegna multi-piattaforma. Entrambi eseguono lo stesso core dell'agente sottostante.
Esempio: Stai codificando una pagina prezzi. Dentro VS Code chiedi a Hermes: "come struttura i livelli il concorrente X?" L'agente controlla il tuo wiki Obsidian, trova le tue note di ricerca, dà la risposta. Modifichi il tuo design senza aprire un browser o Telegram.
LIVELLO 15 — DISTRIBUZIONI DI PROFILO
Cosa sono: Impacchetta l'intera configurazione del tuo agente come repository git. Chiunque installa il tuo agente con un comando.
Cosa sbloccano: Il tuo agente diventa un prodotto. Vendilo. Condividilo con il tuo team. Distribuiscilo ai clienti. Tutto viene trasferito tranne le chiavi API e i ricordi personali.
v0.17.0 ha anche introdotto il RAFT Agent Network: collega Hermes a raft.build come agente esterno. Ponte canale wake con privacy per contratto (i payload wake trasportano solo metadati, mai corpi dei messaggi). Il tuo agente può collaborare con agenti su altre macchine.
Cosa contiene una distribuzione:
distribution.yaml # manifesto SOUL.md # identità config.yaml # impostazioni modello e provider skills/ # skill personalizzate cron/ # job pianificati mcp.json # strumenti connessi
Installa la distribuzione di qualcun altro:
hermes profile install
L'errore: Includere chiavi API o dati personali nella distribuzione. Le credenziali rimangono per macchina. La distribuzione trasporta personalità, skill e flussi di lavoro. L'utente porta le proprie chiavi.
Esempio: Hai costruito un reparto di ricerca con Scout, Analista, Relatore. Un nuovo membro del team si unisce. Esegue: hermes profile install github.com/tu/ricerca-dept. Ha i tuoi tre profili, la struttura wiki, i cron job e i template SOUL.md. Aggiunge le proprie chiavi API e il bot Telegram. Funzionante in 10 minuti.
UN FLUSSO DI LAVORO, 15 EVOLUZIONI
Ricerca competitiva. Stessa attività. Guarda come cambia a ogni livello.
Livello 1: scrivi "cosa c'è di nuovo negli agenti AI questa settimana?" e leggi un muro di testo.
Livello 2: l'agente conosce già la tua nicchia e i tuoi concorrenti da SOUL.md. Stessa domanda, risposta filtrata per il TUO mercato.
Livello 3: /background ricerca concorrenti mentre abbozzi una proposta. I risultati appaiono senza interrompere il tuo flusso.
Livello 4: la skill di ricerca viene eseguita su DeepSeek V4 Flash. La skill di analisi viene eseguita su Sonnet. Smetti di pagare i prezzi di Opus per le ricerche web.
Livello 5: l'agente controlla Slack, email e ClickUp PRIMA di rispondere. "Il concorrente ha lanciato ieri. Il tuo team ne ha discusso in #product."
Livello 6: tre sotto-agenti fanno ricerche su tre competitor in parallelo. Ciascuno su DeepSeek. L'agente principale su Sonnet sintetizza. 10 minuti invece di 30.
Livello 7: hai smesso di chiedere. Un cron job viene eseguito alle 7:00. Gate wakeAgent: se nulla è cambiato = $0. Se un competitor ha pubblicato un aggiornamento = l'agente si sveglia, fa ricerche e invia un brief su Telegram. Lo leggi mentre bevi il caffè.
Livello 8: il profilo Scout rileva segnali ogni 3 ore. L'Analyst sintetizza alle 10:00. Il Briefer consegna alle 8:00. Tre profili. Una pipeline.
Livello 9: i risultati vanno nel wiki Obsidian. Al terzo mese: 300+ voci. L'agente fa emergere pattern che non avevi richiesto, perché il wiki ha trovato connessioni tra fonti diverse.
Livello 10: l'analisi trimestrale viene eseguita come progetto Kanban. 12 card con catene di dipendenze. Gli agenti prendono in carico le attività quando le dipendenze si risolvono. Tu revisioni il report finale.
Livello 11: stai andando a una riunione. Messaggio vocale: "C'è qualcosa dalla ricerca di ieri sera?" L'agente risponde con audio. Ascolti invece di leggere.
Livello 12: il competitor non ha API. L'agente apre la loro pagina dei prezzi tramite browser, la confronta con lo snapshot del mese scorso. Variazione rilevata. Segnalata nel tuo brief.
Livello 13: la ricerca viene eseguita come endpoint API. Una dashboard personalizzata la interroga. Il tuo team vede le informazioni competitive su una pagina live.
Livello 14: stai scrivendo codice di una funzionalità. All'interno di VS Code chiedi "Come gestisce questa cosa il competitor X?" L'agente risponde dal tuo wiki senza uscire dall'editor.
Livello 15: la tua configurazione di ricerca è un repository Git. Un nuovo membro del team esegue un comando. Scout, Analyst, Briefer, struttura wiki, cron job. Tutto installato in 10 minuti.
TOKEN ECONOMICS: COME GESTIRE TUTTI I 15 LIVELLI SENZA BRUCIARE SOLDI
Ogni livello oltre il 3 costa token. Ecco i controlli che mantengono prevedibile la spesa.
MODELLO GIUSTO PER OGNI COMPITO (Livello 4+)
Non tutti i compiti richiedono il tuo modello più costoso. Ricerca web = DeepSeek V4 Flash ($0,10/M). Sintesi = Sonnet ($3/$15/M). Revisione finale = Opus 4.8 ($5/$25/M). Assegna modelli per skill, per profilo, per cron job. Vedi Livello 4 per il riferimento completo modello-per-compito.
GATE WAKEAGENT (Livello 7+)
Lo script viene eseguito a ogni tick gratuitamente. Controlla se qualcosa è cambiato. Nulla cambiato = l'agente non si sveglia mai = $0. L'agente spende token solo quando c'è lavoro da fare.
MODALITÀ NO_AGENT (Livello 7+)
Quando lo script È il lavoro. Controlli di uptime, avvisi disco, osservatori file. L'output va direttamente su Telegram. Zero chiamate LLM. Zero token. Mai.
SCRIPT PRE-RUN (Livello 7+)
Lo script raccoglie i dati gratuitamente. L'output viene iniettato nel prompt come contesto. Il modello riassume ciò che lo script ha recuperato, invece di bruciare chiamate a strumenti per trovare i dati da solo.
SET DI STRUMENTI SNELI (Livello 5+)
Imposta --skills web,file per ogni cron job. Meno schemi di strumenti nel contesto = prompt più piccolo = più economico. Un job di riepilogo notizie non ha bisogno di strumenti browser, delega o Kanban.
RICERCA STRUMENTI (Livello 5+)
Abilitata automaticamente quando gli schemi degli strumenti occupano il 10%+ del contesto. Sostituisce le definizioni complete degli strumenti con 3 strumenti bridge. ~300 token invece di migliaia. L'agente scopre gli strumenti su richiesta invece di caricarli tutti insieme.
SOGLIA DI COMPRESSIONE (Livello 7+)
Imposta nell'app Desktop, nella Dashboard o in config.yaml:
compression: soglia: 0.40 # predefinito 0.50
Attiva la compressione del contesto prima. Mantiene le esecuzioni /goal lunghe e le sessioni cron nel budget di token anche con 20+ turni.
CURATOR — GRATUITO PER IMPOSTAZIONE PREDEFINITA (v0.17.0)
La potatura deterministica delle skill viene ancora eseguita gratuitamente. Il consolidamento basato su LLM è ora opt-in:
Imposta nell'app Desktop, nella Dashboard o in config.yaml:
curator: consolida: true # opt-in, predefinito false
La cura di routine in background costa zero token. Abilita il consolidamento solo quando la tua libreria di skill necessita di una pulizia profonda.
DENSIFICAZIONE SENZA PERDITE (PR #47866 di teknium)
I risultati di search_files vengono compressi prima di arrivare al modello. Stesse informazioni. Meno token. Unito nell'ultima Hermes. Esegui hermes update.
MODELLI AUSILIARI PER JUDGE (Livello 7+)
Il giudice /goal viene eseguito DOPO OGNI turno. Instradalo verso un modello veloce ed economico.
Imposta nell'app Desktop, nella Dashboard o in config.yaml:
ausiliario: giudice_goal: provider: openrouter model: google/gemini-3-flash-preview
20 chiamate del giudice su Gemini Flash vs 20 su Opus = risparmio significativo.
LIMITI DI BUDGET (tutti i livelli)
Imposta nell'app Desktop, nella Dashboard o in config.yaml:
budget: daily_max_usd: 10 session_max_usd: 2 monthly_max_usd: 200
Limiti rigidi. L'agente si ferma quando raggiunge il limite. Impostali prima di abilitare qualsiasi cron job o esecuzione /goal.
MONITORA LA SPESA
App Desktop / Dashboard: scheda Utilizzo mostra la ripartizione per profilo. CLI: /usage in qualsiasi sessione per le statistiche della sessione.
Aggiungi "termina con la spesa token di questa settimana" ai prompt di Briefer per il monitoraggio settimanale dei costi su Telegram.
Il modello comune a tutti questi accorgimenti: spostare il lavoro dal modello costoso verso codice gratuito, modelli economici e contesto compresso. L'agente ragiona. Tutto il resto viene eseguito gratuitamente.
INIZIA DA ZERO
Se tieni al controllo dei token fin dal primo giorno, installa con la modalità Blank Slate (hermes setup → Blank Slate). Tutto disabilitato tranne provider, modello, strumenti file, terminal. Aggiungi le funzionalità una per una quando ti servono. Non viene caricato nulla che tu non abbia esplicitamente abilitato. Questo è il punto di partenza più economico e controllato.
DOVE SI FERMANO LA MAGGOR PARTE DELLE PERSONE
Livelli 1-2. Installano Hermes, scrivono un SOUL.md e lo usano come chatbot intelligente. L'agente risparmia loro 30 minuti al giorno.
Il salto dal livello 3 al livello 7 è dove il risparmio di tempo giornaliero passa da minuti a ore. /background, skill con i modelli giusti, cron job con gate wakeAgent. Questi si accumulano.
Il salto dal livello 7 al livello 10+ è dove l'agente smette di essere uno strumento e diventa un sistema. Architettura multi-profilo, conoscenza auto-migliorante, orchestrazione Kanban. Rivedi lavoro che è avvenuto senza di te.
COME IDENTIFICARE IL TUO LIVELLO ATTUALE
Non devi raggiungere il livello 15. La maggior parte dei fondatori singoli opera bene ai livelli 7-10. I livelli superiori risolvono problemi specifici: voce per flussi di lavoro mobili, browser per strumenti senza API, server API per integrazioni personalizzate, IDE per la programmazione, distribuzioni per i team.
Scegli il livello che corrisponde al tuo collo di bottiglia. Imposta quello. Passa al successivo quando non è più sufficiente.
ARTICOLI CORRELATI
- HERMES AGENT SOUL.MD: PERCHÉ 50 RIGHE CONTANO PIÙ DEL TUO MODELLO — Approfondimento Livello 2
- HERMES AGENT SI COSTRUISCE DA SOLO MENTRE DORMI — Approfondimento Livello 7
- HERMES AGENT + NOTEBOOKLM + OBSIDIAN: REPARTO RICERCA A 3 AGENTI — Approfondimento Livello 8-9
FONTI UFFICIALI
- Panoramica delle funzionalità
- SOUL.md
- Skill
- Cron
- Delega
- Obiettivi
- Profili
- Kanban
- Voce e TTS
- Automazione browser
- Server API
- ACP/IDE
- Distribuzioni profili
- Panoramica integrazioni
Tutti i dettagli tecnici verificati rispetto alla documentazione di Hermes Agent v0.17.0.
