Errori degli strumenti visibili al modello
Restituisca errori che l'intelligenza artificiale possa leggere e gestire.
Errori degli strumenti visibili al modello è 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.
Gli errori sono semplicemente più contesto
Quando uno strumento non riesce, l’IA non va in crash. Legge semplicemente il Suo errore come contesto e decide cosa fare dopo, proprio come farebbe con qualsiasi risultato.
Un buon errore indica come agire
Scriva l’errore pensando a chi può intervenire. «Città non trovata» è meglio di «Exception», perché il modello può chiedere all’utente di correggere la città.
Restituire una stringa di errore
Il modello più semplice consiste nel restituire una stringa di messaggio chiara quando qualcosa non va, così il modello legge esattamente cosa non ha funzionato.
@mcp.tool()
def get_user(uid: int) -> str:
if uid < 1:
return "Error: uid must be positive."Usare raise per segnalare un errore dello strumento
Può anche usare raise per sollevare una normale eccezione Python. FastMCP la intercetta e segnala un errore dello strumento al modello, senza causare un crash del server.
@mcp.tool()
def divide(a: float, b: float) -> float:
if b == 0:
raise ValueError("b cannot be zero")
return a / bisError contrassegna il risultato
Dietro le quinte, una chiamata dello strumento non riuscita restituisce contenuti con isError impostato su true. Questo flag comunica al client che il risultato descrive un errore.
Il modello può recuperare
Un errore leggibile consente all’IA di riprovare con dati migliori o di spiegare il problema all’utente, trasformando un errore nel prossimo passo utile. 🔁
Indicare cosa e perché
Gli errori efficaci indicano cosa non ha funzionato e perché. «File mancante: report.csv» è molto più utile per il modello di un semplice «Non trovato».
Suggerire una correzione
Quando possibile, suggerisca il rimedio all’interno dell’errore. «La data deve essere YYYY-MM-DD» consente al modello di correggersi già nella chiamata successiva.
if not iso_date:
raise ValueError("Date must be in YYYY-MM-DD format")Non divulgare mai i dettagli interni
Gli errori arrivano al modello e spesso anche all’utente: non inserisca quindi segreti, stack trace grezzi o stringhe di connessione nel messaggio restituito.
Convalidare e segnalare subito l’errore
Controlli prima gli argomenti e restituisca l’errore prima di eseguire il lavoro vero e proprio. Interrompere subito in caso di errore rende lo strumento prevedibile e facile da analizzare.
Gli errori fanno parte del contratto
Consideri gli errori come un output progettato. Uno strumento che indica i probabili errori è utile al modello quanto uno che documenta il proprio successo.
Verifica rapida
Perché scrivere gli errori degli strumenti come messaggi chiari e leggibili?
Riepilogo
Gli errori degli strumenti sono contesto che il modello legge: li renda chiari, indichi cosa e perché, suggerisca una correzione e non divulghi mai i dettagli interni. ✅
Domande Frequenti
La lezione «Errori degli strumenti visibili al modello» è gratuita?
Sì — il testo completo di «Errori degli strumenti visibili al modello» è 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 «Errori degli strumenti visibili al modello»?
Restituisca errori che l'intelligenza artificiale possa leggere e gestire. 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 «Errori degli strumenti visibili al modello»?
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