Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Szerver- és klienseszközök kombinálása

12. lecke 16 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. Hibrid munkafolyamatok
  2. Szervereszközök és függvények kombinálása
  3. A hibrid végrehajtási folyamat
  4. Gyakori kombinációs minták
  5. A max_turns és a hibrid eszközök
  6. Többkörös kontextus tárolással
  7. Főbb megállapítások

Hibrid munkafolyamatok

A Responses API igazi ereje akkor mutatkozik meg, ha egyetlen kérésben ötvözöd a szervereszközöket (amelyeket az xAI automatikusan hajt végre) és a klienseszközöket (a te egyedi függvényeid). A modell autonóm módon hangolja össze ezeket az eszközöket, így néhány sor kóddal összetett munkafolyamatokat hozhatsz létre.

Szervereszközök és függvények kombinálása

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

Ebben a forgatókönyvben a modell:

  1. Automatikusan elindítja a web_search eszközt (szerveroldalon) az eredmények megtalálásához
  2. Belefoglalja az adatokat egy összefoglalóba
  3. Meghívja a send_team_message függvényt (kliensoldalon), így a te kódod küldi el a Slack üzenetet

A hibrid végrehajtási folyamat

A folyamat az eszköz típusától függően változik:

Kizárólag szervereszközök

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

Minden az xAI oldalán történik. Közvetlenül megkapod a végső választ az integrált eredményekkel.

Kizárólag klienseszközök

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

A modell szüneteltet, a te kódod lefut, majd te küldöd vissza az eredményt.

Hibrid folyamat

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

A modell először a szervereszközöket használja (automatikusan), majd csak akkor hívja meg a te függvényedet, ha szüksége van a te infrastruktúrádra.

Gyakori kombinációs minták

Keresés + Művelet

Kombináld a web_search vagy x_search eszközt egy műveleti függvénnyel:

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

Számítás + Értesítés

Kombináld a code_interpreter eszközt egy értesítési függvénnyel:

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

A max_turns és a hibrid eszközök

A max_turns viselkedése hibrid környezetben kiemelten fontos:

  • A max_turns korlátozza a szerveroldali köröket egyetlen kérésen belül
  • Amikor a modell meghív egy kliensfüggvényt, és a te kódod visszaadja az eredményt, a max_turns újraosztása megtörténik

A gyakorlatban ez azt jelenti, hogy a klienshívások nem merítik ki a szerveroldali körkeretedet. A modell végrehajthat 3 webes keresést, meghívhatja a te függvényedet, majd az eredmény kézhezvétele után további 3 keresést végezhet.

Többkörös kontextus tárolással

Az olyan összetett munkafolyamatokhoz, amelyek több interakciót spanszolnak át, kombináld a tárolást és a láncolást:

# 1. kör: kezdeti keresés
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. kör: mélyítés a belső adataiddal
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
)

Főbb megállapítások

  • Kombináld a szervereszközöket és a kliensfüggvényeket egyetlen kérésben a hibrid munkafolyamatokhoz
  • A szervereszközök automatikusan futnak le; a kliensfüggvények szüneteltetik a generálást
  • A max_turns minden kliens oda-vissza kommunikáció után alaphelyzetbe áll
  • Gyakori minták: keresés + művelet, számítás + értesítés, többforrású aggregáció
  • Használd a store: true és a previous_response_id paramétereket a többkörös munkafolyamatokhoz