Comporre un agente con Leo Sistema
Come si fa e dove trovi le cose nel laboratorio di agenti. Dai sensi all'azione: componi un agente, scegli se decide con le regole o con l'IA, collegalo ai dati, provalo e attivalo.
Un agente ha tre parti
Un agente è un programma che resta vivo e lavora da solo. Lo componi scegliendo tre cose:
- Sensi — il «quando»: cosa osserva e cosa lo sveglia (un orario, un file che compare, un processo che parte, un valore che cambia).
- Testa — come decide: con le regole che scrivi tu, oppure con un'IA locale che ragiona.
- Mani — cosa fa sul computer: file, finestre, processi, notifiche, comandi.
Leo Sistema comanda il sistema operativo, non l'hardware di una scheda elettronica: per quello c'è Leo Robotica.
Comporre un agente
L'agente è un normale programma Leo. I sensi sono il ciclo che sorveglia e resta in ascolto; la testa è il se… allora; le mani sono le azioni:
# SENSI — resta in ascolto di una cartella
sorveglia "~/Download" fai arrivato
# TESTA — una regola decide
se estensione_file(arrivato) == ".pdf" allora
# MANI — agisce sul computer
sposta_file(arrivato, "~/Documenti")
mostra_notifica("Ordinato", nome_file(arrivato))
fine
fine
Trovi i sensi, i verbi delle mani e il registro nelle tre fasce dell'editor: sorgente a sinistra, agente al centro, registro a destra.
La testa: regole o IA
La testa decide in due modi, a tua scelta, e puoi mescolarli. Con le regole imposti tu la logica. Con un'IA locale l'agente ragiona: il modello gira sul tuo computer, gratis e offline.
variabile ia = modello_locale("llama3")
sorveglia "~/Download" fai arrivato
# la testa IA sceglie la cartella giusta
variabile dove = ia.cartella_per(arrivato)
sposta_file(arrivato, dove)
fine
Se un agente usa l'IA, è il setup a installare le dipendenze — una o più, ciò che serve: il runtime del modello (Ollama) e almeno un modello di partenza. Tu non fai nulla a mano; il modello si scarica al primo avvio, poi lavora offline, e puoi aggiungerne altri.
- L'IA locale è realistica su Windows; su Android si usa un modello remoto o piccolissimo.
- Le regole girano ovunque, senza installare niente.
Interfacciarsi con Leo Dati
Sistema è l'attuatore: usa i dati che le altre edizioni espongono. Dichiari nel progetto.toml la tabella di Leo Dati che ti serve, e il nome è pronto nel codice dell'agente:
[[usa]] progetto = "magazzino" interfaccia = "prodotti" come = "catalogo"
per ogni p in catalogo.righe() fai
se p["scorta"] == 0 allora
mostra_notifica("Esaurito", p["nome"])
fine
fine
Allo stesso modo un agente può esporre i propri trigger e le proprie azioni, così un'altra edizione li attiva:
[[espone]] tipo = "servizio/azione" nome = "aggiorna_scorte" da = "agente.leo"
Provare e attivare
Prima di toccare il disco, usa la prova a vuoto: l'agente simula tutto e stampa nel registro l'elenco di ciò che farebbe, con il conto dei file coinvolti. Nessuna scrittura finché non dai l'ok.
Con Attiva l'agente resta in ascolto e lavora da solo, mostrando un registro dal vivo (fatto, saltato, errore). Lo fermi e lo riparti quando vuoi, lo mandi in sottofondo o all'avvio del computer, e ne tieni attivi più d'uno insieme.
I mattoni
Quando scrivi codice, il menu Modifica → Altro → Inserisci mattone offre blocchi pronti con le funzioni di questa edizione:
- File e cartelle: elencare, cercare, leggere, copiare e spostare file, la cartella dei download.
- Il computer: nome, informazioni, stato della batteria.
- Avvisi e appunti: mostrare una notifica, scrivere negli appunti.
- Intelligenza artificiale: chiedere all'IA, una risposta sì o no.
- Ordine e pulizia: trovare i doppioni, organizzare una cartella.
Il codice entra al cursore con i punti da completare evidenziati: con Tab passi da uno all'altro.
Dove trovo le cose
- Sorgente (file, processi, computer): fascia a sinistra.
- Sensi, testa e mani dell'agente: fascia centrale, a passi.
- Regole o IA (e la scelta del modello): nel passo della testa.
- Codice Leo generato: con «Mostra codice», sotto l'agente.
- Prova a vuoto e Attiva / Ferma: nella barra in alto.
- Registro dal vivo: fascia a destra.
- Mattoni: Modifica → Altro → Inserisci mattone.