Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Iż-Żewġ Kategoriji ta' Għodod ta' Grok

Lezzjoni 1 / 16 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Ifhem l-Ekosistema tal-Għodod tal-API ta’ Grok
  2. Għodod Integrati — Fuq in-Naħa tas-Server
  3. Sejħa tal-Funzjonijiet — Fuq in-Naħa tal-Klijent
  4. Meta Tuża Kull Kategorija
  5. Punti Ewlenin

Ifhem l-Ekosistema tal-Għodod tal-API ta’ Grok

Ħarsa ġenerali lejn l-għodod fid-dokumentazzjoni 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.

🔍
Web Search
Real-time web search
𝕏
X Search
Search on X/Twitter
🐍
Code Execution
Isolated Python sandbox
📁
Collections Search
Search within your documents
🔌
Remote MCP
External MCP servers

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:

  1. Tiddeskrivi l-funzjonijiet tiegħek (isem, parametri, deskrizzjoni) fit-talba
  2. Il-mudell janalizza t-talba tal-utent
  3. Jekk jiddetermina li hija meħtieġa funzjoni, jirritorna sejħa tal-funzjoni b’argumenti
  4. Il-kodiċi tiegħek jeżegwixxi l-funzjoni (sejħa API, mistoqsija tad-database, kalkolu…)
  5. Tibgħat ir-riżultat lura lill-mudell
  6. 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