Zwracanie użytecznych wyników
Zwracaj tekst, który może wykorzystać model i użytkownik.
Zwracanie użytecznych wyników to bezpłatna lekcja MCP Academy na CoddyKit. To lekcja 3 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.
Wynik wraca do modelu
Wszystko, co narzędzie zwraca, jest przekazywane AI jako kontekst, więc wpływa na następną odpowiedź modelu dla użytkownika. 🔁
Zwróć ciąg znaków
Najprostszym użytecznym wynikiem jest zwykły ciąg znaków. FastMCP opakowuje go jako treść tekstową, którą model odczytuje bezpośrednio.
@mcp.tool()
def greet(name: str) -> str:
return "Hello, " + nameNiech tekst wyjaśnia się sam
Model nie ma żadnego innego kontekstu, dlatego Twój tekst powinien wyjaśniać się sam. Zwróć „The total is 42”, a nie tylko „42”.
Liczby są zamieniane na tekst
Jeśli zwrócisz int lub float, FastMCP zamieni go za Ciebie na tekst, ale dodanie etykiety ułatwia modelowi zrozumienie wartości.
@mcp.tool()
def add(a: int, b: int) -> int:
return a + bZwracaj dane strukturalne
Zwróć dict lub list, a FastMCP zserializuje je do JSON, przekazując modelowi uporządkowane, łatwe do przetworzenia pola zamiast luźnego tekstu.
@mcp.tool()
def stats() -> dict:
return {"users": 12, "active": 9}Zwięzłe wyniki
Każdy zwrócony token zużywa budżet kontekstu modelu, dlatego ogranicz wynik do informacji, które rzeczywiście odpowiadają na prośbę. Mniej szumu oznacza trafniejsze odpowiedzi.
Formatuj z myślą o czytelności
Gdy wynik składa się z kilku części, odrobina struktury pomaga. Krótkie, opisane etykietami wiersze są lepsze niż jedno długie zdanie, które model musi rozplątywać.
Zwracaj błędy jako tekst
Gdy coś pójdzie nie tak, zwrócenie jasnego komunikatu pozwala modelowi wyjaśnić problem i spróbować go naprawić, zamiast zgadywać.
if not city:
return "Error: city is required."Nie zwracaj sekretów
Wynik trafia do modelu, a często także do użytkownika, dlatego nigdy nie umieszczaj w nim sekretów, takich jak klucze API czy hasła w postaci jawnej.
Spójna struktura pomaga
Zwracaj tę samą strukturę przy każdym wywołaniu, aby model wiedział, czego się spodziewać. Niespodzianki w strukturze prowadzą do błędnie odczytanych odpowiedzi.
Dopasuj wynik do obietnicy narzędzia
Twój wynik powinien dokładnie odpowiadać temu, co obiecuje opis. Jeśli napiszesz, że narzędzie zwraca cenę, zwróć cenę, a nie cały raport.
Szybkie sprawdzenie
Co się dzieje, gdy narzędzie zwraca pythonowy dict?
Podsumowanie
Twój wynik staje się kontekstem modelu: zwracaj jasny, zwięzły i samowyjaśniający się tekst lub JSON, zachowuj spójną strukturę i nigdy nie ujawniaj sekretów. ✅
Ucz się Python dzięki korepetycjom AI — za darmo
Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.
- Kursy
- 30
- Lekcje
- 120
Często zadawane pytania
Czy lekcja „Zwracanie użytecznych wyników” jest bezpłatna?
Tak — pełny tekst „Zwracanie użytecznych wyników” 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 „Zwracanie użytecznych wyników”?
Zwracaj tekst, który może wykorzystać model i użytkownik. Ć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 3 z 4.
Ile czasu zajmuje lekcja „Zwracanie użytecznych wyników”?
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
- Dobre nazywanie i opisywanie narzędzi
- Deklarowanie parametrów za pomocą adnotacji typów
- Zwracanie użytecznych wyników
- Narzędzie kalkulatora od początku do końca