Convalidare gli input prima di agire
Rifiuti gli argomenti non validi con messaggi chiari.
Convalidare gli input prima di agire è 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.
Non si fidi di nulla di ciò che invia il modello
Gli argomenti ricevuti dallo strumento provengono da un’IA, che può fare supposizioni. Convalidi ogni input prima di accedere a un file, a un database o a un’API.
Controllare prima, agire dopo
Esegua i Suoi controlli all’inizio della funzione. Verifichi che l’input sia valido prima di eseguire qualsiasi operazione reale o irreversibile.
@mcp.tool()
def set_age(age: int) -> str:
if age < 0 or age > 130:
raise ValueError("age out of range")Rifiutare indicando chiaramente il motivo
Quando un input non supera un controllo, spieghi esattamente il motivo. Un messaggio preciso consente al modello di inviare un valore corretto al tentativo successivo.
Le annotazioni di tipo rilevano molti errori
Le annotazioni dei parametri diventano lo schema dello strumento, quindi le incompatibilità di tipo di base vengono rilevate prima ancora che il codice venga eseguito. Si affidi innanzitutto a queste.
@mcp.tool()
def repeat(text: str, times: int) -> str:
return text * timesLe annotazioni non bastano
I soli tipi non possono esprimere intervalli, formati o valori consentiti. Deve comunque convalidare che un conteggio sia positivo o che uno stato rientri tra quelli accettati.
Limitare gli intervalli
Protegga gli input numerici dai valori estremi. Un limite per la dimensione della pagina o il numero di iterazioni impedisce al modello di sovraccaricare accidentalmente il server.
if limit > 100:
raise ValueError("limit must be 100 or less")Inserire nella whitelist i valori consentiti
Per le scelte predefinite, controlli l’appartenenza invece di fidarsi del testo libero. Una whitelist rifiuta tutto ciò che non rientra nelle opzioni effettivamente supportate.
if status not in {"open", "closed"}:
raise ValueError("status must be open or closed")Sanificare percorsi e query
Un input del modello usato come percorso di file o query SQL è pericoloso. Lo sanifichi in modo che un .. o un apice isolato non possa oltrepassare i limiti previsti.
I campi obbligatori devono esistere
Verifichi che ogni elemento obbligatorio sia effettivamente presente e non vuoto. Una protezione iniziale è meglio di un errore confuso nel profondo della logica.
if not query.strip():
raise ValueError("query cannot be empty")La convalida funge anche da documentazione
Dei controlli chiari insegnano al modello le Sue regole. Dopo un rifiuto, il modello impara il formato e invia input validi per il resto della sessione.
Fallire prima degli effetti collaterali
La regola d’oro è non avviare mai un’azione irreversibile finché ogni input non è stato accettato. Convalidi tutto in anticipo, così non si verificano scritture parziali.
Verifica rapida
Perché convalidare gli input prima di eseguire il lavoro effettivo dello strumento?
Riepilogo
Consideri non attendibili gli input del modello: convalidi tipi, intervalli e scelte all’inizio, rifiuti indicando chiaramente i motivi e non agisca mai prima del superamento dei controlli. ✅
Domande Frequenti
La lezione «Convalidare gli input prima di agire» è gratuita?
Sì — il testo completo di «Convalidare gli input prima di agire» è 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 «Convalidare gli input prima di agire»?
Rifiuti gli argomenti non validi con messaggi chiari. 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 «Convalidare gli input prima di agire»?
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
- Errori degli strumenti visibili al modello
- Errori di protocollo e fallimenti degli strumenti
- Convalidare gli input prima di agire
- Fallire in sicurezza senza bloccarsi