Agenti
Un agente è un assistente salvato, con istruzioni, accessi e integrazioni suoi. Lo scegli nella chat dal selettore Agente: da lì la chat lavora come hai deciso tu, con le cartelle, la posta e i permessi di quell'agente.
GalleriaCreare e modificareLavorare con un agenteStrumentiConfermeRegistroCartelle concesseIntegrazioni

Galleria
Quattro agenti pronti. Crea chiede la cartella su cui lavoreranno e l'agente nasce già pronto.
| Agente | Cosa fa |
|---|---|
| Assistente file | Trova, legge e riassume i documenti di una cartella e risponde a domande sul loro contenuto. |
| Riordino documenti | Propone un ordine per una cartella disordinata e, se sei d'accordo, crea le cartelle e sposta i file. Non cancella niente. |
| Assistente di codice | Legge e modifica il codice di un progetto e può eseguire build e test, sempre chiedendoti conferma. |
| Assistente posta | Cerca, legge e riassume le tue mail e prepara le risposte come bozze. Invia solo se glielo chiedi, e ogni volta ti mostra il messaggio prima. Alla creazione si apre l'editor per collegare l'account. |
Crea un agente da zero → apre l'editor vuoto.
Creare e modificare un agente

| Campo | A cosa serve |
|---|---|
| Nome, Descrizione | Come lo riconosci nell'elenco. |
| Istruzioni | Cosa deve fare e come. Poche regole chiare funzionano meglio di un testo lungo, soprattutto con i modelli piccoli. |
| Cartelle concesse | Le sole cartelle che l'agente vede. Facoltative. La prima è quella da cui parte. |
| Può eseguire comandi | Da attivare solo per chi ne ha bisogno, come l'assistente di codice. Ogni comando ti viene mostrato prima. |
| Permessi | Le azioni che hai consentito per sempre a questo agente, ognuna con Revoca. |
| Integrazioni | Le integrazioni che l'agente può usare, da spuntare: vedi Integrazioni. |
| Posta | Gli account di posta che l'agente può usare: vedi Posta. |
- Salva applica le modifiche; Annulla le scarta.
- Elimina agente chiede un secondo clic di conferma e cancella anche le sue conversazioni (il registro delle azioni resta).
- Ogni agente è un file JSON leggibile: Apri la cartella degli agenti li mostra, per farne una copia o condividerli.
Lavorare con un agente

