Nástroje serveru a volání funkcí
Na této stránce
Kurz aktualizován 2. listopadu 2026 na základě dokumentace xAI: sleva pro dávkové zpracování činí 20 % u způsobilých textových modelů (nikoli 50 %), příklady následují REST API a oficiální
xai-sdk(client.batch.*; Batch API od xAI nepoužívá formát OpenAI, SDK od OpenAI se nepoužije) a API Responses má přednost před Chat Completions, což je u xAI zastaralý koncový bod. Zdroje: Batch API · REST Reference · Batch Pricing.
Obohacení dávek pomocí nástrojů
Požadavky v dávkovém režimu nejsou omezeny pouze na prostý text. Nástroje serveru a volání funkcí fungují i v asynchronním režimu, přičemž mezi nimi je klíčový rozdíl: první se spouští během zpracování službou xAI, zatímco druhé vrací kontrolu tobě.
Nástroje na straně serveru
Nástroje serveru se spouští během dávkového zpracování přesně jako v reálném čase: Grok zavolá nástroj, obdrží výsledek, integruje jej do svého uvažování a dávka vrátí konečnou odpověď. Fungují s API Responses.
Webové vyhledávání
{"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"}]}}
V dávkovém režimu slouží webové vyhledávání k obohacení dat: ověřování informací, sběr aktuálních faktů nebo porovnávání profilů s online zdroji.
Vyhledávání na X
Nástroj x_search dotazuje příspěvky na síti X, což je užitečné pro sledování sentimentu k danému tématu nebo značce:
{"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"}]}}
Spouštění kódu
Grok umí psát a spouštět kód Python v izolovaném prostředí. V API Responses se tento nástroj nazývá code_interpreter (SDK od xAI jej pojmenovává 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"}]}}
Spouštění kódu je relevantní pro přesné výpočty, statistiky a transformace dat, které by model z paměti zpracovával méně spolehlivě.
Vzdálené servery MCP
Nástroj mcp připojuje Groka ke vzdálenému serveru MCP, který je popsán přímo v požadavku: není nutná žádná předchozí konfigurace účtu. Parametry server_url a server_label jsou povinné; allowed_tools omezují vystavené nástroje a authorization předává serveru token. Přijímány jsou pouze přenosy Streamable HTTP a 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 jsou všechny definice nástrojů ze serveru vloženy do kontextu modelu a účtovány jako vstupní tokeny u každého požadavku v dávce: u 50 000 požadavků se omezení seznamu rychle vyplatí.
Volání funkcí na straně klienta
Volání funkcí je nástroj na straně klienta: Grok vytvoří strukturované volání funkce, ale tvůj kód jej provede. V dávce model tato volání vrací ve svých výsledcích pro offline zpracování.
Definice funkcí
V API Responses deklaruj funkci ploše, s parametry name, description a parameters na nejvyšší úrovni. Nastavení tool_choice: "required" donutí model zavolat alespoň jeden nástroj, což se hodí pro extrakci:
{"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"}}
Zpracování výsledků
Pomocí SDK přečti volání funkcí v poli tool_calls každého úspěšného výsledku:
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)
Dávkové volání funkcí je ideální pro strukturovanou extrakci: definuješ schéma dat, Grok přečte dokumenty a vytvoří volání, která následně hromadně zpracuješ.
Kombinování nástrojů
V jednom požadavku můžeš kombinovat více nástrojů serveru:
{"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 použije nástroje v pořadí, které považuje za relevantní: zde nejprve webové vyhledávání pro získání dat a následně spuštění kódu pro výpočet.
Omezení nástrojů v dávkovém režimu
- Nástroje serveru prodlužují dobu zpracování každého požadavku, a tedy i celé dávky.
- Požadavky s vyhledáváním závisí na tom, co zdroje zveřejní v době zpracování, nikoli v době odeslání.
- Volání funkcí provede pouze jednu cestu tam a zpět na požadavek: pro pokračování odešli nový dávkový požadavek obsahující konverzaci a tvé výsledky funkcí.
- Nefiltrované definice nástrojů MCP zbytečně nafukují každý požadavek.
Klíčové poznatky
- Nástroje serveru (web, X, kód, MCP) spouští xAI během zpracování prostřednictvím API Responses.
- Server MCP popiš v požadavku (
server_url,server_label) bez nutnosti předchozí konfigurace. - Volání funkcí vrací strukturovaná volání, která provedeš na straně klienta.
- Vícekolová výměna vyžaduje nový dávkový požadavek pro každé kolo.
- Omez vystavené nástroje, abys neplatil za jejich definice v každém požadavku.