Vai al contenuto
Leo
Guida · Leo Sistema

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.