Come dare istruzioni a un agente di programmazione IA: modello pratico

Un brief utile per un agente di programmazione IA descrive comportamento desiderato, contesto del progetto, vincoli e modalità di verifica del completamento. L’agente deve capire cosa cambiare e perché, senza indovinare decisioni importanti sul prodotto. Istruzioni valide rendono anche più facile controllare il lavoro risultante.

Non devi descrivere ogni dettaglio implementativo. Concentrati sui comportamenti osservabili e fornisci i fatti tecnici che conosci davvero. Segnala le incertezze come domande, invece di riempirle con supposizioni presentate come certezze.

Parti da un risultato

Considera una piccola applicazione per appuntamenti. «Migliora la pagina di prenotazione» lascia spazio a interpretazioni. Una richiesta più utile è: «Consenti a un visitatore di scegliere un orario disponibile e ricevere una conferma, impedendo due prenotazioni per la stessa fascia».

Spiega il motivo della modifica. Forse oggi i visitatori inviano una richiesta libera e il personale coordina manualmente le disponibilità. Il contesto aiuta l’agente a valutare le scelte, ma il comportamento desiderato deve rimanere esplicito. Una lunga descrizione aziendale non sostituisce un’attività chiara.

Fornisci il contesto rilevante

Identifica repository, percorso o componente coinvolto, modello dati attuale e comandi per eseguire o controllare l’applicazione. Indica convenzioni e istruzioni del progetto. Chiedi all’agente di esaminare i file pertinenti prima di proporre modifiche.

Non includere credenziali nel prompt e non inserirle nel repository. Descrivi la configurazione necessaria tramite i nomi delle variabili e usa la normale gestione dei segreti del progetto. Se intervengono una dipendenza o un’API esterna, chiedi di verificare la documentazione ufficiale aggiornata per la versione utilizzata.

Stabilisci vincoli e confini

Specifica cosa può essere modificato. Nell’esempio si potrebbe intervenire sul percorso di prenotazione preservando amministrazione del personale e modelli delle email. Indica se l’incarico comprende modifiche al database, migrazione, distribuzione e notifiche esterne.

Separa lo sviluppo reversibile dalle azioni con conseguenze significative. Un agente può preparare e testare una migrazione senza presumere di doverla eseguire in produzione. Confini chiari riducono i fraintendimenti e rendono concreta la revisione: puoi esaminare modifica proposta, effetti e possibilità di ripristino.

Includi casi di successo ed errore

Descrivi una prenotazione riuscita, un’email non valida, una fascia indisponibile e un’interruzione di rete. Chiedi un test di tentativi concorrenti sullo stesso orario se il sistema supporta utenti simultanei. Una verifica visiva del pulsante non dimostra che le doppie prenotazioni siano impedite.

Richiedi un resoconto sintetico su comportamento modificato, verifiche eseguite e limiti irrisolti. Se un test non è stato eseguibile, deve restare visibile. «Implementato» e «verificato nell’applicazione distribuita» sono affermazioni diverse e vanno riportate accuratamente.

Usa questa struttura riutilizzabile

• Risultato: cosa deve poter fare l’utente e perché conta.
• Contesto: file pertinenti, comportamento attuale, dati e convenzioni del progetto.
• Perimetro: modifiche incluse e confini espliciti.
• Accettazione: comportamento normale, gestione degli errori ed esempi da verificare.
• Consegna: modifiche esaminabili, evidenze dei test, configurazione necessaria e aspettative sulla distribuzione.

Per un’attività più ampia, chiedi una breve sequenza di modifiche e controlla ogni passaggio completato. Conserva la cronologia ed evita miglioramenti estranei mentre un comportamento centrale rimane incerto. Il tuo ruolo è mantenere chiari risultato ed evidenze; il lavoro dell’agente diventa più utile quando questo accordo operativo è esplicito.

Continua a imparare con Innoba

Collega questo esercizio a Costruire con agenti di programmazione IA. Per approfondire i concetti, esplora il libro sul lavoro con agenti di programmazione IA e l’Academy BUILD. Scegli un’attività del tuo lavoro, conserva i materiali che produci e usa le domande di questo articolo per rivedere le tue decisioni mentre sviluppi la competenza.

Articoli correlati

• Si può creare software con l’IA senza saper programmare?
• Come testare un MVP costruito con l’IA prima di condividerlo