🕸️ Il laboratorio degli agenti
Un’architettura agentica nel browser: un grafo di ruoli che attraversa un ciclo di passi, controllato da regole
Descrizione
Un agente non è un modello che risponde in una volta sola. È un ciclo: pianifica, cerca, usa uno strumento, controlla la bozza e solo alla fine risponde. Questa finestra simula quel ciclo come un grafo: ogni nodo è un ruolo, ogni passo è un pacchetto che attraversa l’arco, e il Critico può rimandare la bozza al Pianificatore.
Simulazione didattica. Ogni ruolo è una regola deterministica scritta a mano. Non c’è nessun modello linguistico: la finestra mostra la struttura del ciclo agentico, non la capacità di ragionare di un modello.
Cosa puoi fare
- Scrivere una domanda o sceglierne una tra gli esempi, poi seguire il percorso con Esegui passo o Esegui tutto.
- Leggere il pannello del nodo attivo: input, output, stato interno e numero di passi.
- Usare gli strumenti deterministici: una calcolatrice senza
evale la ricerca nel catalogo delle mini app del desktop. - Vedere il ritorno dal Critico: nella Dimostrazione il primo giudizio rimanda la bozza, e il ciclo ripete la ricerca con termini più ampi.
Il ciclo agentico
Pianificatore → Ricercatore → Strumenti → Critico → Risposta
↑ │
└──── revisione (una) ────┘
Il Pianificatore rileva se la domanda contiene un calcolo. Il Ricercatore recupera le voci del catalogo con un punteggio TF-IDF semplice. Gli Strumenti eseguono la calcolatrice e la ricerca esatta per nome, e compongono la bozza con frasi fisse. Il Critico giudica la bozza: ok oppure rivedi, con un motivo. La Risposta consegna il risultato, o lo marca come provvisorio se non c’è più un giro di revisione.
Il ciclo ha un limite di 8 passi non terminali. Un giro di revisione completo ci entra; il limite impedisce cicli infiniti.
Verifica
I numeri seguenti vengono dai test eseguiti sul codice pubblicato.
| Verifica | Risultato |
|---|---|
| Ricercatore: 5 domande di prova, app attesa tra le prime 3 voci | 5 su 5 |
| Ricercatore: domanda fuori tema | 0 risultati |
| Calcolatrice: 10 espressioni con risultato noto | errore massimo 0 (soglia 10⁻⁹) |
| Calcolatrice: espressioni non valide o malevole rifiutate | 14 su 14, nessun codice eseguito |
| Grafo: percorso normale, ritorno dal Critico, limite di passi | verificati in Node: terminazione entro 9 nodi, passi ≤ 8 |
| Controlli statici: nessuna rete, nessun archivio locale, nessun eval, nessun worker | verificati |
| Browser Chrome, 1000×650 e 390×700, con e senza movimento ridotto | 48 controlli, nessun errore, nessuno scroll orizzontale, bersagli ≥ 44 px |
| Riquadro nascosto: nessun fotogramma richiesto | 0 fotogrammi in 1,5 s |
Semplificazioni
Il recupero è TF-IDF su un catalogo di 17 voci scritte per questa app: non è un motore di ricerca. La calcolatrice accetta solo numeri, operatori + − × ÷ ^ e parentesi. Le bozze sono composte da frasi fisse, quindi non sono generate. Il primo giudizio del Critico è un copione della Dimostrazione: i successivi seguono la regola.
Link utili
- Agente intelligente (Wikipedia en)
- ReAct: Synergizing Reasoning and Acting in Language Models (arXiv)
- Tf–idf (Wikipedia en)
- Large language model (Wikipedia en)
Sperimenta l’app sul desktop virtuale aprendo l’icona 🕸️ Il laboratorio degli agenti dal gruppo Mini Apps, oppure apri direttamente la finestra.