Contenuto testuale o strutturato
Scopra quando restituire testo semplice e quando restituire dati.
Contenuto testuale o strutturato è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 1 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento MCP Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso MCP Academy include 4 lezioni in totale.
Due modi per rispondere
Ogni risultato di uno strumento MCP contiene dei contenuti e può averne la forma che preferisce. La distinzione principale è tra testo semplice e dati strutturati che il client può analizzare.
Che cos'è il contenuto testuale
Un risultato di testo è semplicemente una stringa che il modello può leggere, come una frase o un paragrafo. È semplice, comprensibile per le persone e facile da inserire in un prompt. 📝
Che cos'è il contenuto strutturato
Il contenuto strutturato è costituito da dati reali, come un oggetto JSON con campi denominati. I client possono leggere ogni campo invece di interpretare un testo descrittivo.
{"temp_c": 21, "condition": "sunny", "city": "Cappadocia"}Perché il solo testo può non bastare
Se uno strumento restituisce "Sono 21 gradi e c'è il sole", il client deve analizzare quel testo italiano per poterlo usare. Basta cambiare la formulazione per interrompere immediatamente l'analisi.
Perché la struttura è migliore per il codice
Con un output strutturato, un client legge direttamente result.temp_c. La struttura è prevedibile, quindi app e agenti possono farvi affidamento senza estrarre dati dal testo.
Può inviarli entrambi
MCP permette a uno strumento di restituire insieme un riepilogo testuale leggibile e dati strutturati. Il modello legge il testo, mentre il codice legge i campi.
Quando scegliere il testo
Scelga il testo semplice quando la risposta è un messaggio destinato a una persona, come una spiegazione, una nota di stato o un breve riepilogo.
Quando scegliere la struttura
Scelga il contenuto strutturato quando un altro programma utilizzerà il risultato, ad esempio per un prezzo, un record o un elenco di elementi su cui intervenire.
Il testo è l'impostazione predefinita
Se lo strumento restituisce semplicemente una stringa, MCP la racchiude automaticamente in un contenuto testuale. L'output strutturato è qualcosa che si sceglie deliberatamente di abilitare.
def get_status() -> str:
return "All systems healthy"Pensi prima a chi lo consumerà
Si chieda chi leggerà il risultato: una persona, il modello o il codice a valle? È questo consumer a determinare se scegliere testo o struttura.
Usarli insieme è comune
Gli strumenti maturi di solito restituiscono entrambi: un riepilogo amichevole per il modello e un payload tipizzato per l'app. In questo modo il risultato rimane utile per tutti.
Controllo rapido
Uno strumento fornisce prezzi a un'app di fatturazione. Quale output è più adatto?
Riepilogo: testo e struttura
Ha imparato le due forme dei risultati: testo leggibile dalle persone e dal modello, e dati strutturati per il codice. Abbini la forma a chi deve leggerla. ✅
Impara Python con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 30
- Lezioni
- 120
Domande Frequenti
La lezione «Contenuto testuale o strutturato» è gratuita?
Sì — il testo completo di «Contenuto testuale o strutturato» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso MCP Academy, passa a CoddyKit PRO. Il corso MCP Academy include 4 lezioni in totale.
Cosa imparerò in «Contenuto testuale o strutturato»?
Scopra quando restituire testo semplice e quando restituire dati. Eserciti MCP Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare MCP Academy?
Non è richiesta alcuna esperienza precedente. MCP Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 4.
Quanto tempo richiede la lezione «Contenuto testuale o strutturato»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione MCP Academy?
Sì. Ogni lezione MCP Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Contenuto testuale o strutturato
- Restituire un oggetto risultato tipizzato
- Schemi di output per i client
- Restituire immagini e dati binari