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

Łączenie narzędzi serwerowych i klienckich

Lekcja 8 z 14 Zaktualizowano 29 lipca 2026 Programista
Na tej stronie
  1. Dwie kategorie narzędzi na jednej platformie
  2. Łączenie obu typów w jednym żądaniu
  3. Przepływ hybrydowy
  4. Przykłady z rzeczywistych zastosowań
  5. Rozliczanie narzędzi serwerowych
  6. Kluczowe wnioski

Dwie kategorie narzędzi na jednej platformie

API Grok rozróżnia dwa zasadniczo różne typy narzędzi w zależności od sposobu ich wykonywania. Zrozumienie tej różnicy jest kluczowe dla projektowania solidnych architektur.

Wbudowane narzędzia (strona serwera)

xAI wykonuje te narzędzia automatycznie na swoich serwerach. Nie musisz niczym zarządzać – brak wykonania lokalnego, brak konieczności przekazywania wyników. Model wywołuje je i otrzymuje wyniki bezpośrednio.

Narzędzie Identyfikator Opis
Web Search web_search Wyszukiwanie w sieci w czasie rzeczywistym
X Search x_search Wyszukiwanie na platformie X/Twitter
Code Interpreter code_interpreter Uruchamianie kodu Python w piaskownicy
Collections Search collections_search Przeszukiwanie przesłanych przez Ciebie dokumentów
Remote MCP mcp Połączenie z zewnętrznymi serwerami MCP

Funkcje niestandardowe (strona klienta)

Są to Twoje własne funkcje, definiowane poprzez wywoływanie funkcji (function calling). Model zwraca obiekt tool_call, Twój kod wykonuje funkcję, a Ty odsyłasz wynik. To mechanizm, którego nauczyłeś się w poprzednich lekcjach.

Łączenie obu typów w jednym żądaniu

Siła API Grok polega na możliwości mieszania narzędzi serwerowych i klienckich w ramach jednego żądania:

tools = [
    # Narzędzie serwerowe — wykonywane automatycznie przez xAI
    {"type": "web_search"},

    # Narzędzie klienckie — wykonywane przez Twój kod
    {
        "type": "function",
        "function": {
            "name": "save_to_database",
            "description": "Zapisz informacje w bazie danych",
            "parameters": {
                "type": "object",
                "properties": {
                    "key": {"type": "string"},
                    "value": {"type": "string"}
                },
                "required": ["key", "value"]
            }
        }
    }
]

Gdy model otrzyma takie żądanie, może:

  1. Użyć web_search, aby znaleźć informacje (automatyczne wykonanie po stronie serwera)
  2. Wywołać save_to_database, aby zapisać wynik (zwrot do klienta)

Przepływ hybrydowy

Zachowanie różni się w zależności od typu narzędzia:

  • Narzędzie serwerowe: model wywołuje narzędzie, xAI je wykonuje, wynik jest automatycznie integrowany, model kontynuuje pracę
  • Narzędzie klienckie: model zwraca tool_call do klienta, wykonanie zostaje wstrzymane i wznawia się dopiero po odesłaniu wyniku

Gdy model używa obu typów w tym samym żądaniu, narzędzia serwerowe wykonują się najpierw (bez Twojej ingerencji). Następnie, jeśli model potrzebuje również narzędzia klienckiego, zwraca Ci obiekt tool_call, mając już wyniki z narzędzi serwerowych zintegrowane w swoim kontekście.

Przykłady z rzeczywistych zastosowań

Wyszukiwanie w sieci + logika biznesowa

# Użytkownik pyta: „Znajdź cenę Bitcoina i ją zapisz“
# Model:
# 1. Wywołuje web_search, aby znaleźć cenę (strona serwera, automatycznie)
# 2. Wywołuje save_price(symbol="BTC", price=68432) (strona klienta)

Wyszukiwanie na X + powiadomienie

# „Powiadom mnie o tweetach dotyczących naszego produktu od wczoraj“
# Model:
# 1. Wywołuje x_search, aby znaleźć tweety (strona serwera)
# 2. Wywołuje send_notification(count=12, summary="...") (strona klienta)

Interpreter kodu + magazynowanie

# „Oblicz średnią z tych danych i zapisz wynik“
# Model:
# 1. Wywołuje code_interpreter do wykonania obliczeń (strona serwera)
# 2. Wywołuje save_result(key="avg", value="42.5") (strona klienta)

Rozliczanie narzędzi serwerowych

Wbudowane narzędzia są rozliczane na dwa sposoby:

  • Tokeny: standardowe zużycie (wejście + wyjście)
  • Wywołania: stały koszt za każde wywołanie narzędzia

Model może wywołać wiele narzędzi serwerowych w ramach jednego żądania – koszty się sumują. Miej to na uwadze, gdy włączasz web_search: model może przeprowadzić wiele wyszukiwań, aby doprecyzować wyniki.

Kluczowe wnioski

  • Dwa typy narzędzi: serwerowe (automatyczne) i klienckie (wywoływanie funkcji)
  • Narzędzia serwerowe (web_search, x_search, code_interpreter) wykonują się bez Twojej ingerencji
  • Możesz mieszać oba typy w jednym żądaniu
  • Narzędzia serwerowe wykonują się jako pierwsze, następnie model może wywołać Twoje funkcje
  • Każde wywołanie narzędzia serwerowego jest płatne (tokeny + koszt za wywołanie)
  • Cytaty są generowane automatycznie dla danych pochodzących z narzędzi serwerowych