Errori di protocollo e fallimenti degli strumenti
Distingua i problemi di trasporto dagli errori della logica di business.
Errori di protocollo e fallimenti degli strumenti è 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.
Due errori molto diversi
MCP presenta due tipi di errore: un errore di protocollo nella comunicazione stessa e un errore dello strumento nella logica applicativa. Vengono gestiti in modo diverso.
Gli errori di protocollo risiedono in JSON-RPC
Un errore di protocollo indica che il messaggio non ha potuto essere elaborato, ad esempio per un metodo sconosciuto o parametri non validi. Viene trasmesso nel campo error di JSON-RPC.
{"jsonrpc": "2.0", "id": 7,
"error": {"code": -32601,
"message": "Method not found"}}Gli errori degli strumenti risiedono nel risultato
Un errore dello strumento indica che la chiamata ha raggiunto la Sua funzione, ma il lavoro non è andato a buon fine. Restituisce un risultato normale contrassegnato con isError true.
Perché questa distinzione è importante
Il modello dovrebbe vedere e gestire gli errori dello strumento, mentre gli errori di protocollo di solito indicano un bug che il client deve gestire, non qualcosa che l’IA possa ritentare.
Codici JSON-RPC standard
I codici di protocollo sono negativi e standardizzati: -32601 indica un metodo non trovato, -32602 parametri non validi e -32700 un errore di analisi.
Gli errori degli strumenti raggiungono il modello
Poiché un errore dello strumento è semplicemente un risultato, il modello lo legge come contesto e può decidere di riprovare, modificare l’input o spiegarlo. 🔁
Sollevare un’eccezione all’interno di uno strumento
Quando solleva un’eccezione in uno strumento, FastMCP la trasforma in un risultato di errore dello strumento, non in un errore di protocollo. Il server continua a funzionare.
@mcp.tool()
def fetch(url: str) -> str:
if not url.startswith("http"):
raise ValueError("url must be http")Uno strumento sconosciuto è un errore di protocollo
Se un client richiede uno strumento inesistente, si tratta di un errore di protocollo. La richiesta non raggiunge nessuna delle Sue funzioni.
Gli argomenti errati possono rientrare in entrambe le categorie
Le incompatibilità di tipo a livello di schema vengono segnalate come errore di protocollo per parametri non validi, mentre un tipo valido con un valore errato è preferibilmente un errore dello strumento.
Associare l’errore al destinatario
Si chieda chi debba intervenire. Se il modello può correggere il problema, lo trasformi in un errore dello strumento. Se può intervenire solo lo sviluppatore, è corretto usare un errore di protocollo.
Mantenere integro il trasporto
Non lasci mai che i problemi applicativi emergano come errori di protocollo. Questo confonde i client e può interrompere una sessione che dovrebbe continuare.
Verifica rapida
Dove viene segnalato un errore che si verifica all’interno della funzione dello strumento?
Riepilogo
Gli errori di protocollo indicano che il messaggio stesso non è riuscito; gli errori degli strumenti indicano un problema nella logica. Indirizzi ciascun errore a chi può intervenire e mantenga integro il trasporto. ✅
Domande Frequenti
La lezione «Errori di protocollo e fallimenti degli strumenti» è gratuita?
Sì — il testo completo di «Errori di protocollo e fallimenti degli strumenti» è 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 di protocollo e fallimenti degli strumenti»?
Distingua i problemi di trasporto dagli errori della logica di business. 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 «Errori di protocollo e fallimenti degli strumenti»?
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