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

Kombinování serverových a klientských nástrojů

Lekce 12 z 16 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Hybridní pracovní postupy
  2. Kombinování serverových nástrojů a funkcí
  3. Hybridní průběh provádění
  4. Běžné kombinační vzory
  5. max_turns a hybridní nástroje
  6. Kontext více kol s ukládáním
  7. Klíčové poznatky

Hybridní pracovní postupy

Skutečná síla Responses API se projeví, když v jediném požadavku zkombinuješ serverové nástroje (spouštěné automaticky systémem xAI) a klientské nástroje (tvé vlastní funkce). Model tyto nástroje autonomně orchestruje a vytváří složité pracovní postupy pomocí jen několika řádků kódu.

Kombinování serverových nástrojů a funkcí

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 scénáři model:

  1. Automaticky spustí web_search (na straně serveru) pro vyhledání výsledků
  2. Zahrne data do shrnutí
  3. Zavolá send_team_message (na straně klienta), aby tvůj kód odeslal zprávu na Slack

Hybridní průběh provádění

Průběh se liší v závislosti na typu nástroje:

Pouze serverové nástroje

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

Vše se děje na straně xAI. Přímo obdržíš konečnou odpověď s integrovanými výsledky.

Pouze klientské nástroje

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

Model se pozastaví, tvůj kód se provede a poté odešleš výsledek zpět.

Hybridní průběh

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

Model nejprve využije serverové nástroje (automaticky) a následně zavolá tvou funkci, když potřebuje tvou infrastrukturu.

Běžné kombinační vzory

Vyhledávání + Akce

Zkombinuj web_search nebo x_search s akční funkcí:

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 + Oznámení

Zkombinuj code_interpreter s oznamovací funkcí:

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

Chování max_turns je v hybridním kontextu klíčové:

  • max_turns omezuje počet serverových kol v rámci jediného požadavku
  • Když model zavolá klientskou funkci a tvůj kód vrátí výsledek, začne nová alokace max_turns

V praxi to znamená, že klientská volání nevyčerpávají tvůj rozpočet serverových kol. Model může provést 3 webová vyhledávání, zavolat tvou funkci a po obdržení výsledku provést další 3 vyhledávání.

Kontext více kol s ukládáním

Pro složité pracovní postupy přesahující více interakcí kombinuj ukládání a řetězení:

# 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
)

Klíčové poznatky

  • Kombinuj serverové nástroje a klientské funkce v jediném požadavku pro hybridní pracovní postupy
  • Serverové nástroje se provádějí automaticky; klientské funkce pozastaví generování
  • max_turns se resetuje po každé往返 komunikaci s klientem
  • Běžné vzory: vyhledávání + akce, výpočet + oznámení, agregace z více zdrojů
  • Pro pracovní postupy s více koly použij store: true a previous_response_id