Værktøjsfejl, som modellen kan se
Returnér fejl, som AI kan læse og håndtere.
Værktøjsfejl, som modellen kan se er en gratis MCP Academy-lektion på CoddyKit. Dette er lektion 1 af 4. Du kan læse alle 3 lektioner i dette læringsspor gratis i deres fulde længde — derefter låser CoddyKit PRO alle lektioner op samt praktiske øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Den er en del af læringsforløbet i MCP Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. MCP Academy-kurset indeholder 4 lektioner i alt.
Fejl er blot mere kontekst
Når et værktøj fejler, går AI'en ikke ned. Den læser blot din fejl som kontekst og beslutter, hvad den skal gøre derefter, ligesom med ethvert resultat.
En god fejl kan bruges til handling
Skriv fejlen til en læser, der kan handle på den. By ikke fundet er bedre end Exception, fordi modellen kan bede brugeren om at rette byen.
Returnér en fejlstreng
Det enkleste mønster er at returnere en tydelig streng med en meddelelse, når noget går galt, så modellen kan se præcis, hvad der fejlede.
@mcp.tool()
def get_user(uid: int) -> str:
if uid < 1:
return "Error: uid must be positive."Hæv en undtagelse for at markere en værktøjsfejl
Du kan også hæve en almindelig Python-undtagelse. FastMCP fanger den og rapporterer en værktøjsfejl tilbage til modellen, ikke et servernedbrud.
@mcp.tool()
def divide(a: float, b: float) -> float:
if b == 0:
raise ValueError("b cannot be zero")
return a / bisError markerer resultatet
Internt returnerer et mislykket kald til et værktøj indhold med isError sat til true. Dette flag fortæller klienten, at resultatet beskriver en fejl.
Modellen kan komme videre
En læsbar fejl lader AI'en prøve igen med bedre input eller forklare problemet for brugeren, så en fejl bliver til et nyttigt næste skridt. 🔁
Fortæl hvad og hvorfor
Gode fejl fortæller, hvad der fejlede, og hvorfor. Fil mangler: report.csv er langt mere nyttigt for modellen end et simpelt Ikke fundet.
Foreslå en løsning
Når du kan, så antyd løsningen i fejlen. Datoen skal være ÅÅÅÅ-MM-DD lader modellen rette sig selv ved det næste kald.
if not iso_date:
raise ValueError("Date must be in YYYY-MM-DD format")Læk aldrig interne oplysninger
Fejl når frem til modellen og ofte også brugeren, så hold hemmeligheder, rå stacktraces og forbindelsesstrenge ude af den meddelelse, du returnerer.
Validér, og rapportér fejl tidligt
Kontrollér argumenterne først, og returnér fejlen, før du udfører det egentlige arbejde. Hurtige fejl gør dit værktøj forudsigeligt og nemt at gennemskue.
Fejl er en del af kontrakten
Betragt fejl som designet output. Et værktøj, der navngiver sine sandsynlige fejl, er lige så nyttigt for modellen som et, der dokumenterer sin succes.
Hurtigt tjek
Hvorfor skal værktøjsfejl skrives som tydelige, læsbare meddelelser?
Opsummering
Værktøjsfejl er kontekst, som modellen læser: Gør dem tydelige, fortæl hvad og hvorfor, foreslå en løsning, og læk aldrig interne oplysninger. ✅
Lær Python med en AI-underviser — gratis
Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.
- Kurser
- 30
- Lektioner
- 120
Ofte stillede spørgsmål
Er lektionen “Værktøjsfejl, som modellen kan se” gratis?
Ja — alle 3 lektioner i læringssporet MCP Academy, inklusive “Værktøjsfejl, som modellen kan se”, kan læses gratis i deres fulde længde her på webstedet. Derefter låser CoddyKit PRO alle lektioner op samt interaktive øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. MCP Academy-kurset indeholder 4 lektioner i alt.
Hvad lærer jeg i “Værktøjsfejl, som modellen kan se”?
Returnér fejl, som AI kan læse og håndtere. Du øver dig i MCP Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.
Skal jeg have erfaring for at begynde på MCP Academy?
Der kræves ingen tidligere erfaring. MCP Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 1 af 4.
Hvor lang tid tager lektionen “Værktøjsfejl, som modellen kan se”?
De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.
Kan jeg skrive og køre kode i denne MCP Academy-lektion?
Ja. Alle MCP Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.
Alle lektioner i dette kursus
- Værktøjsfejl, som modellen kan se
- Protokolfejl kontra værktøjsfejl
- Validér input, før De handler
- Fejl sikkert, og hæng aldrig