Przejdź do głównej treści
Polski— Wybierz język
Menu

Dwie kategorie narzędzi Grok

Lekcja 1 z 16 Zaktualizowano 30 lipca 2026 Programista
Na tej stronie
  1. Poznaj ekosystem narzędzi API Grok
  2. Wbudowane narzędzia — strona serwera
  3. Wywoływanie funkcji — strona klienta
  4. Kiedy używać której kategorii
  5. Kluczowe wnioski

Poznaj ekosystem narzędzi API Grok

Przegląd narzędzi w dokumentacji 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.

🔍
Web Search
Wyszukiwanie w sieci w czasie rzeczywistym
𝕏
X Search
Wyszukiwanie na platformie X/Twitter
🐍
Code Execution
Izolowane środowisko Python (sandbox)
📁
Collections Search
Wyszukiwanie w Twoich dokumentach
🔌
Remote MCP
Zewnętrzne serwery MCP

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:

  1. Opisujesz swoje funkcje (nazwa, parametry, opis) w żądaniu
  2. Model analizuje zapytanie użytkownika
  3. Jeśli stwierdzi, że funkcja jest potrzebna, zwraca wywołanie funkcji z argumentami
  4. Twój kod wykonuje funkcję (wywołanie API, zapytanie do bazy danych, obliczenia…)
  5. Wysyłasz wynik z powrotem do modelu
  6. 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