Dare un buon nome e una buona descrizione a uno strumento
Scriva descrizioni su cui il modello possa effettivamente basare le proprie azioni.
Dare un buon nome e una buona descrizione a uno strumento è 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 modello legge prima
Prima ancora di eseguire il Suo strumento, un'IA ne legge il nome e la descrizione per decidere se è adatto all'attività. 🧭
Lo nomini come un verbo
Un buon nome per uno strumento MCP indica immediatamente cosa fa, come get_weather o send_email. Breve, orientato all'azione e senza sorprese.
Da dove proviene il nome
In FastMCP il nome dello strumento, per impostazione predefinita, corrisponde al nome della funzione Python. Assegni quindi il nome con attenzione e utilizzi snake_case.
@mcp.tool()
def get_weather(city: str) -> str:
...Sovrascrivere il nome
Se il nome della funzione non è ideale, passi un name esplicito al decorator, così il modello vedrà esattamente ciò che desidera.
@mcp.tool(name="get_weather")
def weather_lookup(city: str) -> str:
...La descrizione è un prompt
Il modello legge la description dello strumento come una guida. La consideri un piccolo prompt che indica all'IA quando e perché chiamare questo strumento.
Le docstring diventano descrizioni
FastMCP trasforma automaticamente la docstring della funzione nella descrizione dello strumento: la scriva quindi pensando al modello, non soltanto alle persone.
@mcp.tool()
def get_weather(city: str) -> str:
"""Get the current weather for a city."""Indichi cosa restituisce
Una description efficace indica gli input e l'output, così il modello sa cosa riceverà prima ancora di chiamare lo strumento.
Specifichi chiaramente i limiti
Indichi i limiti nella description: quali città, quali formati e cosa non può fare. Limiti chiari impediscono al modello di usare impropriamente lo strumento.
Eviti i verbi vaghi
Parole come process o handle non dicono nulla al modello. Utilizzi un verbo preciso, così l'IA può distinguere gli strumenti al momento della chiamata.
Uno strumento, un compito
Mantenga ogni strumento concentrato su un unico compito. Uno strumento specifico e ben denominato è molto più facile da scegliere correttamente per il modello rispetto a uno che fa tutto.
Provi a pronunciare il nome ad alta voce
Legga insieme il nome e la prima riga della description. Se una persona estranea non riuscisse a capire cosa fa, probabilmente non ci riuscirebbe neppure il modello.
Controllo rapido
Da dove ricava FastMCP la descrizione di uno strumento per impostazione predefinita?
Riepilogo
Il modello legge prima il nome e la descrizione. Utilizzi nomi orientati all'azione, descrizioni nelle docstring e limiti chiari, così l'IA chiamerà correttamente lo strumento. ✅
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 «Dare un buon nome e una buona descrizione a uno strumento» è gratuita?
Sì — il testo completo di «Dare un buon nome e una buona descrizione a uno strumento» è 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 «Dare un buon nome e una buona descrizione a uno strumento»?
Scriva descrizioni su cui il modello possa effettivamente basare le proprie azioni. 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 «Dare un buon nome e una buona descrizione a uno strumento»?
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
- Dare un buon nome e una buona descrizione a uno strumento
- Dichiarare i parametri con le annotazioni di tipo
- Restituire risultati utili
- Uno strumento calcolatrice dall'inizio alla fine