Come scrivere un prompt che richiede un output strutturato

Descrivi esattamente la forma che vuoi, non solo il nome del formato

Dire "restituiscilo come JSON" è un inizio, ma nominare i campi, il loro ordine e i loro tipi è ciò che rimuove davvero l'ambiguità — "restituisci un oggetto JSON con un campo stringa chiamato title e un campo array chiamato steps, dove ogni step è una stringa" lascia molto meno da indovinare al modello rispetto a "restituisci JSON con il title e gli steps." Lo stesso vale per una tabella: nomina le colonne e cosa appartiene a ciascuna invece di supporre che il modello scelga la stessa suddivisione che hai in mente.

Mostra un esempio della forma esatta di output desiderata

Un singolo esempio della forma finita — un breve campione di oggetto JSON, o una riga della tabella — spesso rimuove più ambiguità di un altro paragrafo di descrizione, per la stessa ragione per cui un esempio aiuta nel prompting few-shot, linkato di seguito. Questo conta soprattutto quando il formato ha una particolarità facile da descrivere in modo impreciso, come se un campo sia opzionale o come debba essere rappresentato un valore mancante.

Cosa non garantisce qui un prompt ben scritto

Un prompt scritto con cura rende più probabile un output valido e ben formato, ma non lo garantisce — un modello può comunque restituire JSON malformato, un campo extra, o del testo che avvolge la struttura richiesta, specialmente su una risposta più lunga o complessa. Vedi cosa sono gli output AI strutturati, linkato di seguito, per i meccanismi tecnici — come la generazione vincolata da schema — che esistono proprio perché il solo prompting non è una garanzia affidabile, e per cosa fa ClawAI in modo diverso dal semplice chiedere gentilmente in un prompt.

Domande frequenti

Chiedere gentilmente in un prompt basta a garantire un JSON valido?

No — un prompt ben scritto lo rende più probabile, non certo. Vedi cosa sono gli output AI strutturati, linkato di seguito, per i meccanismi che esistono perché il solo prompting non garantisce in modo affidabile una struttura valida.

Dovrei descrivere il formato o mostrare un esempio?

Entrambi, quando il formato presenta una qualche ambiguità — una descrizione precisa dei campi più un esempio della forma finita copre più casi di uno solo dei due. Vedi il prompting few-shot, linkato di seguito, per come scegliere un buon esempio.

Qual è la differenza tra questa guida e cosa sono gli output AI strutturati?

Quella pagina spiega il meccanismo tecnico dietro un output strutturato affidabile; questa pagina è il complemento pratico — come scrivere il prompt stesso. Sono pensate per essere lette insieme, non come duplicati l'una dell'altra.