11 regole per scrivere prompt efficaci per agenti AI

Due settimane fa, mi è quasi venuto un colpo mentre scrivevo un articolo su come estrarre prodotti da un sito e-commerce.

Ecco perché: ho provato a estrarre i prodotti da Gymshark, un sito e-commerce, usando un framework di prompting per classificare e modificare i dati che avevo creato per gli AI assistant di Datablist. All’inizio sembrava funzionare, ma i dati non erano ordinati correttamente, rendendo l’intero dataset inutilizzabile.

È stato allora che ho capito che AI e casi d’uso diversi richiedono prompt diversi.

Nel prompting, anche i piccoli dettagli possono fare un’enorme differenza: trascurarne anche solo il 5% può rendere inutile il risultato.

Cominciamo!

Se ti serve un template di prompt per AI agent, parti dall’input, dalla fonte da esaminare, dai campi di output esatti e dalle istruzioni da seguire quando mancano le prove. Per una lista di aziende da analizzare, puoi usare questo breve prompt:

Per ogni riga, usa il valore Company Website per esaminare il sito ufficiale dell’azienda. Restituisci Industry, Evidence URL e Status. Usa Not found quando non puoi verificare il settore; non dedurlo dal nome dell’azienda. Mantieni il risultato associato alla riga originale, così potrò controllare i casi incerti.

In questo modo, l’agent riceve sia una fonte sia regole precise per l’output. Prima provalo su alcune righe diverse tra loro, controlla gli URL usati come prova e poi perfeziona le istruzioni prima di eseguirlo sull’intera lista. Il template dettagliato che trovi più avanti mostra come ampliare questo schema per ricerche articolate in più passaggi.

Cosa imparerai in questo articolo:

• Gli AI agent di Datablist possono cercare su Google, visitare siti web, chiamare API e molto altro
• Un buon prompt fa un’enorme differenza quando si utilizza un AI agent
• Scrivere prompt per AI agent è più semplice seguendo le nostre best practice
• Datablist offre template di prompting, ma imparare a scriverli resta la scelta migliore

AI agent e AI assistant di Datablist a confronto

Per capire la differenza tra i prompt per AI agent e quelli per AI assistant, dobbiamo prima chiarire le rispettive capacità.

Ecco due panoramiche brevi e semplici di ciò che questi strumenti possono fare:

AI assistant

Gli AI assistant di Datablist sono progettati per leggere, classificare, estrarre, modificare e generare testo e codice.

AI agent

Gli AI agent di Datablist sono AI dotate di strumenti che permettono loro di effettuare ricerche su Google, eseguire il rendering di codice HTML, navigare tra più pagine, chiamare API, visitare Google News, siti web e store e-commerce ed estrarne i risultati, oltre a molto altro.

💡 Semplice e immediato

Pensa agli AI agent come al sistema che lavora con dati esterni e agli AI assistant come al sistema che gestisce i dati presenti nella tua collection Datablist.

Cosa possono fare gli AI agent di Datablist

Per scrivere un prompt efficace per un AI agent, è utile riepilogare gli strumenti e le funzionalità a sua disposizione:

• Effettuare ricerche su Google
• Effettuare ricerche su Google News
• Estrarre e generare testo o codice
• Recuperare informazioni sugli account
• Visitare un sito web
• Esplorare le pagine successive di un sito
• Eseguire il rendering HTML
• Chiamare API

11 regole per scrivere prompt per AI agent

Ora che conosci gli strumenti disponibili, segui queste regole per rendere il prompt più facile da interpretare e i risultati più semplici da verificare. Un prompt chiaro può ridurre le ambiguità, ma non garantisce risposte sempre corrette. Ecco le regole:

1. Considera il prompt una roadmap: guida l’agent nella richiesta, invece di limitarti a impartire un ordine aspettandoti che funzioni.
2. Inizia sempre dal tuo obiettivo e fornisci il contesto necessario.
3. Assegna un’etichetta a ogni sezione del prompt, così l’agent potrà interpretare meglio ciò che scrivi e distinguere azioni e comandi.
4. Usa comandi chiari per richiamare gli strumenti dell’AI agent, come “cerca su Google”, “estrai il testo”, “recupera il codice HTML” e così via.
5. Etichetta gli output e fornisci esempi specifici: saranno la base per configurare il risultato.
6. Se vuoi estrarre dati specifici, indica in quale area del sito si trovano le informazioni che cerchi.
7. Usa separatori tra le parti del prompt (.===) per organizzarne la struttura.
8. Specifica quali errori evitare, in modo che l’agent possa prevenirli.
9. Definisci come gestire errori e dati mancanti.
10. Migliora i prompt in modo iterativo e non dare la colpa all’AI agent se gli output sono scadenti (io lo facevo).
11. Inserisci sempre alla fine la colonna da cui l’agent deve prendere i dati.

