Błędy narzędzi widoczne dla modelu
Zwracaj błędy, które AI może odczytać i obsłużyć.
Błędy narzędzi widoczne dla modelu to bezpłatna lekcja MCP Academy na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej MCP Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs MCP Academy zawiera 4 lekcji w sumie.
Błędy to po prostu dodatkowy kontekst
Gdy narzędzie zakończy działanie błędem, AI nie ulega awarii. Po prostu odczytuje błąd jako kontekst i decyduje, co zrobić dalej — tak samo jak w przypadku każdego wyniku.
Dobry błąd pozwala podjąć działanie
Formułuj błąd z myślą o odbiorcy, który może na niego zareagować. „Nie znaleziono miasta” jest lepsze niż „Exception”, ponieważ model może poprosić użytkownika o poprawienie nazwy miasta.
Zwróć ciąg znaków z błędem
Najprostszy wzorzec polega na zwróceniu jasnego ciągu znaków message, gdy coś jest nie tak, aby model dokładnie odczytał, co się nie powiodło.
@mcp.tool()
def get_user(uid: int) -> str:
if uid < 1:
return "Error: uid must be positive."Zgłoś wyjątek, aby oznaczyć błąd narzędzia
Możesz również zgłosić zwykły wyjątek języka Python. FastMCP przechwytuje go i przekazuje modelowi informację o błędzie narzędzia, zamiast doprowadzać do awarii serwera.
@mcp.tool()
def divide(a: float, b: float) -> float:
if b == 0:
raise ValueError("b cannot be zero")
return a / bisError oznacza wynik
Wewnętrznie nieudane wywołanie narzędzia zwraca zawartość z wartością isError ustawioną na true. Ta flaga informuje klienta, że wynik opisuje niepowodzenie.
Model może odzyskać sprawność
Czytelny błąd pozwala AI ponowić próbę z lepszymi danymi wejściowymi albo wyjaśnić problem użytkownikowi, zamieniając niepowodzenie w pomocny kolejny krok. 🔁
Powiedz, co się stało i dlaczego
Dobre błędy wskazują, co się nie powiodło i dlaczego. „Brak pliku: report.csv” jest znacznie bardziej przydatne dla modelu niż samo „Nie znaleziono”.
Zaproponuj rozwiązanie
Jeśli to możliwe, umieść wskazówkę dotyczącą rozwiązania w treści błędu. „Data musi mieć format YYYY-MM-DD” pozwala modelowi poprawić się już przy następnym wywołaniu.
if not iso_date:
raise ValueError("Date must be in YYYY-MM-DD format")Nigdy nie ujawniaj szczegółów wewnętrznych
Błędy docierają do modelu, a często także do użytkownika, dlatego nie umieszczaj w zwracanym komunikacie sekretów, nieprzetworzonych śladów stosu ani ciągów połączeń.
Najpierw sprawdź dane, potem zgłoś błąd
Najpierw sprawdź argumenty i zwróć błąd, zanim wykonasz właściwą pracę. Szybkie wykrywanie problemów sprawia, że działanie narzędzia jest przewidywalne i łatwe do przeanalizowania.
Błędy są częścią kontraktu
Traktuj niepowodzenia jako zaprojektowane wyniki. Narzędzie, które wymienia prawdopodobne błędy, jest dla modelu równie użyteczne jak narzędzie opisujące poprawne działanie.
Szybkie sprawdzenie
Dlaczego warto zapisywać błędy narzędzi jako jasne i czytelne komunikaty?
Podsumowanie
Błędy narzędzi są kontekstem odczytywanym przez model: formułuj je jasno, określaj co się stało i dlaczego, sugeruj rozwiązanie i nigdy nie ujawniaj szczegółów wewnętrznych. ✅
Często zadawane pytania
Czy lekcja „Błędy narzędzi widoczne dla modelu” jest bezpłatna?
Tak — pełny tekst „Błędy narzędzi widoczne dla modelu” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu MCP Academy, przejdź na CoddyKit PRO. Kurs MCP Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Błędy narzędzi widoczne dla modelu”?
Zwracaj błędy, które AI może odczytać i obsłużyć. Ćwiczysz MCP Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć MCP Academy?
Nie wymagamy żadnego doświadczenia. MCP Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.
Ile czasu zajmuje lekcja „Błędy narzędzi widoczne dla modelu”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji MCP Academy?
Tak. Każda lekcja MCP Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Błędy narzędzi widoczne dla modelu
- Błędy protokołu a awarie narzędzi
- Sprawdzanie danych wejściowych przed działaniem
- Bezpieczne kończenie bez zawieszania