- Usa in chat, accanto a ogni agente, apre una chat nuova con quell'agente. In chat lo scegli anche dal selettore Agente nella testata: Generale è la chat con i suoi accessi, gli altri sono i tuoi agenti.
- Con un agente scelto, il pannello Accessi mostra e modifica i suoi accessi, e il registro a destra è il suo. I ruoli automatici funzionano come sempre: la chat attiva file o posta quando servono, con gli accessi dell'agente.
- Cambiare agente in una chat già avviata apre una chat nuova: compare una riga che lo chiede (Nuova chat con … o Annulla). Così quello che un agente ha letto con i suoi accessi non passa a un altro.
- Le conversazioni con un agente stanno nella cronologia della chat, con il suo nome sotto il titolo. Riaprendone una torna anche l'agente.
- Descrivi il compito a parole tue: la chat mostra i passi che fa (Guarda la cartella, Legge, Sposta…) e per le azioni delicate si ferma sulla scheda di conferma: Consenti, Consenti sempre per quel tipo di azione, o Non consentire. Dopo un no si ferma e aspetta che tu dica cosa cambiare.
Cosa sa fare un agente
| Strumento | Cosa fa |
|---|---|
| Guarda la cartella | Elenca file e cartelle (fino a 500 voci per volta). |
| Legge | Apre file di testo, PDF (pagina per pagina) e documenti Word (.docx). I file lunghi si leggono a pezzi, circa un quarto del contesto del modello alla volta, riprendendo da dove la lettura si era fermata: un PDF lungo non riempie più tutto il contesto. Un PDF fatto solo di immagini viene segnalato come senza testo. Legge anche Excel (.xlsx e i vecchi .xls, un foglio alla volta con le righe numerate), i vecchi documenti Word (.doc) e PowerPoint (.pptx e i vecchi .ppt, una diapositiva alla volta con titolo, tabelle e note). |
| Cerca file | Trova file e cartelle per nome (per esempio *.pdf o fattura*) anche nelle sottocartelle, e se vuoi solo quelli che contengono un testo, PDF e Word compresi. |
| Scrive | Crea un file di testo nuovo o ne sostituisce l'intero contenuto. |
| Modifica | Cambia solo un pezzo di un file di testo, lasciando il resto com'è (fine riga e codifica compresi). |
| Crea un documento | Crea un documento Word (.docx) con titoli, elenchi, tabelle, colori, grassetto, intestazione e piè di pagina con il numero di pagina, un file Excel (.xlsx) con fogli, formule e formattazione (colori, formati numerici, larghezze, celle unite, righe bloccate), oppure una presentazione PowerPoint (.pptx) con diapositiva di titolo, elenchi, tabelle, colori e note del relatore. Crea anche PDF, con la stessa sintassi e la stessa impaginazione del Word. |
| Modifica un documento | Fa una copia di un documento Word, di un Excel o di una presentazione PowerPoint cambiando solo i contenuti (testi da sostituire, celle di Excel o delle tabelle, titoli e note delle diapositive, paragrafi o diapositive aggiunti in fondo, diapositive tolte): formattazione, colori, formule, immagini e impaginazione restano come nell'originale. I vecchi .doc, .xls e .ppt diventano .docx, .xlsx e .pptx. La copia di un Word si può salvare anche in PDF; un PDF invece non si modifica mantenendone l'impaginazione: si legge e se ne crea uno nuovo. |
| Crea una cartella | Anche con le cartelle intermedie che mancano. |
| Sposta | Sposta o rinomina un file o una cartella. |
| Elimina | Elimina un file o una cartella vuota. Il file non sparisce: viene messo da parte e si può ripristinare. |
| Esegue un comando | Solo se l'agente può eseguire comandi. Riga di comando del sistema, al massimo 2 minuti, senza interazione: comandi che aspettano input si fermano da soli. |
| Strumenti della posta | Se l'agente ha account collegati: cercare, leggere, salvare allegati, preparare bozze, inviare. Vedi Posta. |
| Strumenti delle integrazioni | Quelli delle integrazioni spuntate per l'agente, quando la richiesta le riguarda. Vedi Integrazioni. |
Cosa chiede conferma
| Azione | Conferma | Si può annullare |
|---|---|---|
| Guardare, leggere, cercare | No | — |
| Leggere un allegato fuori dalle cartelle concesse | Sì: solo quel file o tutta la cartella | — |
| Creare un file o una cartella | No | Sì |
| Sostituire o modificare un file | Sì | Sì (si ripristina la versione di prima) |
| Spostare o rinominare | Sì | Sì |
| Eliminare | Sì | Sì |
| Eseguire un comando | Sì, con il comando in chiaro | No |
| Usare lo strumento di un'integrazione | Sì, con i dati che gli verranno inviati | No |
| Salvare una bozza di mail | No | No (la elimini dal tuo programma di posta) |
| Inviare una mail | Sempre, con il messaggio completo da rivedere e correggere | No |
Consenti sempre vale per un tipo di azione e per quell'agente (per gli strumenti delle integrazioni, per il singolo strumento); lo revochi dall'editor. L'invio di una mail non lo ammette: chiede ogni volta.
Registro e annullamento

Il pannello a destra elenca tutto quello che l'agente ha letto, scritto o eseguito, compresi i tentativi negati o non riusciti. Annulla rimette le cose com'erano: cancella un file creato, ripristina il contenuto precedente, riporta un file spostato o eliminato al suo posto.
Se il file è stato cambiato di nuovo dopo l'azione (da te o da un altro programma), l'annullamento si ferma e te lo dice: meglio non annullare che cancellare un lavoro successivo.
Cartelle concesse
Ogni percorso che il modello chiede passa da un controllo: deve restare dentro una cartella concessa. Il resto del disco
per l'agente non esiste. Il controllo regge anche ai trucchi: percorsi con .., collegamenti e junction che
portano fuori, flussi di dati nascosti e percorsi speciali di Windows vengono rifiutati, e il tentativo finisce nel registro.
Una cartella concessa non si può spostare né eliminare dall'agente.
Integrazioni
I server MCP ora si chiamano integrazioni e non si aggiungono più dentro l'agente. Li configuri una volta nella pagina Integrazioni, poi nell'editor dell'agente, sezione Integrazioni, spunti quelli che l'agente può usare. I server che avevi aggiunto a un agente sono diventati integrazioni da soli, già spuntate in quell'agente.
I modelli più piccoli usano gli strumenti in modo meno affidabile. Per gli agenti conviene un modello segnato Adatto agli agenti nella pagina Modelli.
HotMoE è un progetto di Virsion. Questa guida descrive l'app com'è oggi: quello che è ancora in arrivo è segnato come tale.