Seguendo queste linee guida e best practice per il prompting degli AI agent, risparmierai crediti e molto tempo nelle iterazioni sui tuoi prompt.

📘 I buoni prompt fanno la differenza

L’AI agent funzionerà anche se non seguirai nessuna delle regole indicate sopra. Tuttavia, applicandole otterrai risultati decisamente migliori, perché la struttura del prompt conta davvero.

Esempi di prompt per AI agent: buoni e cattivi

Prompt per AI agent: un buon esempio

Osserviamo prima un buon prompt e poi confrontiamolo con uno scritto male.

Questo è un prompt che ho creato di recente per estrarre prodotti da un sito e-commerce.

Vediamo nel dettaglio perché è un buon prompt:

1. Inizia con un obiettivo specifico, definito chiaramente e accompagnato dal contesto
2. Il prompt contiene più sezioni, tutte etichettate: in questo modo l’AI può comprenderlo facilmente
3. Ho usato comandi chiari con verbi orientati all’azione
4. I comandi seguono una sequenza precisa
5. Ho descritto cosa cercavo e fornito alcuni esempi
6. Ho spiegato come gestire incongruenze ed errori nei dati
7. Ho indicato gli errori specifici da evitare
8. Le sezioni sono separate chiaramente con .===
9. Il prompt è ben strutturato e guida l’AI lungo tutta la richiesta
10. Alla fine ho collegato la colonna contenente i dati di riferimento

Prompt per AI agent: un cattivo esempio

Se pensi che io sia semplicemente un tecnico capace di scrivere ottimi prompt, ecco la verità: prima di tutto, non so programmare; in secondo luogo, questo era l’aspetto iniziale del mio prompt:

Sì, qualcuno potrebbe comunque considerarlo valido, ma non lo è: gli output, infatti, erano tutt’altro che buoni.

In questo esempio sono andate storte molte cose. Anche se sembra sofisticato, il prompt — e di conseguenza i risultati — è inutile. Ecco gli errori che ho commesso e come puoi evitarli:

Problema n. 1: struttura mediocre

Il prompt non ha un flusso chiaro né un’organizzazione precisa.

Come evitarlo:

Suddividi l’obiettivo in passaggi specifici, come se dovessi spiegare l’attività a un’altra persona. Per esempio:

• Per prima cosa, visita il sito web.
• Poi cerca la sezione dedicata ai prodotti.
• Infine, estrai il prezzo.

Problema n. 2: etichette poco chiare

Le etichette e le sezioni non sono abbastanza specifiche.

Come evitarlo:

Assegna alle sezioni nomi chiari e di uso comune. Invece di “Parametri dei dati”, scrivi “Informazioni sul prodotto da estrarre”. Invece di “Input”, usa “URL dei siti web da elaborare”.

Problema n. 3: output non strutturati e senza esempi

Il formato dei dati e gli esempi di output attesi non sono definiti chiaramente.

Come evitarlo:

Includi sempre sia la struttura dei dati, usando elenchi numerati, sia 2-3 esempi specifici degli output desiderati.

Esempio:

1. Nome prodotto: Nike Air Max; Adidas Ultraboost; Puma RS-X;
2. Prezzo: $120; $180; $110;
3. Colore: Nero; Bianco Cloud; Rosso High Risk;
4. Taglia: US 9; US 10.5; US 8;
5. Materiale: Mesh e materiale sintetico; Primeknit; Pelle e mesh;

Problema n. 4: nessuna sequenza chiara

Le azioni non seguono un ordine logico.

Come evitarlo:

Scrivi i passaggi come se stessi dando indicazioni a un amico: “Prima fai questo, poi fai quello”.

Esempio:

