Nifhmu s-sejħa tal-funzjonijiet
F'din il-paġna
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.
Iddefinixxi l-għodod
Int tiddeskrivi l-funzjonijiet tiegħek b'skemi JSON: isem, deskrizzjoni, parametri mistennija.
Ibgħat it-talba
Int tibgħat il-messaġġ tal-utent flimkien mad-definizzjonijiet tal-għodod lill-API.
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.
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...).
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).
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