Uirlisí Freastalaí agus Cliant a Chomhcheangal
Ar an leathanach seo
Sreabhair Oibre Hibrideacha
Tagann fíorchumhacht an API Freagraí chun cinn nuair a chomhcheanglaíonn tú uirlisí freastalaí (a fhorghníomhaíonn xAI go huathoibríoch) agus uirlisí cliant (do fheidhmeanna saincheaptha) in aon iarratas amháin. Déanann an tsamhail na huirlisí seo a stiúradh go huathrialach, ag cruthú sreabhair oibre casta i gcúpla líne cóid.
Uirlisí Freastalaí agus Feidhmeanna a Chomhcheangal
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"]
}
}
]
)
Sa chás seo, déanann an tsamhail an méid seo a leanas:
- Tosaíonn sí
web_searchgo huathoibríoch (taobh an fhreastalaí) chun na torthaí a aimsiú - Cuireann sí na sonraí isteach in achoimre
- Glaoann sí ar
send_team_message(taobh an chliaint) ionas go seolann do chód an teachtaireacht Slack
An Sreabha Forghníomhaithe Hibrideach
Athraíonn an sreabha ag brath ar chineál na huirlise:
Uirlisí Freastalaí Amháin
Request → [model → web_search → result → model] → Final response
Tarlaíonn gach rud ar thaobh xAI. Faigheann tú an freagra deiridh go díreach leis na torthaí comhtháite.
Uirlisí Cliant Amháin
Request → [model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Stopann an tsamhail, forghníomhaíonn do chód an fheidhm, agus ansin seolann tú an toradh ar ais.
Sreabha Hibrideach
Request → [model → web_search → result → model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Úsáideann an tsamhail uirlisí freastalaí ar dtús (go huathoibríoch), agus ansin glaonn sí ar do fheidhm nuair a theastaíonn do bhonneagar uaithi.
Patrúin Chomhcheangail Choitianta
Cuardach + Gníomh
Comhcheangail web_search nó x_search le feidhm gníomhaíochta:
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"]
}
}
]
Ríomhaireacht + Fógra
Comhcheangail code_interpreter le feidhm fógra:
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 agus Uirlisí Hibrideacha
Tá tábhacht le hiompar max_turns i gcomhthéacs hibrideach:
- Cuireann
max_turnsteorainn le rothluithe taobh an fhreastalaí laistigh d’aon iarratas amháin - Nuair a ghlaonn an tsamhail ar fheidhm chliaint agus nuair a thugann do chód an toradh ar ais, tosaíonn leithdháileadh nua de
max_turns
Go praiticiúil, ciallaíonn sé seo nach gcuireann glaotha cliant do bhuiséad rothlaithe freastalaí in ídiú. Is féidir leis an tsamhail 3 chuardach gréasáin a dhéanamh, do fheidhm a ghlaow, agus ansin 3 chuardach bhreise a dhéanamh tar éis an toraidh a fháil.
Comhthéacs Il-rothlaithe le Stóráil
Chun sreabhair oibre casta a shíneann thar idirghníomhaíochtaí iolracha, comhcheangail stóráil agus slabhrú:
# 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
)
Príomhphointí
- Comhcheangail uirlisí freastalaí agus feidhmeanna cliant in aon iarratas amháin le haghaidh sreabhair oibre hibrideacha
- Forghníomhaítear uirlisí freastalaí go huathoibríoch; stopann feidhmeanna cliant an ghiniúint
- Athshocraíonn
max_turnstar éis gach turais chliaint - Patrúin choitianta: cuardach + gníomh, ríomhaireacht + fógra, comhiomlánú ilfhoinse
- Úsáid
store: trueagusprevious_response_idle haghaidh sreabhair oibre il-rothlaithe