Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Kombinovanie serverových a klientských nástrojov

Lekcia 12 z 16 Aktualizované 30. júla 2026 Vývojár
Na tejto strane
  1. Hybridné pracovné postupy
  2. Kombinovanie serverových nástrojov a funkcií
  3. Hybridný tok vykonávania
  4. Bežné vzorce kombinácií
  5. max_turns a hybridné nástroje
  6. Kontext viacerých kôl s ukladaním
  7. Kľúčové poznatky

Hybridné pracovné postupy

Skutočná sila rozhrania Responses API sa prejaví, keď v jednej požiadavke skombinuješ serverové nástroje (ktoré automaticky vykonáva xAI) a klientské nástroje (tvoje vlastné funkcie). Model tieto nástroje autonómne orchestruje a vytvára zložité pracovné postupy len pomocou niekoľkých riadkov kódu.

Kombinovanie serverových nástrojov a funkcií

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Search for the latest Ligue 1 soccer results and send a summary to my team.",
    tools=[
        {"type": "web_search"},
        {
            "type": "function",
            "name": "send_team_message",
            "description": "Sends a message to the team via Slack",
            "parameters": {
                "type": "object",
                "properties": {
                    "channel": {"type": "string"},
                    "message": {"type": "string"}
                },
                "required": ["channel", "message"]
            }
        }
    ]
)

V tomto scenári model:

  1. Automaticky spustí web_search (na strane servera), aby našiel výsledky
  2. Zakomponuje údaje do zhrnutia
  3. Zavolá send_team_message (na strane klienta), aby tvoj kód odoslal správu na Slack

Hybridný tok vykonávania

Tok sa líši v závislosti od typu nástroja:

Iba serverové nástroje

Request → [model → web_search → result → model] → Final response

Všetko sa deje na strane xAI. Priamo dostaneš konečnú odpoveď so začlenenými výsledkami.

Iba klientské nástroje

Request → [model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response

Model sa pozastaví, tvoj kód sa vykoná a následne odošleš výsledok späť.

Hybridný tok

Request → [model → web_search → result → model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response

Model najprv využije serverové nástroje (automaticky) a tvoju funkciu zavolá až vtedy, keď potrebuje tvoju infraštruktúru.

Bežné vzorce kombinácií

Vyhľadávanie + Akcia

Skombinuj web_search alebo x_search s funkciou vykonávajúcou akciu:

tools = [
    {"type": "web_search"},
    {"type": "x_search"},
    {
        "type": "function",
        "name": "create_report",
        "description": "Creates a report in the CRM",
        "parameters": {
            "type": "object",
            "properties": {
                "title": {"type": "string"},
                "content": {"type": "string"},
                "tags": {"type": "array", "items": {"type": "string"}}
            },
            "required": ["title", "content"]
        }
    }
]

Výpočet + Upozornenie

Skombinuj code_interpreter s funkciou na odoslanie upozornenia:

tools = [
    {"type": "code_interpreter"},
    {
        "type": "function",
        "name": "send_alert",
        "description": "Sends an alert if a threshold is exceeded",
        "parameters": {
            "type": "object",
            "properties": {
                "metric": {"type": "string"},
                "value": {"type": "number"},
                "threshold": {"type": "number"}
            },
            "required": ["metric", "value"]
        }
    }
]

max_turns a hybridné nástroje

Správanie parametra max_turns je v hybridnom kontexte dôležité:

  • max_turns obmedzuje počet krokov na strane servera v rámci jednej požiadavky
  • Keď model zavolá klientsku funkciu a tvoj kód vráti výsledok, začína sa nová alokácia max_turns

V praxi to znamená, že volania klienta nevyčerpávajú tvoj rozpočet serverových krokov. Model môže vykonať 3 vyhľadávania na webe, zavolať tvoju funkciu a po získaní výsledku vykonať ďalšie 3 vyhľadávania.

Kontext viacerých kôl s ukladaním

Pre zložité pracovné postupy, ktoré sa rozkladajú do viacerých interakcií, skombinuj ukladanie a reťazenie:

# Turn 1: initial search
r1 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analyze AI market trends.",
    tools=[{"type": "web_search"}, {"type": "code_interpreter"}],
    store=True,
    max_turns=5
)

# Turn 2: deepen with your internal data
r2 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Compare with our internal data.",
    tools=[{
        "type": "function",
        "name": "query_internal_db",
        "description": "Queries the internal database",
        "parameters": {"type": "object", "properties": {"query": {"type": "string"}}}
    }],
    previous_response_id=r1.id,
    store=True
)

Kľúčové poznatky

  • Kombinuj serverové nástroje a klientské funkcie v jednej požiadavke pre hybridné pracovné postupy
  • Serverové nástroje sa vykonávajú automaticky; klientské funkcie pozastavia generovanie
  • max_turns sa resetuje po každej odozve od klienta
  • Bežné vzorce: vyhľadávanie + akcia, výpočet + upozornenie, agregácia z viacerých zdrojov
  • Pre pracovné postupy s viacerými kolami používaj store: true a previous_response_id