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

Limiti u L-Aħjar Prattiki

Lezzjoni 3 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Limitazzjonijiet tekniċi tas-sejħa tal-funzjonijiet
  2. Massimu ta’ 200 għodda għal kull talba
  3. Il-mudell ma jiggarantix il-validità tal-argumenti
  4. Ġestjoni tal-iżbalji
  5. Ismijiet uniċi u espliċiti
  6. Deskrizzjonijiet: il-fattur #1 tal-kwalità
  7. Ottimizzazzjoni tan-numru ta’ għodod
  8. Sigurtà: qatt ma tifda lill-mudell
  9. Punti Ewlenin

Limitazzjonijiet tekniċi tas-sejħa tal-funzjonijiet

Qabel ma tibda timplimenta, trid tifhem il-limiti tas-sistema. Is-sejħa tal-funzjonijiet ta’ Grok hija qawwija, iżda topera fi ħdan kostrezzjonijiet speċifiċi li trid tgħaxxaq biex tibni applikazzjonijiet robusti.

Massimu ta’ 200 għodda għal kull talba

L-API ta’ Grok taċċetta sa 200 definizzjoni ta’ għodda f’talba waħda. Dan il-limitu huwa ġeneruż—ħafna applikazzjonijiet jużaw biss bejn 5 u 20. Iżda jekk tibni sistema skalabbli (plugins, suq tal-għodod), trid tikkunsidrah.

Kull definizzjoni ta’ għodda tieħu spazju fit-tieqa tal-kuntest. Speċifikament:

  • Għodda sempliċi (2-3 parametri) tikkonsma madwar 50-100 token
  • Għodda kumplessa (10+ parametri, deskrizzjonijiet dettaljati) tista’ taqbeż 300 token
  • 200 għodda kumplessa = 60,000 token biss għad-definizzjonijiet

Għalhekk għandek tkun strateġiku: iddikjara biss l-għodod rilevanti għat-talba attwali.

Il-mudell ma jiggarantix il-validità tal-argumenti

Grok jagħmel ħiltu biex jiġġenera argumenti li jaqblu mal-iskema, iżda mhux infallibbli. Il-mudell jista’:

  • Jiġġenera format tad-data żbaljat
  • Jgħaddi string fejn huwa mistenni integer
  • Iħalli barra kamp meħtieġ f’każijiet rari
  • Joħloq valuri enum li ma jeżistux

Il-kodiċi tiegħek fuq in-naħa tal-klijent irid dejjem jivvalida l-argumenti riċevuti qabel ma jesegwixxi l-funzjoni.

import json

def handle_tool_call(tool_call):
    args = json.loads(tool_call.function.arguments)

    # Ivvalida qabel l-eżekuzzjoni
    if "city" not in args:
        return {"error": "Il-parametru tal-belt huwa meħtieġ"}

    if not isinstance(args["city"], str):
        return {"error": "il-belt trid tkun string"}

    return get_weather(args["city"], args.get("unit", "celsius"))

Ġestjoni tal-iżbalji

Meta funzjoni tfalli, trid tirritorna l-iżball lill-mudell minflok ma taqa’ fis-skiet. Il-mudell imbagħad jista’:

  • Ifformula mill-ġdid it-talba tiegħu b’parametri kkoreġuti
  • Jgħarraf lill-utent bil-problema
  • Jipprova għodda alternattiva
try:
    result = search_database(query=args["query"])
    return json.dumps(result)
except ConnectionError:
    return json.dumps({
        "error": "Id-database mhux disponibbli",
        "suggestion": "Ipprova mill-ġdid f'ftit sekondi"
    })

Dejjem irritorna JSON strutturat, anke fuq żball. Il-mudell jifhem il-messaġġi ta’ żball u jadatta r-risposta tiegħu skont dan.

Ismijiet uniċi u espliċiti

L-ismijiet tal-funzjonijiet iridu jkunu uniċi fil-lista tal-għodod. Jekk żewġ għodod jaqsmu l-istess isem, l-imġiba mhix definita—l-API tista’ tirrifjuta t-talba jew tinjora waħda minnhom.

Adotta konvenzjoni ta’ smijiet konsistenti:

