Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Serverio ir kliento įrankių derinimas

Paskaita 12 iš 16 Atnaujinta 2026 m. liepos 30 d. Kūrėjas
Šiame puslapyje
  1. Hibridiniai darbo procesai
  2. Serverio įrankių ir funkcijų derinimas
  3. Hibridinio vykdymo eiga
  4. Dažni derinimo šablonai
  5. max_turns ir hibridiniai įrankiai
  6. Daugiau nei vieno ėjimo kontekstas su saugykla
  7. Svarbiausi punktai

Hibridiniai darbo procesai

Tikroji „Responses API“ galia atsiskleidžia tada, kai viename užklausos kvietime derini serverio įrankius (kuriuos automatiškai vykdo xAI) ir kliento įrankius (tavo sukurtas funkcijas). Modelis savarankiškai koordinuoja šiuos įrankius, leisdamas kurti sudėtingus darbo procesus vos keliomis kodo eilutėmis.

Serverio įrankių ir funkcijų derinimas

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

Šiame scenarijuje modelis:

  1. Automatiškai suaktyvina web_search (serverio pusėje), kad rastų rezultatus.
  2. Įtraukia gautus duomenis į santrauką.
  3. Iškviečia send_team_message (kliento pusėje), kad tavo kodas išsiųstų žinutę „Slack“.

Hibridinio vykdymo eiga

Eiga skiriasi priklausomai nuo įrankio tipo:

Tik serverio įrankiai

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

Viskas vyksta xAI pusėje. Galutinį atsakymą gauni tiesiogiai su jau integruotais rezultatais.

Tik kliento įrankiai

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

Modelis pristabdo veiksmą, tavo kodas įvykdo funkciją, tada tu grąžini rezultatą atgal.

Hibridinė eiga

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

Modelis pirmiausia naudoja serverio įrankius (automatiškai), o tada iškviečia tavo funkciją, kai jam prireikia tavo infrastruktūros.

Dažni derinimo šablonai

Paieška + Veiksmas

Derink web_search arba x_search su veiksmo funkcija:

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

Skaičiavimas + Pranešimas

Derink code_interpreter su pranešimo funkcija:

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 ir hibridiniai įrankiai

max_turns elgsena hibridiniame kontekste yra labai svarbi:

  • max_turns riboja serverio pusės ėjimų skaičių vienoje užklausoje.
  • Kai modelis iškviečia kliento funkciją ir tavo kodas grąžina rezultatą, prasideda naujas max_turns limitas.

Praktiškai tai reiškia, kad kliento kvietimai neišnaudoja tavo serverio ėjimų biudžeto. Modelis gali atlikti 3 paieškas internete, iškviesti tavo funkciją, o gavęs atsakymą – atlikti dar 3 papildomas paieškas.

Daugiau nei vieno ėjimo kontekstas su saugykla

Sudėtingiems darbo procesams, apimantiems kelias sąveikas, derink saugojimą ir grandininį vykdymą:

# 1 ėjimas: pradinė paieška
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
)

# 2 ėjimas: gilinant su vidiniais duomenimis
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
)

Svarbiausi punktai

  • Derink serverio įrankius ir kliento funkcijas vienoje užklausoje, kad sukurtum hibridinius darbo procesus.
  • Serverio įrankiai vykdomi automatiškai; kliento funkcijos pristabdo generavimą.
  • max_turns resetinamas po kiekvieno kliento užklausos-grąžinimo ciklo.
  • Dažni šablonai: paieška + veiksmas, skaičiavimas + pranešimas, daugelio šaltinių agregavimas.
  • Naudok store: true ir previous_response_id, kad valdytum daugiau nei vieno ėjimo darbo procesus.