Wywoływanie narzędzi z kodu
Wywołaj narzędzie serwera i odczytaj jego wynik.
Wywoływanie narzędzi z kodu 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.
Od wyświetlania do działania
Wykrywanie pokazało, co jest dostępne. Teraz można faktycznie wywołać narzędzie, wysłać argumenty i odczytać wynik we własnym kodzie.
Wywołanie po nazwie
Należy użyć session.call_tool() z nazwą narzędzia i słownikiem argumentów. Nazwy muszą odpowiadać elementom wykrytym w inputSchema.
result = await session.call_tool(
"add",
{"a": 2, "b": 3},
)Argumenty muszą przejść walidację
Słownik arguments powinien być zgodny z inputSchema narzędzia. Wysłanie danych o niewłaściwej strukturze spowoduje odrzucenie wywołania przez serwer.
await session.call_tool("greet", {"name": "Ada"})Odczytywanie zawartości
Wynik zawiera listę bloków content. Większość narzędzi zwraca tekst, dlatego należy odczytać tekst z pierwszego bloku.
print(result.content[0].text)Sprawdzanie błędów
Jeśli narzędzie zakończy działanie niepowodzeniem, ustawia wartość isError na true w wyniku zamiast zgłaszać wyjątek. Należy ją sprawdzić, aby klient mógł odpowiednio zareagować.
if result.isError:
print("tool failed")Także dane strukturalne
Nowsze narzędzia mogą również zwracać structuredContent — obiekt o określonym typie, przekazywany wraz z tekstem, gdy serwer definiuje schemat danych wyjściowych.
print(result.structuredContent)Przekazywanie rzeczywistych argumentów
Argumenty mogą pochodzić z programu, od użytkownika lub od modelu. Klient po prostu przekazuje je jako zwykły słownik do wskazanego narzędzia.
args = {"city": "Paris"}
await session.call_tool("weather", args)To nadal jest asynchroniczne
Podobnie jak każde wywołanie sieciowe, call_tool wymaga await. Wstrzymuje ono działanie do czasu zakończenia pracy przez serwer i powrotu wyniku.
Jedno wywołanie, jeden wynik
Każde wywołanie jest parą żądanie–odpowiedź. Sesja dopasowuje odpowiedź do żądania na podstawie identyfikatora, więc wyniki nie zostają pomieszane.
Obsługa powolnych narzędzi
Niektóre narzędzia potrzebują czasu. Solidny klient ustawia limit czasu, aby zawieszone narzędzie nie zamroziło całego programu.
To Pan/Pani koordynuje działanie
Wywoływanie narzędzi z kodu oznacza, że program decyduje o kolejności, łączy wyniki i przekształca surowe dane wyjściowe w coś użytecznego dla użytkownika.
Szybkie sprawdzenie
Jak uruchomić wykryte narzędzie z kodu klienta?
Podsumowanie: wykonywanie wywołania
Wykonał(a) Pan/Pani wywołanie narzędzi od początku do końca: wywołał(a) je po nazwie z poprawnymi argumentami, odczytał(a) bloki content i sprawdził(a) isError przed zaufaniem danym wyjściowym.
Często zadawane pytania
Czy lekcja „Wywoływanie narzędzi z kodu” jest bezpłatna?
Tak — pełny tekst „Wywoływanie narzędzi z kodu” 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 „Wywoływanie narzędzi z kodu”?
Wywołaj narzędzie serwera i odczytaj jego wynik. Ć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 „Wywoływanie narzędzi z kodu”?
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
- Otwieranie sesji klienta
- Wykrywanie narzędzi i zasobów
- Wywoływanie narzędzi z kodu
- Kierowanie wywołań narzędzi przez LLM