Tagħqid ta' Għodod tas-Server u tal-Klijent
F'din il-paġna
Flussi ta’ Ħidma Ibridi
Il-qawwa vera tal-API tar-Risponsi (Responses API) toħroġ meta tgħaqqad għodod tas-server (eżegwiti awtomatikament minn xAI) u għodod tal-klijent (il-funzjonijiet personalizzati tiegħek) f’talba waħda. Il-mudell jikkoordina dawn l-għodod b’mod awtonomu, u joħloq flussi ta’ ħidma kumplessi f’ftit linji ta’ kodiċi biss.
Tagħqid ta’ Għodod tas-Server u Funzjonijiet
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"]
}
}
]
)
F’dan ix-xenarju, il-mudell:
- Jattiva
web_searchawtomatikament (naħa tas-server) biex isib ir-riżultati - Jinkorpora d-dejta f’sommarju
- Isejjaħ
send_team_message(naħa tal-klijent) biex il-kodiċi tiegħek jibgħat il-messaġġ fuq Slack
Il-Fluss ta’ Eżekuzzjoni Ibridu
Il-fluss ivarja skont it-tip ta’ għodda:
Għodod tas-Server Biss
Request → [model → web_search → result → model] → Final response
Kollox iseħħ fuq in-naħa ta’ xAI. Int tirċievi r-rispons finali direttament bir-riżultati integrati.
Għodod tal-Klijent Biss
Request → [model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Il-mudell jieqaf, il-kodiċi tiegħek jeseġwixxi, imbagħad tibgħat ir-riżultat lura.
Fluss Ibridu
Request → [model → web_search → result → model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Il-mudell juża l-għodod tas-server l-ewwel (awtomatikament), imbagħad isejjaħ il-funzjoni tiegħek meta jkollu bżonn l-infrastruttura tiegħek.
Mudelli Komuni ta’ Tagħqid
Tiftix + Azzjoni
Għaqqad web_search jew x_search ma’ funzjoni ta’ azzjoni:
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"]
}
}
]
Kalkolu + Notifika
Għaqqad code_interpreter ma’ funzjoni ta’ notifika:
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 u Għodod Ibridi
L-imġiba ta’ max_turns hija importanti f’kuntest ibridu:
max_turnstillimita d-dawriet fuq in-naħa tas-server fi ħdan talba waħda- Meta l-mudell isejjaħ funzjoni tal-klijent u l-kodiċi tiegħek jirritorna r-riżultat, tibda allokazzjoni ġdida ta’
max_turns
Fil-prattika, dan ifisser li s-sejħiet tal-klijent ma jeżawrixxux il-baġit tad-dawriet tas-server tiegħek. Il-mudell jista’ jwettaq 3 tiftixiet fuq il-web, isejjaħ il-funzjoni tiegħek, imbagħad iwettaq 3 tiftixiet addizzjonali wara li jirċievi r-riżultat.
Kuntest Multi-dawra bil-Ħażna
Għal flussi ta’ ħidma kumplessi li jestendu fuq interazzjonijiet multipli, għaqqad il-ħażna u l-katina (chaining):
# 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
)
Punti Ewlenin
- Għaqqad għodod tas-server u funzjonijiet tal-klijent f’talba waħda għal flussi ta’ ħidma ibridi
- L-għodod tas-server jeseġwixxu awtomatikament; il-funzjonijiet tal-klijent iwaqqfu l-ġenerazzjoni
max_turnsjiġi rrisettjat wara kull vjaġġ ‘l hemm u lura tal-klijent- Mudelli komuni: tiftix + azzjoni, kalkolu + notifika, aggregazzjoni minn sorsi multipli
- Uża
store: trueuprevious_response_idgħal flussi ta’ ħidma multi-dawra