1. Apri il sito web;
2. Trova la sezione dedicata ai prodotti;
3. Estrai i dati

I 3 errori più comuni nell’uso degli AI agent

Da quando sono entrato in Datablist.com, ho parlato con molti clienti interessati a utilizzare l’AI agent. Durante queste conversazioni ho notato alcuni errori ricorrenti: assicurati di non commetterli anche tu.

• Non voler scrivere il prompt: alcune persone pensano che l’AI possa leggere nel pensiero senza bisogno di spiegazioni. Vogliono risparmiare tempo, ma trovano assurdo dedicare tempo a qualcosa che, in futuro, ne farà risparmiare molto di più: non fare come loro.

• Dare istruzioni troppo vaghe: invece di scrivere “recupera le informazioni sul prodotto”, specifica esattamente quali dati ti servono, per esempio: “estrai il nome del prodotto, il prezzo in euro e le taglie disponibili dalla sezione con i dettagli del prodotto”.

• Trascurare la gestione degli errori: il prompt dovrebbe spiegare come comportarsi in presenza di dati mancanti o situazioni impreviste, per esempio: “se il prezzo non è disponibile, indica N/A”.

Quanto tempo dedicare alla scrittura dei prompt

Considera il valore che ricavi da questo workflow e quanto tempo ti farà risparmiare.

Personalmente, dedico molto tempo a scrivere prompt per le mie attività e per aiutare i nostri utenti.

Quando uso Grok, non passo 30 minuti a scrivere un prompt: faccio la prima richiesta e poi procedo per iterazioni, perché non gli affido attività particolarmente sofisticate. Quando invece preparo un prompt per personalizzare le email o per il data cleaning, preferisco investirci più tempo. Così ne risparmio in seguito, perché individuo prima i problemi ed evito di dover modificare il prompt e riprovare più avanti.

Harrison Chase, fondatore di LangChain: “Non credo che abbiamo ancora trovato il modo giusto di interagire con queste applicazioni basate su agent. Ritengo che la supervisione umana sia ancora necessaria, perché non sono del tutto affidabili. Ma se l’intervento umano è troppo frequente, allora l’applicazione non svolge poi molto lavoro utile. Esiste quindi uno strano equilibrio da trovare.”

Template di prompt per AI agent con esempi

Copia questo template e sostituisci ogni placeholder con i tuoi input, la fonte e i campi di output. Quando la risposta proviene da un sito web, includi un URL come prova. Provalo su alcune righe e verifica sia i risultati trovati sia quelli mancanti prima di utilizzarlo su larga scala.

Ecco il mio framework applicato a un esempio di scraping e-commerce:

Ecco il mio framework applicato a un esempio di ricerca sui media:

Domande frequenti sulla scrittura dei prompt AI

1. Devo davvero dedicare tempo ai prompt? Non basta chiedere all’AI?

Anche se può sembrare dispendioso, investire tempo nella scrittura di prompt chiari è fondamentale per ottenere risultati accurati. Istruzioni vaghe producono output altrettanto vaghi, costringendoti a perdere ancora più tempo in iterazioni e correzioni.

2. Qual è la differenza tra un prompt buono e uno cattivo?

Un buon prompt presenta una struttura chiara, istruzioni specifiche, esempi degli output desiderati e regole per la gestione degli errori. I prompt scritti male sono vaghi, disorganizzati, privi di esempi e non tengono conto di possibili errori o incongruenze.

3. Esiste un template semplice per scrivere i prompt?

Sì. L’articolo propone un template composto da cinque sezioni principali: Obiettivo, Istruzioni per l’attività, Informazioni da estrarre, Regole per la gestione dei dati ed Errori da evitare. Ogni sezione deve essere separata chiaramente con “===”.

4. Quanto devono essere dettagliati gli esempi nel prompt?

Gli esempi devono essere specifici e coprire i diversi scenari che potresti incontrare. Quando estrai informazioni sui prodotti, per esempio, includi esempi dei diversi formati, delle valute o delle unità di misura che prevedi di trovare.

5. Qual è la parte più importante di un prompt?

Le sezioni dedicate alla gestione degli errori e agli “Errori da evitare” sono essenziali. Prevengono i problemi più comuni e assicurano output coerenti anche in presenza di dati o situazioni impreviste.