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

Nifhmu s-sejħa tal-funzjonijiet

Lezzjoni 1 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. X’inhi s-sejħa tal-funzjonijiet?
  2. Iċ-ċiklu ta’ 6 passi
  3. Għaliex is-sejħa tal-funzjonijiet hija daqshekk importanti?
  4. Id-differenza minn prompt standard
  5. Limiti li għandek tkun taf bihom
  6. Punti Ewlenin

X’inhi s-sejħa tal-funzjonijiet?

Is-sejħa tal-funzjonijiet hija waħda mill-aktar karatteristiċi qawwija tal-API ta’ Grok. Tippermetti lill-mudell jitlob l-eżekuzzjoni ta’ funzjonijiet li ddefinixxejt int, biex tiġbed data jew twettaq azzjonijiet fid-dinja reali.

Il-punt ewlieni li trid tifhem: Grok qatt ma jeżegwixxi l-funzjonijiet huwa stess. Il-mudell janalizza t-talba tiegħek, jiddetermina li għandu bżonn informazzjoni esterna, u jirritorna sejħa strutturata (isem tal-funzjoni + argumenti) lilek. Il-kodiċi tiegħek fuq in-naħa tal-klijent (client-side) huwa li attwalment jeżegwixxi l-funzjoni, imbagħad jibgħat ir-riżultat lura lill-mudell.

Iċ-ċiklu ta’ 6 passi

Kull interazzjoni ta’ sejħa ta’ funzjoni ssegwi ċiklu preċiż ta’ sitt passi. Dan il-fluss huwa fundamentali—jistruttura l-arkitettura kollha tiegħek.

1

Iddefinixxi l-għodod

Int tiddeskrivi l-funzjonijiet tiegħek b'skemi JSON: isem, deskrizzjoni, parametri mistennija.

2

Ibgħat it-talba

Int tibgħat il-messaġġ tal-utent flimkien mad-definizzjonijiet tal-għodod lill-API.

3

Irċievi s-sejħa tal-għodda (tool_call)

Il-mudell jirritorna oġġett tool_call bl-isem tal-funzjoni u l-argumenti JSON.

4

Eżegwixxi l-funzjoni

Il-kodiċi tiegħek fuq in-naħa tal-klijent jeżegwixxi l-funzjoni attwali (sejħa API, mistoqsija tad-database, kalkolu...).

5

Irritorna r-riżultat

Int tibgħat ir-riżultat tal-eżekuzzjoni lura lill-mudell f'messaġġ bir-rwol tal-għodda (tool role).

6

Tweġiba finali

Il-mudell jintegra r-riżultat u jiġġenera tweġiba b'lingwa naturali għall-utent.

Għaliex is-sejħa tal-funzjonijiet hija daqshekk importanti?

Mingħajr is-sejħa tal-funzjonijiet, mudell tal-lingwa huwa limitat għall-għarfien tat-taħriġ tiegħu. Ma jistax jikkonsulta database, jagħmel mistoqsija lil API ta’ parti terza, jew iwettaq kalkolu f’ħin reali. Is-sejħa tal-funzjonijiet issolvi din il-problema fundamentali billi tagħti lill-mudell il-kapaċità li jinteraġixxi mad-dinja ta’ barra b’mod strutturat u kkontrollat.

Hawn xi każijiet ta’ użu konkreti:

  • Data f’ħin reali: it-temp, prezzijiet tal-ishma, stati tal-ordnijiet
  • Azzjonijiet tan-negozju: oħloq tikketta, ibgħat email, ibbukkja slot
  • Kalkoli preċiżi: operazzjonijiet matematiċi, konverżjonijiet, aggregazzjonijiet
  • Databases: tfittxija ta’ prodotti, storja tal-klijenti, inventarju

Id-differenza minn prompt standard

F’skambju standard, inti tagħmel mistoqsija u l-mudell iwieġeb direttament. Bis-sejħa tal-funzjonijiet, il-mudell jista’ jieqaf fit-tweġiba tiegħu biex jitlob informazzjoni addizzjonali permezz ta’ sejħa ta’ funzjoni. Din il-kapaċità li jinterrompi l-fluss tal-ġenerazzjoni hija dak li jagħmel dan il-mekkaniżmu daqshekk qawwi.

Il-mudell jaħseb hekk: “Biex nwieġeb din il-mistoqsija, għandi bżonn it-temp attwali f’Pariġi. Se nsejjaħ il-funzjoni get_weather bil-parametru city: Paris.”

Limiti li għandek tkun taf bihom

L-API ta’ Grok taċċetta sa 200 għodda għal kull talba. Dan huwa aktar minn biżżejjed għall-biċċa l-kbira tal-każijiet ta’ użu, iżda żomm f’moħħok li kull definizzjoni ta’ għodda tikkonsma tokens tal-input. Aktar għodod tiddikjara, aktar tkun għolja t-talba—u aktar jieħu żmien il-mudell biex jagħżel l-għodda t-tajba.

Punti Ewlenin

  • Is-sejħa tal-funzjonijiet tippermetti lill-mudell jitlob l-eżekuzzjoni tal-funzjonijiet, mhux li jeżegwixxihom huwa stess
  • Il-fluss dejjem isegwi 6 passi: iddefinixxi, ibgħat, irċievi, eżegwixxi, irritorna, wieġeb
  • Il-funzjonijiet jeżegwixxu fuq in-naħa tal-klijent, fil-kodiċi tiegħek
  • Massimu ta’ 200 għodda għal kull talba
  • Kull definizzjoni ta’ għodda tikkonsma tokens—kun selettiv