Serverio ir kliento įrankių derinimas
Šiame puslapyje
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:
- Automatiškai suaktyvina
web_search(serverio pusėje), kad rastų rezultatus. - Įtraukia gautus duomenis į santrauką.
- 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_turnsriboja 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_turnslimitas.
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_turnsresetinamas po kiekvieno kliento užklausos-grąžinimo ciklo.- Dažni šablonai: paieška + veiksmas, skaičiavimas + pranešimas, daugelio šaltinių agregavimas.
- Naudok
store: trueirprevious_response_id, kad valdytum daugiau nei vieno ėjimo darbo procesus.