Iż-Żewġ Kategoriji ta' Għodod ta' Grok
F'din il-paġna
Ifhem l-Ekosistema tal-Għodod tal-API ta’ Grok
L-API ta’ Grok tagħmel aktar milli tiġġenera test biss. Tipprovdi sett ta’ għodod li jħallu lill-mudell jinteraġixxi mad-dinja ta’ barra: tfittxija għal informazzjoni f’ħin reali, analiżi ta’ data fuq il-midja soċjali, jew eżekuzzjoni ta’ kodiċi Python. Biex tisfrutta dawn il-kapaċitajiet, trid tifhem kif huma organizzati.
L-API ta’ Grok tiddistingwi żewġ kategoriji fundamentali ta’ għodod. Din id-distinzjoni tiddetermina min jeżegwixxi l-għodda, fejn iseħħ l-ipproċessar, u x’għandek timmaniġġja bħala żviluppatur.
Għodod Integrati — Fuq in-Naħa tas-Server
L-għodod integrati joperaw direttament fuq is-servers ta’ xAI. Meta l-mudell jiddeċiedi li juża waħda minn dawn l-għodod, l-eżekuzzjoni hija awtomatika u trasparenti. M’għandekx bżonn timmaniġġja kwalunkwe infrastruttura jew tipproċessa riżultati intermedjarji.
Hawn huma l-ħames għodod integrati disponibbli:
- Web Search (
web_search): Tfittxija fuq il-web f’ħin reali, b’filtrazzjoni tad-dominju u ċitazzjonijiet awtomatiċi - X Search (
x_search): Tfittxija fuq X/Twitter, b’filtrazzjoni skont il-kont u d-data - Code Execution (
code_interpreter/code_execution): Eżekuzzjoni ta’ kodiċi Python f’ambjent iżolat u sikur (sandbox) - Collections Search (
collections_search/file_search): Tfittxija fi ħdan dokumenti li tkun ittellajt preċedentement - Remote MCP (
mcp): Konnessjoni ma’ servers MCP (Model Context Protocol) esterni
Biex tattivaw għodda integrata, sempliċiment żidha mal-array tools fit-talba tiegħek:
{
"tools": [{"type": "web_search"}]
}
Sejħa tal-Funzjonijiet — Fuq in-Naħa tal-Klijent
Is-Sejħa tal-Funzjonijiet (Function Calling) taħdem b’mod differenti. Int tiddefinixxi funzjonijiet personalizzati li l-mudell jista’ jsejjaħ. Iżda, kuntrarju għall-għodod integrati, il-kodiċi tiegħek fuq in-naħa tal-klijent huwa li jeżegwixxi l-funzjoni u jirritorna r-riżultat lill-mudell.
Il-fluss huwa kif ġej:
- Tiddeskrivi l-funzjonijiet tiegħek (isem, parametri, deskrizzjoni) fit-talba
- Il-mudell janalizza t-talba tal-utent
- Jekk jiddetermina li hija meħtieġa funzjoni, jirritorna sejħa tal-funzjoni b’argumenti
- Il-kodiċi tiegħek jeżegwixxi l-funzjoni (sejħa API, mistoqsija tad-database, kalkolu…)
- Tibgħat ir-riżultat lura lill-mudell
- Il-mudell jifformula t-tweġiba finali tiegħu
Dan l-approċċ jagħtik kontroll sħiħ: int tiddeċiedi x’jagħmlu l-funzjonijiet tiegħek, liema data jimmaniġġjaw, u kif jikkonnettjaw mal-infrastruttura tiegħek.
Meta Tuża Kull Kategorija
L-għodod integrati huma ideali meta jkollok bżonn aċċess għal informazzjoni f’ħin reali (web, midja soċjali) jew meta jkollok bżonn twettaq kalkoli mingħajr ma timmaniġġja infrastruttura. Is-Sejħa tal-Funzjonijiet hija preferibbli meta jkollok bżonn tinteraġixxi mas-sistemi tiegħek stess: databases interni, APIs tan-negozju, jew kwalunkwe servizz speċifiku għall-applikazzjoni tiegħek.
Tista’ tgħaqqad iż-żewġ kategoriji f’talba waħda. Pereżempju, tista’ tattivaw il-Web Search filwaqt li tiddefinixxi funzjoni personalizzata li ssalva r-riżultati fid-database tiegħek.
Punti Ewlenin
- L-API ta’ Grok toffri żewġ kategoriji ta’ għodod: għodod integrati (eżegwiti minn xAI) u Sejħa tal-Funzjonijiet (eżegwiti mill-kodiċi tiegħek)
- L-għodod integrati ma jeħtiġux infrastruttura fuq in-naħa tal-klijent
- Is-Sejħa tal-Funzjonijiet toffri kontroll sħiħ iżda teħtieġ aktar żvilupp
- Iż-żewġ kategoriji jistgħu jiġu kkombinati f’talba waħda
- Dan il-kors jiffoka fuq it-tliet għodod integrati ewlenin: Web Search, X Search, u Code Execution