Restituire messaggi, non solo testo
Strutturi l'output del prompt come messaggi di chat organizzati.
Restituire messaggi, non solo testo è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 3 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.
Oltre una singola stringa
Un prompt può fare più che restituire una riga. Può restituire un elenco di messaggi per preparare un'apertura più ricca e con più turni. 🗂️
I messaggi hanno ruoli
Ogni messaggio ha un ruolo, di solito utente o assistente. I ruoli permettono di preparare un breve scambio prima ancora che l'utente inizi a scrivere.
I componenti helper dei messaggi
SDK mette a disposizione gli helper UserMessage e AssistantMessage, così può creare i turni della chat senza scrivere manualmente la struttura grezza.
from mcp.server.fastmcp.prompts import base
@mcp.prompt()
def ask() -> list[base.Message]:
return [base.UserMessage("Help me debug.")]Restituire un elenco
Per inviare più turni, restituisca un elenco di questi oggetti messaggio. L'host li riproduce nell'ordine in cui compaiono, come inizio della conversazione.
return [
base.UserMessage("Explain this error."),
base.AssistantMessage("Sure, paste it in.")
]Una singola stringa funziona ancora
Restituire una semplice stringa è solo una scorciatoia: SDK la racchiude in un unico messaggio utente. Gli elenchi offrono un controllo più preciso sulla configurazione.
Preparare l'assistente
Un AssistantMessage può predisporre la personalità del modello o ricordargli alcune regole, così la conversazione inizia già nella direzione corretta.
Configurare il contesto
Usi i messaggi iniziali per inserire contesto, come standard di codifica o un ruolo, che il modello dovrà tenere presenti per tutta l'attività.
Inserire gli argomenti
Può comunque inserire argomenti in qualsiasi messaggio dell'elenco. Gli input dell'utente confluiscono in una conversazione strutturata, non in una sola riga.
@mcp.prompt()
def debug(error: str) -> list[base.Message]:
return [base.UserMessage(f"Fix this error:\n{error}")]L'ordine è importante
L'ordine dell'elenco determina l'ordine dei turni. Inizi dal contesto o da una nota in stile sistema, poi inserisca la richiesta dell'utente, così il modello la legge in modo naturale.
Perché usare i messaggi
I messaggi strutturati definiscono un punto di partenza migliore rispetto a un unico blocco di testo, soprattutto per le attività che richiedono una configurazione preliminare.
Mantenere la struttura essenziale
Un paio di turni ben posizionati sono meglio di molti. Ogni messaggio aggiuntivo consuma token, quindi includa solo ciò che migliora davvero il risultato.
Controllo rapido
Definiamo con precisione il tipo restituito più ricco.
Riepilogo: output dei messaggi
Ben fatto! I prompt possono restituire un elenco di messaggi con ruolo, creati con UserMessage e AssistantMessage per preparare un'apertura più ricca. ✅
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 «Restituire messaggi, non solo testo» è gratuita?
Sì — il testo completo di «Restituire messaggi, non solo testo» è 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 «Restituire messaggi, non solo testo»?
Strutturi l'output del prompt come messaggi di chat organizzati. 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 3 di 4.
Quanto tempo richiede la lezione «Restituire messaggi, non solo testo»?
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
- Registrare il primo prompt
- Aggiungere argomenti a un prompt
- Restituire messaggi, non solo testo
- Un template di prompt per la code review