Narzędzia serwerowe i wywoływanie funkcji
Na tej stronie
Kurs zaktualizowany 2 listopada 2026 r. na podstawie dokumentacji xAI: rabat na wsady (batch) wynosi 20% dla kwalifikujących się modeli tekstowych (a nie 50%), przykłady opierają się na interfejsie REST oraz oficjalnym
xai-sdk(client.batch.*; API wsadowe xAI nie używa formatu OpenAI, więc SDK OpenAI nie ma zastosowania), a API Responses ma pierwszeństwo przed Chat Completions, które w xAI są punktem końcowym przestarzałym. Źródła: Batch API · REST Reference · Batch Pricing.
Wzbogacanie wsadów za pomocą narzędzi
Żądania wsadowe nie ograniczają się do surowego tekstu. Narzędzia serwerowe i wywoływanie funkcji działają również w trybie asynchronicznym, z kluczową różnicą: pierwsze są uruchamiane podczas przetwarzania przez xAI, podczas gdy drugie zwracają kontrolę Tobie.
Narzędzia po stronie serwera
Narzędzia serwerowe działają podczas przetwarzania wsadu, dokładnie tak jak w czasie rzeczywistym: Grok wywołuje narzędzie, otrzymuje wynik, integruje go ze swoim rozumowaniem, a wsad zwraca ostateczną odpowiedź. Współpracują one z API Responses.
Wyszukiwanie w sieci
{"custom_id": "news-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What are the latest developments in quantum computing?"}], "tools": [{"type": "web_search"}]}}
W trybie wsadowym wyszukiwanie w sieci służy wzbogacaniu danych: weryfikacji informacji, zbieraniu najnowszych faktów czy porównywaniu profili ze źródłami online.
Wyszukiwanie w X
Narzędzie x_search odpytuje posty na platformie X, co jest przydatne do śledzenia nastrojów dotyczących danego tematu lub marki:
{"custom_id": "x-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What is the dominant sentiment on X regarding this product launch?"}], "tools": [{"type": "x_search"}]}}
Wykonywanie kodu
Grok potrafi pisać i wykonywać kod Python w izolowanym środowisku. W API Responses narzędzie to nazywa się code_interpreter (w SDK xAI nosi nazwę code_execution):
{"custom_id": "calc-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Calculate the 3-point moving average for this data: [12, 15, 18, 14, 22, 19, 25, 28, 30, 27]"}], "tools": [{"type": "code_interpreter"}]}}
Wykonywanie kodu jest istotne w przypadku precyzyjnych obliczeń, statystyk i transformacji danych, które model obsługiwałby mniej wiarygodnie, polegając wyłącznie na swojej pamięci.
Zdalne serwery MCP
Narzędzie mcp łączy Groka ze zdalnym serwerem MCP, opisanym bezpośrednio w żądaniu: nie wymaga to wcześniejszej konfiguracji konta. Parametry server_url i server_label są obowiązkowe; allowed_tools ogranicza udostępniane narzędzia, a authorization przekazuje token do serwera. Akceptowane są tylko transporty Streamable HTTP i SSE.
{"custom_id": "mcp-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What does the xai-sdk-python repository do?"}], "tools": [{"type": "mcp", "server_label": "deepwiki", "server_url": "https://mcp.deepwiki.com/mcp"}]}}
Bez parametru allowed_tools wszystkie definicje narzędzi z serwera są wstrzykiwane do kontekstu modelu i rozliczane jako tokeny wejściowe w każdym żądaniu wsadowym: przy 50 000 żądań ograniczenie tej listy szybko się opłaca.
Wywoływanie funkcji po stronie klienta
Wywoływanie funkcji to narzędzie po stronie klienta: Grok generuje strukturalne wywołanie funkcji, ale to Twój kod je wykonuje. W trybie wsadowym model zwraca te wywołania w swoich wynikach do przetworzenia offline.
Definicje funkcji
W API Responses zadeklaruj funkcję płasko, umieszczając name, description i parameters na najwyższym poziomie. Ustawienie tool_choice: "required" wymusza na modelu wywołanie co najmniej jednego narzędzia, co jest odpowiednie przy ekstrakcji:
{"custom_id": "extract-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Extract the contact: Jean Dupont, 01 23 45 67 89, [email protected]"}], "tools": [{"type": "function", "name": "save_contact", "description": "Saves a contact extracted from text", "parameters": {"type": "object", "properties": {"name": {"type": "string"}, "phone": {"type": "string"}, "email": {"type": "string"}}, "required": ["name"]}}], "tool_choice": "required"}}
Przetwarzanie wyników
Korzystając z SDK, odczytuj wywołania funkcji w polu tool_calls każdego pomyślnego wyniku:
import json
for r in page.succeeded:
for call in r.response.tool_calls:
if call.function.name == "save_contact":
contact = json.loads(call.function.arguments)
save_to_database(r.batch_request_id, contact)
Wsadowe wywoływanie funkcji idealnie nadaje się do strukturalnej ekstrakcji: definiujesz schemat danych, Grok odczytuje dokumenty i generuje wywołania, a Ty przetwarzasz je hurtowo.
Łączenie narzędzi
Możesz łączyć wiele narzędzi serwerowych w jednym żądaniu:
{"custom_id": "multi-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Find the Bitcoin closing price for the last seven days and calculate its change"}], "tools": [{"type": "web_search"}, {"type": "code_interpreter"}]}}
Grok używa narzędzi w kolejności, jaką uzna za stosowną: tutaj najpierw wyszukiwanie w sieci w celu uzyskania danych, a następnie wykonanie kodu do przeprowadzenia obliczeń.
Ograniczenia narzędzi wsadowych
- Narzędzia serwerowe wydłużają czas przetwarzania każdego żądania, a tym samym całego wsadu.
- Żądania wykorzystujące wyszukiwanie zależą od tego, co źródła publikują w momencie przetwarzania, a nie w momencie zgłoszenia.
- Wywoływanie funkcji wykonuje tylko jedną rundę komunikacji na żądanie: aby kontynuować, musisz przesłać nowe żądanie wsadowe zawierające konwersację i wyniki działania Twoich funkcji.
- Niefiltrowane definicje narzędzi MCP nadmiernie rozdmuchują każde żądanie.
Kluczowe wnioski
- Narzędzia serwerowe (sieć, X, kod, MCP) są uruchamiane przez xAI podczas przetwarzania za pośrednictwem API Responses.
- Serwer MCP opisujesz w żądaniu (
server_url,server_label) bez konieczności wcześniejszej konfiguracji. - Wywoływanie funkcji zwraca strukturalne wywołania, które wykonujesz po stronie klienta.
- Wymiana wieloturkowa wymaga nowego żądania wsadowego dla każdej tury.
- Ograniczaj udostępniane narzędzia, aby uniknąć płacenia za ich definicje w każdym żądaniu.