Dwie kategorie narzędzi Grok
Na tej stronie
Poznaj ekosystem narzędzi API Grok
API Grok robi więcej niż tylko generowanie tekstu. Udostępnia zestaw narzędzi, które pozwalają modelowi взаимодействовать ze światem zewnętrznym: wyszukiwanie informacji w czasie rzeczywistym, analiza danych w mediach społecznościowych czy uruchamianie kodu Python. Aby w pełni wykorzystać te możliwości, musisz zrozumieć, jak są one zorganizowane.
API Grok wyróżnia dwie podstawowe kategorie narzędzi. To rozróżnienie decyduje o tym, kto wykonuje narzędzie, gdzie odbywa się przetwarzanie i czym musisz zarządzać jako programista.
Wbudowane narzędzia — strona serwera
Wbudowane narzędzia działają bezpośrednio na serwerach xAI. Gdy model zdecyduje się użyć jednego z nich, wykonanie jest automatyczne i przezroczyste. Nie musisz zarządzać żadną infrastrukturą ani przetwarzać wyników pośrednich.
Oto pięć dostępnych wbudowanych narzędzi:
- Web Search (
web_search): Wyszukiwanie w sieci w czasie rzeczywistym, z filtrowaniem domen i automatycznym cytowaniem źródeł - X Search (
x_search): Wyszukiwanie na platformie X/Twitter, z filtrowaniem według konta i daty - Code Execution (
code_interpreter/code_execution): Wykonywanie kodu Python w bezpiecznym, izolowanym środowisku (sandbox) - Collections Search (
collections_search/file_search): Wyszukiwanie w dokumentach, które wcześniej przesłałeś - Remote MCP (
mcp): Łączenie się z zewnętrznymi serwerami MCP (Model Context Protocol)
Aby włączyć wbudowane narzędzie, wystarczy dodać je do tablicy tools w swoim żądaniu:
{
"tools": [{"type": "web_search"}]
}
Wywoływanie funkcji — strona klienta
Wywoływanie funkcji (Function Calling) działa inaczej. Definiujesz własne funkcje, które model może wywołać. Jednak w przeciwieństwie do wbudowanych narzędzi, to Twój kod po stronie klienta wykonuje funkcję i zwraca wynik modelowi.
Przepływ wygląda następująco:
- Opisujesz swoje funkcje (nazwa, parametry, opis) w żądaniu
- Model analizuje zapytanie użytkownika
- Jeśli stwierdzi, że funkcja jest potrzebna, zwraca wywołanie funkcji z argumentami
- Twój kod wykonuje funkcję (wywołanie API, zapytanie do bazy danych, obliczenia…)
- Wysyłasz wynik z powrotem do modelu
- Model formułuje swoją ostateczną odpowiedź
Podejście to daje Ci pełną kontrolę: Ty decydujesz, co robią Twoje funkcje, jakimi danymi operują i jak łączą się z Twoją infrastrukturą.
Kiedy używać której kategorii
Wbudowane narzędzia są idealne, gdy potrzebujesz dostępu do informacji w czasie rzeczywistym (sieć, media społecznościowe) lub musisz przeprowadzić obliczenia bez zarządzania infrastrukturą. Wywoływanie funkcji jest preferowane, gdy potrzebujesz współdziałać z własnymi systemami: wewnętrznymi bazami danych, biznesowymi API lub dowolną usługą specyficzną dla Twojej aplikacji.
Możesz łączyć obie kategorie w jednym żądaniu. Na przykład, możesz włączyć Web Search, definiując jednocześnie własną funkcję, która zapisuje wyniki w Twojej bazie danych.
Kluczowe wnioski
- API Grok oferuje dwie kategorie narzędzi: wbudowane narzędzia (wykonywane przez xAI) oraz wywoływanie funkcji (wykonywane przez Twój kod)
- Wbudowane narzędzia nie wymagają żadnej infrastruktury po stronie klienta
- Wywoływanie funkcji oferuje pełną kontrolę, ale wymaga więcej pracy programistycznej
- Obie kategorie można łączyć w jednym żądaniu
- Ten kurs skupia się na trzech głównych wbudowanych narzędziach: Web Search, X Search oraz Code Execution