Input del modello con Pydantic
Definisca una struttura tipizzata per gli argomenti di uno strumento.
Input del modello con Pydantic è 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.
Un modello per ogni input
Per definire gli argomenti di uno strumento, scriva un modello Pydantic: una piccola classe in cui ogni attributo è un campo tipizzato dell'input.
from pydantic import BaseModel
class SearchInput(BaseModel):
query: str
limit: intEstenda BaseModel
Ogni modello di input eredita da BaseModel, che fornisce gratuitamente analisi, convalida e generazione dello schema JSON.
I campi sono attributi tipizzati
Ogni riga indica un campo e il relativo tipo. Pydantic legge queste annotazioni per sapere come deve essere un input valido.
Passi il modello come unico argomento
In uno strumento FastMCP, accetti il modello come un unico parametro tipizzato e il framework crea lo schema a partire da esso.
@mcp.tool()
def search(args: SearchInput) -> str:
return run(args.query, args.limit)Acceda ai campi per nome
All'interno dello strumento, legga i valori come attributi: args.query e args.limit. Nessun accesso tramite dict e il Suo editor completa automaticamente i nomi.
Conversione automatica quando appropriato
Pydantic converte in modo trasparente i valori compatibili, ad esempio trasformando la stringa 5 nell'intero 5, così le piccole discrepanze vengono gestite automaticamente.
Rifiuto dei tipi errati
Se un valore non può diventare del tipo dichiarato, Pydantic genera un chiaro errore di convalida invece di lasciarlo passare.
Modelli annidati
Un campo può essere a sua volta un altro modello, consentendo di descrivere in modo ordinato oggetti annidati invece di dict grezzi profondamente annidati.
class Address(BaseModel):
city: str
class User(BaseModel):
name: str
home: AddressLo schema viene generato
Pydantic trasforma automaticamente il modello in uno schema JSON, che MCP inoltra al client affinché il modello conosca la struttura dell'input.
Riutilizzi i modelli tra gli strumenti
Definisca un modello una volta e lo condivida tra diversi strumenti. In questo modo le strutture degli input rimangono coerenti e il codice resta DRY.
Sicurezza dei tipi dall'inizio alla fine
Dalla chiamata del modello al corpo della funzione, i dati mantengono un unico tipo verificato, così non dovrà più gestire dict non tipizzati.
Controllo rapido
Come si definisce con Pydantic una struttura di input tipizzata per uno strumento?
Riepilogo
Estenda BaseModel, elenchi i campi tipizzati e passi il modello come unico argomento. Pydantic convalida l'input e genera lo schema. ✅
Domande Frequenti
La lezione «Input del modello con Pydantic» è gratuita?
Sì — il testo completo di «Input del modello con Pydantic» è 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 «Input del modello con Pydantic»?
Definisca una struttura tipizzata per gli argomenti di uno 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 «Input del modello con Pydantic»?
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
- Perché gli schemi sono migliori degli argomenti non vincolati
- Input del modello con Pydantic
- Vincoli, valori predefiniti ed enumerazioni
- Descrizioni dei campi che guidano il modello