Quale strumento scegliere
Tre formati per tre scopi diversi, e la scelta dipende da dove finisce l'output. Il Markdown (un modo di formattare il testo con simboli semplici per titoli, grassetto, elenchi) serve per documenti leggibili, note, pagine web: lo usi quando il risultato lo legge una persona. Il CSV (valori separati da virgola) serve per le tabelle da aprire in un foglio di calcolo. Il JSON (struttura a coppie nome-valore) serve quando i dati li riceve un'altra applicazione o uno strumento di automazione. Scegli il formato in base al destinatario: occhi umani, foglio di calcolo, o un altro programma.
Come si fa
- Nomina il formato e vietagli il contorno. L'errore tipico dell'AI è incorniciare l'output con frasi e spiegazioni. Per il JSON, la sintassi operativa:
Restituisci la risposta esclusivamente come JSON valido.
Nessun testo prima o dopo, nessuna spiegazione, nessun blocco di codice con i tre apici.
Usa questi campi: "nome" (testo), "eta" (numero), "attivo" (vero/falso).
Se un valore non è disponibile, usa null, non inventarlo.
- Per il CSV, fissa intestazioni e separatore. Chiedi la prima riga con i nomi delle colonne, i valori separati da virgola, e di racchiudere tra virgolette i testi che contengono virgole (altrimenti spezzano le colonne).
- Per il Markdown, indica gli elementi. "Usa un titolo principale, sottotitoli per ogni sezione, elenchi puntati per le liste e una tabella per i confronti": così ottieni un documento già formattato.
- Dai la struttura, non solo il formato. Per JSON e CSV, elenca i campi esatti e il loro tipo (testo, numero, vero/falso). Senza struttura, l'AI inventa i nomi dei campi e cambiano a ogni richiesta.
- Verifica che il formato sia valido. Un JSON con una virgola di troppo non si apre. Incolla l'output in un validatore online gratuito (cerca "validatore JSON") prima di usarlo in un programma.
Esempio concreto
Devi caricare un elenco di prodotti in un'applicazione che accetta solo JSON. Hai le informazioni sparse in un documento. Le passi all'AI: "Converti questi prodotti in un array JSON. Ogni prodotto con i campi: 'nome' (testo), 'prezzo' (numero senza simbolo di valuta), 'disponibile' (vero/falso). Solo JSON valido, niente testo di contorno, niente blocco di codice." Ottieni l'elenco pulito, lo passi nel validatore per sicurezza, e lo carichi nell'applicazione senza errori. La stessa richiesta in linguaggio sciolto ti avrebbe dato un bel testo descrittivo, inutile da importare. Il formato preciso è ciò che rende l'output una cosa che le macchine sanno leggere.
Quando NON funziona (e come rimediare)
Se l'AI avvolge l'output in un blocco di codice o in frasi
Capita spesso che metta i tre apici o un "Ecco il JSON richiesto:". Rimedio: chiedi esplicitamente "nessun blocco di codice, nessun testo introduttivo, solo il contenuto grezzo". Se persiste, copia a mano solo la parte di formato e scarta il contorno.
Se il JSON o il CSV risulta non valido
Una virgoletta sbagliata o una virgola di troppo bastano a romperlo. Rimedio: incolla l'output in un validatore online e, se segnala un errore, riportalo all'AI ("questo JSON dà errore alla riga 4, correggilo") invece di sistemarlo a mano alla cieca.
Se i caratteri speciali o gli accenti si rompono
Apostrofi, accenti e virgolette curve a volte creano problemi nell'importazione. Rimedio: chiedi all'AI di usare le virgolette dritte e, per il CSV, di racchiudere i campi di testo tra virgolette. Per i dati con molti accenti, controlla un campione dopo l'importazione.
Un consiglio da chi lo usa davvero
La frase che cambia tutto è "solo il formato, nessun testo prima o dopo". L'AI è addestrata a essere cordiale e a spiegare, e quel contorno gentile è esattamente ciò che manda in errore un'importazione automatica. Mettila in ogni richiesta di output strutturato, e per il JSON e il CSV passa sempre il risultato in un validatore prima di darlo in pasto a un altro programma: dieci secondi di controllo evitano l'errore criptico che ti farebbe perdere mezz'ora a cercarlo.
Domande frequenti
Qual è la differenza pratica tra i tre formati?
Il Markdown è per i documenti che legge una persona: bello da vedere, formattato. Il CSV è per le tabelle da aprire in Excel o Fogli. Il JSON è per i dati che passano a un altro programma o a un'automazione. La regola: se lo legge un umano, Markdown; se va in un foglio, CSV; se va in un software, JSON.
Devo conoscere la programmazione per usare il JSON?
No per ottenerlo, sì un po' per capirlo. Puoi chiedere all'AI il JSON e usarlo dove serve senza programmare. Aiuta sapere che è fatto di coppie nome-valore tra parentesi graffe, così riconosci se è ben formato. Per il resto, il validatore online ti dice se è valido senza che tu debba leggerlo.
Perché l'AI a volte produce un formato dichiarato valido ma che non funziona?
Perché l'AI genera il formato imitandone l'aspetto, non eseguendolo: può scrivere un JSON che sembra giusto ma ha un errore di sintassi nascosto. Non "sa" se è valido finché qualcosa non prova ad aprirlo. Per questo il validatore non è un eccesso di zelo: è il modo per scoprire l'errore prima che lo scopra il programma a cui dai l'output, con un messaggio molto meno chiaro.