Come funzionano gli agenti AI: il ciclo, passo dopo passo
Gli agenti sembrano magia nelle demo e idraulica in produzione. Il motivo è che la parte interessante non è l'output del modello ma il ciclo che lo consuma, e quel ciclo è abbastanza corto da leggersi in una seduta.
Questa guida porta una singola richiesta da capo a fondo: cosa vede il modello a ogni turno, cosa fa il vostro codice del risultato, come torna uno strumento fallito e cosa ferma il ciclo. Se sapete raccontarlo per il vostro sistema, sapete debuggarlo.
Un giro del ciclo, in ordine#
- Assemblare il contesto: obiettivo, definizioni degli strumenti, fatti recuperati, cronologia potata.
- Chiedere al modello il passo successivo: risponde o richiede una chiamata con argomenti.
- Validare gli argomenti prima di fare qualsiasi cosa — tipi, intervalli e se chi chiama può toccare quel record.
- Eseguire lo strumento. Catturare i guasti e tradurli in messaggi brevi e concreti.
- Aggiungere chiamata e risultato alla cronologia, poi controllare le condizioni di arresto.
- Ripetere, o restituire la risposta finale con ciò che l'agente ha davvero fatto.
Cosa il modello vede e cosa no#
Il modello non ricorda nulla del turno precedente oltre a ciò che rimettete nel contesto. Questo solo fatto spiega quasi tutti i comportamenti sconcertanti. Se l'agente dimentica un vincolo di quattro passi fa, è la vostra potatura ad averlo rimosso. Se ripete tre volte la stessa chiamata fallita, il messaggio d'errore non ha detto perché in parole utilizzabili.
Scrivete gli errori degli strumenti come istruzioni, non come diagnosi. Non `HTTP 404`, ma `Nessun cliente con questo ID. Chiedi conferma del numero d'ordine.`
Fermarsi: la parte che le demo non mostrano mai#
| Condizione | Impostazione tipica | Cosa accade |
|---|---|---|
| Tetto di passi | 8–15 chiamate | Restituire il lavoro parziale con spiegazione |
| Tetto di spesa | Costo fisso per esecuzione | Fermarsi e registrare per revisione |
| Orologio | 30–120 s in interattivo | Restituire ciò che si sa |
| Rilevazione di ripetizione | Stessa chiamata e stessi argomenti due volte | Forzare un altro ramo o fermarsi |
| Cancello umano | Ogni azione irreversibile | Mettere in pausa e chiedere approvazione |
Leggere una traccia quando qualcosa va storto#
Una traccia è il registro ordinato di ogni contesto, decisione, chiamata e risultato di un'esecuzione. È l'unico strumento di debug che conta e la prima cosa da costruire. La domanda non è mai perché il modello sia cattivo, ma quale turno sia andato storto per primo e cosa potesse vedere il modello in quel momento.
Domande frequenti
Quanti passi prima di fermarsi?
Per compiti interattivi, un tetto di otto-dodici chiamate copre quasi tutto il legittimo; chi ne chiede di più di solito è bloccato.
Pianificare prima o decidere passo per passo?
I compiti brevi vanno bene passo per passo. Oltre i cinque passi, un piano esplicito rende l'esecuzione verificabile.
Perché il mio agente ripete la stessa chiamata fallita?
Quasi sempre perché il messaggio d'errore non contiene informazioni utilizzabili. Restituite errori brevi e chiari e aggiungete la rilevazione delle ripetizioni.
come funzionano gli agenti aiciclo dell'agenteragiona agisci osservatool callingarchitettura agente
