Uirlisí Freastalaí agus Cliant a Mheascadh
Ar an leathanach seo
Dhá chatagóir uirlisí ar an ardán céanna
Déanann API Grok idirdhealú idir dhá chineál uirlise atá bunúsach difriúil bunaithe ar fheidhmiú. Tá sé ríthábhachtach an t-idirdhealú seo a thuiscint chun ailtireachtaí láidre a dhearadh.
Uirlisí ionsuite (taobh an fhreastalaí)
Feidhmíonn xAI na huirlisí seo go huathoibríoch ar a bhfreastalaithe féin. Ní bhainistíonn tú aon rud—gan feidhmiú áitiúil, gan torthaí a chur ar aghaidh. Glaoíonn an tsamhail orthu agus faigheann sí na torthaí go díreach.
| Uirlis | Aitheantóir | Cur síos |
|---|---|---|
| Cuardach Gréasáin | web_search | Cuardach gréasáin fíor-ama |
| Cuardach X | x_search | Cuardach ar X/Twitter |
| Ateangaire Cóid | code_interpreter | Feidhmiú Python i mbosca gainimh |
| Cuardach Bailiúcháin | collections_search | Cuardach laistigh de do dhoiciméid uaslódáilte |
| MCP Cianda | mcp | Nasc le freastalaithe MCP seachtracha |
Feidhmeanna saincheaptha (taobh an chliaint)
Is iad seo do chuid feidhmeanna féin, sainmhínithe trí ghlao feidhme. Tugann an tsamhail tool_call ar ais, feidhmíonn do chód an fheidhm, agus seolann tú an toradh ar ais. Is é seo an mheicníocht a d’fhoghlaim tú i gceachtanna roimhe seo.
An dá chineál a chomhcheangal in aon iarratas amháin
Is é cumas meascadh d’uirlisí freastalaí agus cliant in aon iarratas amháin bunús chumhacht API Grok:
tools = [
# Uirlis freastalaí — feidhmíonn xAI í go huathoibríoch
{"type": "web_search"},
# Uirlis cliant — feidhmíonn do chód í
{
"type": "function",
"function": {
"name": "save_to_database",
"description": "Save information to the database",
"parameters": {
"type": "object",
"properties": {
"key": {"type": "string"},
"value": {"type": "string"}
},
"required": ["key", "value"]
}
}
}
]
Nuair a fhaigheann an tsamhail an t-iarratas seo, is féidir léi:
web_searcha úsáid chun eolas a aimsiú (feidhmiú uathoibríoch taobh an fhreastalaí)save_to_databasea ghlaoch chun an toradh a shábháil (filleann sé ar an gcliant)
An sreabhadh hibrideach
Athraíonn an iompar de réir chineál na huirlise:
- Uirlis freastalaí: Glaoíonn an tsamhail ar an uirlis, feidhmíonn xAI í, comhtháthaítear an toradh go huathoibríoch, agus leanann an tsamhail ar aghaidh.
- Uirlis cliant: Tugann an tsamhail an
tool_callar ais don chlient, stopann an fheidhmiú, agus tosaíonn sé arís nuair a sheolann tú an toradh ar ais.
Nuair a úsáideann an tsamhail an dá chineál san iarratas céanna, feidhmíonn uirlisí an fhreastalaí ar dtús (gan do rannpháirtíocht). Ansin, má theastaíonn uirlis cliant ón tsamhail freisin, filleann sí an tool_call chugat leis na torthaí ón uirlis freastalaí comhtháthaithe cheana féin ina comhthéacs.
Samplaí ón saol mór
Cuardach gréasáin + loighic gnó
# Iarrann an t-úsáideoir: "Faigh praghas Bitcoin agus sábháil é"
# Déanann an tsamhail:
# 1. Glaoíonn sí ar web_search chun an praghas a aimsiú (taobh an fhreastalaí, uathoibríoch)
# 2. Glaoíonn sí ar save_price(symbol="BTC", price=68432) (taobh an chliaint)
Cuardach X + fógra
# "Tabhair foláireamh dom faoi thuíteanna faoinár dtáirge ó inné"
# Déanann an tsamhail:
# 1. Glaoíonn sí ar x_search chun tuíteanna a aimsiú (taobh an fhreastalaí)
# 2. Glaoíonn sí ar send_notification(count=12, summary="...") (taobh an chliaint)
Ateangaire cóid + stóráil
# "Ríomh meán an sonraí seo agus sábháil an toradh"
# Déanann an tsamhail:
# 1. Glaoíonn sí ar code_interpreter don ríomh (taobh an fhreastalaí)
# 2. Glaoíonn sí ar save_result(key="avg", value="42.5") (taobh an chliaint)
Billeáil d’uirlisí freastalaí
Billeáiltear uirlisí ionsuite ar dhá bhealach:
- Tokain: Tomhaltas caighdeánach (ionchur + aschur)
- Glaonna: Costas seasta in aghaidh gach glao uirlise
Is féidir leis an tsamhail glaonna iolracha a dhéanamh ar uirlisí freastalaí d’aon iarratas amháin—cuirtear na costais le chéile. Coinnigh é seo san áireamh nuair a chumasaíonn tú web_search: d’fhéadfadh an tsamhail cuardaigh iolracha a dhéanamh chun a torthaí a bheachtú.
Príomhphointí
- Dhá chineál uirlise: freastalaí (uathoibríoch) agus cliant (glao feidhme)
- Feidhmíonn uirlisí freastalaí (
web_search,x_search,code_interpreter) gan do rannpháirtíocht - Is féidir leat an dá chineál a mheascadh in aon iarratas amháin
- Feidhmíonn uirlisí freastalaí ar dtús, ansin is féidir leis an tsamhail glaoch ar do fheidhmeanna
- Billeáiltear gach glaonna ar uirlis freastalaí (tokain + costas in aghaidh an ghlao)
- Gintear luachanna tagartha go huathoibríoch do shonraí ó uirlisí freastalaí