Dichiarare i parametri con le annotazioni di tipo
Utilizzi le annotazioni di tipo di Python per definire lo schema dello strumento.
Dichiarare i parametri con le annotazioni di tipo è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 2 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.
I parametri diventano uno schema
Ogni argomento della funzione dello strumento diventa parte di uno schema di input che il modello deve seguire quando chiama lo strumento. 🧩
I suggerimenti di tipo fanno il lavoro
FastMCP legge i suggerimenti di tipo di Python e costruisce automaticamente lo schema JSON, quindi raramente dovrà scrivere lo schema a mano.
@mcp.tool()
def add(a: int, b: int) -> int:
return a + bstr, int, float, bool
I tipi di base corrispondono in modo diretto: str diventa string, int e float diventano number e bool diventa boolean nello schema.
Senza tipo non c'è chiarezza
Se omette il suggerimento di tipo, il modello vede soltanto un valore generico privo di regole, favorendo input errati o non validi.
def add(a, b):
return a + bObbligatorio per impostazione predefinita
Un parametro senza un valore predefinito viene considerato obbligatorio, quindi il modello deve sempre fornirlo quando chiama lo strumento.
I valori predefiniti lo rendono facoltativo
Assegni a un parametro un valore predefinito per renderlo facoltativo. Il modello può ometterlo e la funzione utilizzerà il valore alternativo.
@mcp.tool()
def greet(name: str, formal: bool = False) -> str:
...Elenchi e dizionari
Può indicare anche le raccolte. Un argomento list corrisponde a un array JSON, mentre un dict corrisponde a un oggetto che il modello può compilare.
def tag(items: list[str]) -> int:
return len(items)Valori facoltativi
Utilizzi Optional quando un argomento può contenere un valore oppure None, indicando che il modello può lasciarlo intenzionalmente vuoto.
from typing import Optional
def find(q: str, limit: Optional[int] = None):
...Assegni nomi chiari ai parametri
Il modello vede il nome di ogni parametro nello schema, quindi city è preferibile a c e start_date ad arg2. Nomi chiari guidano chiamate migliori.
I suggerimenti abilitano la convalida
Poiché i suggerimenti definiscono lo schema, MCP può rifiutare le chiamate con il tipo errato prima dell'esecuzione del codice, individuando subito gli errori.
Mantenga ridotta la firma
Un numero minore di parametri ben tipizzati è più facile da compilare correttamente per il modello rispetto a un lungo elenco di argomenti scarsamente correlati.
Controllo rapido
Cosa rende facoltativo un parametro di uno strumento in FastMCP?
Riepilogo
I Suoi suggerimenti di tipo costruiscono lo schema dello strumento: i tipi di base corrispondono direttamente, i valori predefiniti indicano che un parametro è facoltativo e i nomi chiari guidano il modello. ✅
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 «Dichiarare i parametri con le annotazioni di tipo» è gratuita?
Sì — il testo completo di «Dichiarare i parametri con le annotazioni di tipo» è 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 «Dichiarare i parametri con le annotazioni di tipo»?
Utilizzi le annotazioni di tipo di Python per definire lo schema dello strumento. 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 2 di 4.
Quanto tempo richiede la lezione «Dichiarare i parametri con le annotazioni di tipo»?
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