Szerver- és klienseszközök kombinálása
Ezen az oldalon
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:
- Automatikusan elindítja a
web_searcheszközt (szerveroldalon) az eredmények megtalálásához - Belefoglalja az adatokat egy összefoglalóba
- Meghívja a
send_team_messagefü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_turnskorlá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_turnsminden 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 aprevious_response_idparamétereket a többkörös munkafolyamatokhoz