Registrare il primo prompt
Decori una funzione per pubblicare un prompt.
Registrare il primo prompt è 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.
Il primo prompt
È il momento di pubblicare un prompt: un template riutilizzabile e attivato dall'utente, che avvia ogni volta un'attività con una formulazione ben curata. 💬
Il decorator
Trasformi una normale funzione Python in un prompt con il decorator @mcp.prompt(), proprio come ha contrassegnato gli strumenti con @mcp.tool().
@mcp.prompt()
def greet() -> str:
return "Say hello warmly."Il nome deriva dalla funzione
Per impostazione predefinita, il nome del prompt è il nome della funzione. I client mostrano questo nome in un menu slash, quindi lo renda breve e chiaro.
Il valore restituito
Il prompt più semplice restituisce una stringa. Questo testo diventa il messaggio iniziale dell'utente consegnato al modello quando qualcuno seleziona il prompt.
Aggiungere una descrizione
La docstring della funzione diventa la descrizione del prompt. Indica all'utente a cosa serve il prompt prima che lo attivi.
@mcp.prompt()
def greet() -> str:
"""Start a friendly greeting."""
return "Say hello warmly."Attivato dall'utente, non automaticamente
A differenza degli strumenti, un prompt viene eseguito solo quando l'utente lo seleziona esplicitamente. Il modello non invoca mai un prompt autonomamente.
Risiede sul server
Il prompt viene registrato sulla stessa istanza del server FastMCP che contiene strumenti e risorse. Un server, tre tipi di primitivi.
mcp = FastMCP("my-server")
@mcp.prompt()
def greet() -> str:
return "Say hello warmly."I client possono elencarlo
Una volta registrato, i client chiamano prompts/list per individuarlo. È così che un host riempie il menu dei comandi slash o dei template.
Selezionarlo per ottenere il messaggio
Quando l'utente seleziona il prompt, l'host lo recupera e avvia la chat con il testo restituito. L'utente parte da un messaggio di apertura curato.
Mantenere il testo focalizzato
Un buon corpo del prompt fornisce al modello istruzioni chiare, non una lunga lista di opzioni. Indichi l'obiettivo e il tono, poi si fermi.
Perché usarlo
Un prompt registrato evita a tutti di riscrivere la stessa richiesta e mantiene coerente la formulazione in tutto il team. ✨
Controllo rapido
Verifichiamo come vengono registrati i prompt.
Riepilogo: primo prompt
Ottimo lavoro! Il decorator @mcp.prompt() pubblica una funzione come template attivato dall'utente, mostrando agli utenti il nome e la docstring. ✅
Domande Frequenti
La lezione «Registrare il primo prompt» è gratuita?
Sì — il testo completo di «Registrare il primo prompt» è 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 «Registrare il primo prompt»?
Decori una funzione per pubblicare un prompt. 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 «Registrare il primo prompt»?
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