Łączenie narzędzi serwerowych i klienckich
Na tej stronie
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:
- Użyć
web_search, aby znaleźć informacje (automatyczne wykonanie po stronie serwera) - 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_calldo 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