Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Apvienojot servera un klienta rīkus

Nodarbība 12 no 16 Atjaunota 2026. gada 30. jūlijs Programmētājs
Šajā lapā
  1. Hibrīda darbplūsmas
  2. Servera rīku un funkciju apvienošana
  3. Hibrīda izpildes plūsma
  4. Bieži sastopami kombinēšanas paraugi
  5. max_turns un hibrīda rīki
  6. Daudzgājienu konteksts ar krātuvi
  7. Galvenās atziņas

Hibrīda darbplūsmas

Responses API patiesā jauda atklājas, kad vienā pieprasījumā apvieno servera rīkus (kurus automātiski izpilda xAI) un klienta rīkus (tavas pielāgotās funkcijas). Modelis autonomi orķestrē šos rīkus, radot sarežģītas darbplūsmas tikai dažās koda rindās.

Servera rīku un funkciju apvienošana

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

Šajā scenārijā modelis:

  1. Automātiski iedarbina web_search (servera pusē), lai atrastu rezultātus
  2. Iekļauj datus kopsavilkumā
  3. Izsauc send_team_message (klienta pusē), lai tavs kods nosūtītu ziņojumu vietnē Slack

Hibrīda izpildes plūsma

Plūsma atšķiras atkarībā no rīka veida:

Tikai servera rīki

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

Viss notiek xAI pusē. Tu saņem galīgo atbildi tieši ar integrētiem rezultātiem.

Tikai klienta rīki

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

Modelis apstājas, tavs kods izpilda funkciju, pēc tam tu nosūti rezultātu atpakaļ.

Hibrīda plūsma

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

Modelis vispirms izmanto servera rīkus (automātiski), pēc tam izsauc tavu funkciju, kad tam nepieciešama tava infrastruktūra.

Bieži sastopami kombinēšanas paraugi

Meklēšana + darbība

Apvieno web_search vai x_search ar darbības funkciju:

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

Aprēķins + paziņojums

Apvieno code_interpreter ar paziņojuma funkciju:

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 un hibrīda rīki

max_turns uzvedība ir svarīga hibrīda kontekstā:

  • max_turns ierobežo servera puses gājienus viena pieprasījuma ietvaros
  • Kad modelis izsauc klienta funkciju un tavs kods atgriež rezultātu, sākas jauns max_turns sadalījums

Praksē tas nozīmē, ka klienta izsaukumi neiztērē tavu servera gājienu budžetu. Modelis var veikt 3 meklēšanas tīmeklī, izsaukt tavu funkciju un pēc rezultāta saņemšanas veikt vēl 3 papildu meklēšanas.

Daudzgājienu konteksts ar krātuvi

Sarežģītām darbplūsmām, kas aptver vairākas mijiedarbības, apvieno krātuvi un ķēdēšanu:

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

Galvenās atziņas

  • Apvieno servera rīkus un klienta funkcijas vienā pieprasījumā hibrīda darbplūsmām
  • Servera rīki izpildās automātiski; klienta funkcijas aptur ģenerēšanu
  • max_turns tiek atiestatīts pēc katra klienta aprites cikla
  • Bieži paraugi: meklēšana + darbība, aprēķins + paziņojums, vairāku avotu apkopošana
  • Izmanto store: true un previous_response_id daudzgājienu darbplūsmām