✅ L-aħjar prattiki:
   get_weather          → rkupru tad-data
   search_products      → tfittxija
   create_ticket        → ħolqien
   update_order_status  → aġġornament
   delete_draft         → tħassir

❌ Evita:
   fn1, fn2             → incomprehensibbli
   doStuff              → vaga wisq
   getWeatherData       → camelCase (ippreferi snake_case)

Deskrizzjonijiet: il-fattur #1 tal-kwalità

Il-kwalità tad-deskrizzjoni tiddetermina direttament l-affidabbiltà tas-sejħa tal-funzjonijiet. Hawnhekk hemm tabella ta’ tqabbil:

Deskrizzjoni dgħajfa Deskrizzjoni effettiva
"Fittex" "Fittex prodotti bl-isem, il-kategorija, jew il-firxa tal-prezz fil-katalgu tal-kummerċ elettroniku"
"Ibgħat messaġġ" "Ibgħat email lil riċevitur. Jeħtieġ suġġett u korp tal-messaġġ. Ma jappoġġjax attachments."
"Ikkalkula" "Ikkalkula l-prezz totali inkluż it-taxxa minn prezz qabel it-taxxa u rata tal-VAT. Irritorna l-ammont f'euros b'2 postijiet deċimali."

Ottimizzazzjoni tan-numru ta’ għodod

Minflok ma tiddikjara 200 għodda fuq kull talba, agħżel b’mod dinamiku dawk li verament jimpurtaw. L-ewwel filtru huwa l-kuntest: jekk l-utent jitkellem dwar it-temp, it-tagħbija ta’ għodod tal-fatturazzjoni biss iżid storbju—routing ħafif ‘il fuq mill-fluss (b’kliem ewlieni jew sejħa ta’ klassifikazzjoni inizjali) huwa biżżejjed biex tippreżenta biss il-familja rilevanti. It-tieni filtru huwa r-rwol: aġent tas-support ma għandux bżonn għodod ta’ amministratur, u t-tneħħija tagħhom hija kwistjoni ta’ preċiżjoni daqs kemm hija ta’ sigurtà. It-tielet huwa l-pass: f’fluss ta’ xogħol b’diversi passi, kull fażi għandha l-għodod tagħha stess—it-tagħbija tagħhom hekk kif timxi ‘l quddiem iżżomm il-mudell iffukat fuq dak li għandu jagħmel issa.

Il-benefiċċju huwa doppju u immedjat: inqas token tal-input għal kull talba (id-definizzjonijiet tal-għodod jiswuk fuq kull sejħa), u preċiżjoni aħjar tal-għażla—mudell li jagħżel fost sitt għodod iddeskritti sew rari jagħmel żball, filwaqt li l-istess mudell quddiem mitejn definizzjoni jispiċċa jħawwad varjanti simili.

Sigurtà: qatt ma tifda lill-mudell

Is-sejħa tal-funzjonijiet hija vettur potenzjali ta’ injezzjoni. Utent malizzjuż jista’ jifformula t-talba tiegħu biex jimmanipula l-argumenti mgħoddija lill-funzjonijiet. Regoli tas-sigurtà:

  • Ivvalida l-argumenti kollha fuq in-naħa tas-server
  • Illimita l-permessi: funzjoni ta’ qari m’għandhiex tkun tista’ tikteb
  • Irreġistra s-sejħiet: traċċa kull sejħa ta’ funzjoni għall-awditjar
  • Naddaf l-inputs: aħrab karattri speċjali qabel mistoqsijiet SQL/shell

Punti Ewlenin

  • Massimu ta’ 200 għodda għal kull talba—iżda immira għal 5-20 għall-effiċjenza
  • Dejjem ivvalida l-argumenti fuq in-naħa tal-klijent qabel l-eżekuzzjoni
  • Irritorna l-iżbalji lill-mudell f’JSON strutturat
  • L-ismijiet iridu jkunu uniċi, snake_case, u espliċiti
  • Deskrizzjonijiet dettaljati jtejbu drastikament l-affidabbiltà
  • Agħżel b’mod dinamiku l-għodod rilevanti għal kull talba
  • Qatt ma tifda l-argumenti mingħajr validazzjoni