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

Narzędzia serwerowe i wywoływanie funkcji

Lekcja 10 z 12 Zaktualizowano 2 listopada 2026 Programista
Na tej stronie
  1. Wzbogacanie wsadów za pomocą narzędzi
  2. Narzędzia po stronie serwera
  3. Wywoływanie funkcji po stronie klienta
  4. Łączenie narzędzi
  5. Ograniczenia narzędzi wsadowych
  6. Kluczowe wnioski

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.