Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Kombiniranje poslužiteljskih i klijentskih alata

Lekcija 12 od 16 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Hibridni radni tijekovi
  2. Kombiniranje poslužiteljskih alata i funkcija
  3. Hibridni tijek izvršavanja
  4. Uobičajeni obrasci kombiniranja
  5. max_turns i hibridni alati
  6. Kontekst s više okreta uz pohranu
  7. Ključne točke

Hibridni radni tijekovi

Prava snaga API-ja za odgovore (Responses API) dolazi do izražaja kada u jednom zahtjevu kombiniraš poslužiteljske alate (koje automatski izvršava xAI) i klijentske alate (tvoje prilagođene funkcije). Model samostalno upravlja tim alatima, stvarajući složene radne tijekove uz samo nekoliko redaka koda.

Kombiniranje poslužiteljskih alata i funkcija

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"]
            }
        }
    ]
)

U ovom scenariju model:

  1. Automatski pokreće web_search (na strani poslužitelja) kako bi pronašao rezultate
  2. Uključuje podatke u sažetak
  3. Poziva send_team_message (na strani klijenta) kako bi tvoj kod poslao poruku na Slack

Hibridni tijek izvršavanja

Tijek se razlikuje ovisno o vrsti alata:

Samo poslužiteljski alati

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

Sve se događa na strani xAI-a. Izravno primaš konačni odgovor s integriranim rezultatima.

Samo klijentski alati

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

Model se pauzira, tvoj kod izvršava funkciju, a zatim šalješ rezultat natrag.

Hibridni tijek

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

Model prvo koristi poslužiteljske alate (automatski), a zatim poziva tvoju funkciju kada mu je potrebna tvoja infrastruktura.

Uobičajeni obrasci kombiniranja

Pretraživanje + Radnja

Kombiniraj web_search ili x_search s funkcijom za radnju:

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"]
        }
    }
]

Izračun + Obavijest

Kombiniraj code_interpreter s funkcijom za obavijest:

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 i hibridni alati

Ponašanje parametra max_turns ključno je u hibridnom kontekstu:

  • max_turns ograničava poslužiteljske okrete unutar jednog zahtjeva
  • Kada model pozove klijentsku funkciju, a tvoj kod vrati rezultat, započinje nova raspodjela vrijednosti max_turns

U praksi to znači da klijentski pozivi ne troše tvoj budžet poslužiteljskih okreta. Model može izvršiti 3 web pretraživanja, pozvati tvoju funkciju, a zatim izvršiti još 3 pretraživanja nakon primitka rezultata.

Kontekst s više okreta uz pohranu

Za složene radne tijekove koji se protežu kroz više interakcija, kombiniraj pohranu i lančanje:

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

Ključne točke

  • Kombiniraj poslužiteljske alate i klijentske funkcije u jednom zahtjevu za hibridne radne tijekove
  • Poslužiteljski alati izvršavaju se automatski; klijentske funkcije pauziraju generiranje
  • max_turns se resetira nakon svakog povratnog poziva klijentu
  • Uobičajeni obrasci: pretraživanje + radnja, izračun + obavijest, agregacija iz više izvora
  • Koristi store: true i previous_response_id za radne tijekove s više okreta