Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Nástroje serveru a volání funkcí

Lekce 10 z 12 Aktualizováno 2. listopadu 2026 Vývojář
Na této stránce
  1. Obohacení dávek pomocí nástrojů
  2. Nástroje na straně serveru
  3. Vzdálené servery MCP
  4. Volání funkcí na straně klienta
  5. Kombinování nástrojů
  6. Omezení nástrojů v dávkovém režimu
  7. Klíčové poznatky

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.