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

Narzędzia wbudowane w API Responses

Lekcja 9 z 16 Zaktualizowano 30 lipca 2026 Programista
Na tej stronie
  1. Dodawanie możliwości do modelu
  2. Cztery typy narzędzi
  3. Łączenie wielu narzędzi
  4. Narzędzia po stronie serwera a po stronie klienta
  5. Kluczowe wnioski

Dodawanie możliwości do modelu

Modele Grok nie ograniczają się tylko do generowania tekstu. Dzięki parametrowi tools możesz udostępnić im narzędzia, które znacznie rozszerzają ich możliwości: wyszukiwanie w internecie w czasie rzeczywistym, przeszukiwanie serwisu X (dawniej Twitter), wykonywanie kodu Python oraz Twoje własne funkcje niestandardowe.

web_search
Wyszukiwanie w sieci w czasie rzeczywistym
x_search
Wyszukiwanie w serwisie X
code
Interpreter Pythona
function
Funkcje niestandardowe

Cztery typy narzędzi

Pozwala modelowi wyszukiwać informacje w internecie w czasie rzeczywistym:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What's the latest news on AI in Europe?",
  "tools": [{"type": "web_search"}]
}

Model automatycznie decyduje, kiedy przeprowadzić wyszukiwanie. Wyniki są integrowane z jego odpowiedzią wraz z cytowaniami.

Wyszukuje wpisy w serwisie X (dawniej Twitter):

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What is the tech community saying about the latest iPhone?",
  "tools": [{"type": "x_search"}]
}

Narzędzie to jest szczególnie przydatne do wychwytywania opinii publicznej, trendów i reakcji na bieżąco.

code_interpreter

Wykonuje kod Python po stronie serwera w celu przeprowadzenia obliczeń, analizy danych lub tworzenia wykresów:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Calculate the mean and standard deviation of these values: 12, 15, 18, 22, 9, 31",
  "tools": [{"type": "code_interpreter"}]
}

Model pisze kod w języku Python, wykonuje go na serwerach xAI i integruje wyniki ze swoją odpowiedzią.

function

Twoje własne funkcje, które model może wywołać. Model generuje argumenty, ale Twój kod wykonuje funkcję:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What's the weather in Paris?",
  "tools": [{
    "type": "function",
    "name": "get_weather",
    "description": "Retrieves the weather for a given city",
    "parameters": {
      "type": "object",
      "properties": {
        "city": {"type": "string", "description": "City name"},
        "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
      },
      "required": ["city"]
    }
  }]
}

Łączenie wielu narzędzi

W jednym żądaniu możesz przekazać do 128 narzędzi. Model wybiera to (lub te), które najlepiej pasują:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Search for the latest Ligue 1 results and create a scoreboard.",
  "tools": [
    {"type": "web_search"},
    {"type": "code_interpreter"}
  ]
}

W tym przykładzie model może najpierw użyć web_search, aby znaleźć wyniki, a następnie code_interpreter, aby sformatować je w tabelę.

Narzędzia po stronie serwera a po stronie klienta

Rozróżnienie to jest fundamentalne:

  • Narzędzia po stronie serwera (web_search, x_search, code_interpreter): Automatycznie wykonywane przez serwery xAI. Nie musisz nic robić – model uruchamia wyszukiwanie lub kod, pobiera wynik i integruje go ze swoją odpowiedzią.

  • Narzędzia po stronie klienta (function): Model generuje wywołanie funkcji z argumentami, a następnie wstrzymuje generowanie. Twój kod wykonuje funkcję, a Ty odsyłasz wynik w nowym żądaniu.

Różnica ta ma bezpośredni wpływ na architekturę Twojej aplikacji, co zobaczysz w kolejnych lekcjach.

Kluczowe wnioski

  • Cztery typy narzędzi: web_search, x_search, code_interpreter, function
  • Pierwsze trzy działają po stronie serwera – nie wymagają żadnej infrastruktury z Twojej strony
  • Narzędzia typu function działają po stronie klienta – Twój kod obsługuje ich wykonanie
  • Możesz łączyć do 128 narzędzi w jednym żądaniu
  • Model automatycznie decyduje, kiedy i których narzędzi użyć