Usare l'app

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

La pagina Agenti: i tuoi agenti in alto, la galleria sotto.
La pagina Agenti: i tuoi agenti in alto, la galleria sotto.

Quattro agenti pronti. Crea chiede la cartella su cui lavoreranno e l'agente nasce già pronto.

AgenteCosa fa
Assistente fileTrova, legge e riassume i documenti di una cartella e risponde a domande sul loro contenuto.
Riordino documentiPropone un ordine per una cartella disordinata e, se sei d'accordo, crea le cartelle e sposta i file. Non cancella niente.
Assistente di codiceLegge e modifica il codice di un progetto e può eseguire build e test, sempre chiedendoti conferma.
Assistente postaCerca, 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

L'editor di un agente: nome, descrizione, istruzioni, cartelle concesse e permessi.
L'editor di un agente: nome, descrizione, istruzioni, cartelle concesse e permessi.
CampoA cosa serve
Nome, DescrizioneCome lo riconosci nell'elenco.
IstruzioniCosa deve fare e come. Poche regole chiare funzionano meglio di un testo lungo, soprattutto con i modelli piccoli.
Cartelle concesseLe sole cartelle che l'agente vede. Facoltative. La prima è quella da cui parte.
Può eseguire comandiDa attivare solo per chi ne ha bisogno, come l'assistente di codice. Ogni comando ti viene mostrato prima.
PermessiLe azioni che hai consentito per sempre a questo agente, ognuna con Revoca.
IntegrazioniLe integrazioni che l'agente può usare, da spuntare: vedi Integrazioni.
PostaGli 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

L'agente di riordino ha creato le cartelle e chiede il permesso di spostare la prima foto.
L'agente di riordino ha creato le cartelle e chiede il permesso di spostare la prima foto.
  • 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

StrumentoCosa fa
Guarda la cartellaElenca file e cartelle (fino a 500 voci per volta).
LeggeApre 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 fileTrova 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.
ScriveCrea un file di testo nuovo o ne sostituisce l'intero contenuto.
ModificaCambia solo un pezzo di un file di testo, lasciando il resto com'è (fine riga e codifica compresi).
Crea un documentoCrea 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 documentoFa 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 cartellaAnche con le cartelle intermedie che mancano.
SpostaSposta o rinomina un file o una cartella.
EliminaElimina un file o una cartella vuota. Il file non sparisce: viene messo da parte e si può ripristinare.
Esegue un comandoSolo 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 postaSe l'agente ha account collegati: cercare, leggere, salvare allegati, preparare bozze, inviare. Vedi Posta.
Strumenti delle integrazioniQuelli delle integrazioni spuntate per l'agente, quando la richiesta le riguarda. Vedi Integrazioni.

Cosa chiede conferma

AzioneConfermaSi può annullare
Guardare, leggere, cercareNo—
Leggere un allegato fuori dalle cartelle concesseSì: solo quel file o tutta la cartella—
Creare un file o una cartellaNoSì
Sostituire o modificare un fileSìSì (si ripristina la versione di prima)
Spostare o rinominareSìSì
EliminareSìSì
Eseguire un comandoSì, con il comando in chiaroNo
Usare lo strumento di un'integrazioneSì, con i dati che gli verranno inviatiNo
Salvare una bozza di mailNoNo (la elimini dal tuo programma di posta)
Inviare una mailSempre, con il messaggio completo da rivedere e correggereNo

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 registro dell'agente: cartelle create e foto spostate, ognuna con Annulla.
Il registro dell'agente: cartelle create e foto spostate, ognuna con Annulla.

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.

Annullamento prudente

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.

Modelli e agenti

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.