Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Serveri ja kliendi tööriistade kombineerimine

Õppetund 12 / 16 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. Hübriidsed töövood
  2. Serveritööriistade ja funktsioonide ühendamine
  3. Hübriidse täitmise voog
  4. Levinud kombinatsioonimustrid
  5. max_turns ja hübriidsed tööriistad
  6. Mitme pöördega kontekst salvestusega
  7. Peamised punktid

Hübriidsed töövood

Responses API tegelik jõudus avaldub siis, kui kombineerid ühes päringus serveritööriistad (mida xAI automaatselt käivitab) ja klienditööriistad (sinu kohandatud funktsioonid). Mudel orkestreerib neid tööriistu autonoomselt, luues keerukaid töövood vaid paari koodireaga.

Serveritööriistade ja funktsioonide ühendamine

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Otsi värskeimad Ligue 1 jalgpallitulemused ja saada kokkuvõte mu meeskonnale.",
    tools=[
        {"type": "web_search"},
        {
            "type": "function",
            "name": "send_team_message",
            "description": "Saadab sõnumi meeskonnale Slacki kaudu",
            "parameters": {
                "type": "object",
                "properties": {
                    "channel": {"type": "string"},
                    "message": {"type": "string"}
                },
                "required": ["channel", "message"]
            }
        }
    ]
)

Selles stsenaariumis mudel:

  1. Käivitab automaatselt web_search (serveripoolselt), et leida tulemused
  2. Lisab andmed kokkuvõttesse
  3. Kutsub välja send_team_message (kliendipoolselt), nii et sinu kood saadab Slacki sõnumi

Hübriidse täitmise voog

Voog erineb sõltuvalt tööriista tüübist:

Ainult serveritööriistad

Päring → [mudel → web_search → tulemus → mudel] → Lõppvastus

Kõik toimub xAI poolel. Saad lõppvastuse otse, kus tulemused on juba integreeritud.

Ainult klienditööriistad

Päring → [mudel → function_call] → PAUS
Sinu kood käivitab funktsiooni
Tulemus → [mudel] → Lõppvastus

Mudel teeb pausi, sinu kood käivitub ja seejärel saadad tulemuse tagasi.

Hübriidne voog

Päring → [mudel → web_search → tulemus → mudel → function_call] → PAUS
Sinu kood käivitab funktsiooni
Tulemus → [mudel] → Lõppvastus

Mudel kasutab esmalt serveritööriistu (automaatselt) ja kutsub sinu funktsiooni välja alles siis, kui tal on vaja sinu taristut.

Levinud kombinatsioonimustrid

Otsing + tegevus

Kombineeri web_search või x_search tegevusfunktsiooniga:

tools = [
    {"type": "web_search"},
    {"type": "x_search"},
    {
        "type": "function",
        "name": "create_report",
        "description": "Loob aruande CRM-is",
        "parameters": {
            "type": "object",
            "properties": {
                "title": {"type": "string"},
                "content": {"type": "string"},
                "tags": {"type": "array", "items": {"type": "string"}}
            },
            "required": ["title", "content"]
        }
    }
]

Arvutus + teavitus

Kombineeri code_interpreter teavitamisfunktsiooniga:

tools = [
    {"type": "code_interpreter"},
    {
        "type": "function",
        "name": "send_alert",
        "description": "Saadab hoiatuse, kui lävend on ületatud",
        "parameters": {
            "type": "object",
            "properties": {
                "metric": {"type": "string"},
                "value": {"type": "number"},
                "threshold": {"type": "number"}
            },
            "required": ["metric", "value"]
        }
    }
]

max_turns ja hübriidsed tööriistad

max_turns käitumine on hübriidses kontekstis oluline:

  • max_turns piirab serveripoolseid pöördeid ühe päringu sees
  • Kui mudel kutsub kliendifunktsiooni ja sinu kood tagastab tulemuse, algab max_turns uus eraldamine

Praktikas tähendab see, et kliendipoolsed väljakutsed ei kuluta ära sinu serveripoolset pöörete eelarvet. Mudel saab teha 3 veebiotsingut, kutsuda sinu funktsiooni ja seejärel pärast tulemuse saamist teha veel 3 otsingut.

Mitme pöördega kontekst salvestusega

Keerukate, mitut interaktsiooni hõlmavate töövoodede jaoks kombineeri salvestust ja aheldamist:

# 1. pööre: esmane otsing
r1 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analüüsi tehisintellekti turusuundumusi.",
    tools=[{"type": "web_search"}, {"type": "code_interpreter"}],
    store=True,
    max_turns=5
)

# 2. pööre: süvenda oma sisemiste andmetega
r2 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Võrdle meie sisemiste andmetega.",
    tools=[{
        "type": "function",
        "name": "query_internal_db",
        "description": "Päring sisemisse andmebaasi",
        "parameters": {"type": "object", "properties": {"query": {"type": "string"}}}
    }],
    previous_response_id=r1.id,
    store=True
)

Peamised punktid

  • Kombineeri serveritööriistu ja kliendifunktsioone ühes päringus hübriidsete töövoodede loomiseks
  • Serveritööriistad käivituvad automaatselt; kliendifunktsioonid peatavad genereerimise
  • max_turns lähtestatakse pärast iga kliendipoolset edasi-tagasi suhtlust
  • Levinud mustrid: otsing + tegevus, arvutus + teavitus, mitme allika agregeerimine
  • Kasuta mitme pöördega töövoodede jaoks store: true ja previous_response_id