Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Uirlisí Freastalaí agus Cliant a Mheascadh

Ceacht 8 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Dhá chatagóir uirlisí ar an ardán céanna
  2. An dá chineál a chomhcheangal in aon iarratas amháin
  3. An sreabhadh hibrideach
  4. Samplaí ón saol mór
  5. Billeáil d’uirlisí freastalaí
  6. Príomhphointí

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:

  1. web_search a úsáid chun eolas a aimsiú (feidhmiú uathoibríoch taobh an fhreastalaí)
  2. save_to_database a 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_call ar 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í