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

L-ebda Sejħa ta' Funzjoni Personalizzata: Nifhmu l-Limitazzjoni

Lezzjoni 10 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Limitazzjoni Strutturali
  2. Il-Fruntiera Eżatta
  3. Minn Fejn Tiġi Din il-Limitazzjoni
  4. Esponi l-APIs Tiegħek permezz ta’ Server MCP
  5. Separa r-Riċerka mill-Azzjoni
  6. Arrikkixxi Qabel, Ipproċessa Wara
  7. Punti Ewlenin

Limitazzjoni Strutturali

Jekk inti mdorri tiddikjara l-funzjonijiet tiegħek stess u tħalli l-mudell jiddeċiedi meta jsejħilhom, ipprepara ruħek biex tbiddel l-approċċ tiegħek: is-sistema multi-aġent ta’ Grok ma tappoġġjax is-sejħa ta’ funzjonijiet personalizzati. Din mhix sempliċiment dettall ta’ konfigurazzjoni; hija limitazzjoni arkitettonika li taffettwa kif tistruttura l-applikazzjoni tiegħek. Huwa aħjar li ssir taf issa milli wara li tikteb tliet mitt linja ta’ skemi ta’ funzjonijiet.

Il-Fruntiera Eżatta

Dak li jaħdem huma l-ħames għodod integrati mil-lezzjoni preċedenti: web_search għat-tiftix fil-web f’ħin reali, x_search għall-pjattaforma X, code_execution biex tħaddem Python, collections_search għall-kollezzjonijiet indiċjati tiegħek, u Remote MCP għal għodod esterni permezz tal-protokoll MCP. Xejn ieħor ma jaħdem. Il-funzjonijiet definiti fil-kodiċi tiegħek, l-iskemi personalizzati, u s-sejħiet lejn l-APIs tiegħek stess permezz tal-mekkaniżmu ta’ sejħa ta’ funzjonijiet huma kollha miċħuda.

Speċifikament, id-dikjarazzjoni hawn taħt, li hija perfettament valida ma’ mudell standard, m’għandha l-ebda effett fil-modalità multi-aġent.

# DOES NOT WORK with multi-agent
tools = [
    {
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Get the weather",
            "parameters": {"type": "object", "properties": {"city": {"type": "string"}}}
        }
    }
]

Minn Fejn Tiġi Din il-Limitazzjoni

Ir-raġuni tinżel għall-koordinazzjoni. Ma’ mudell wieħed, iċ-ċiklu tas-sejħa tal-funzjoni huwa ċar: il-mudell jitlob sejħa, il-kodiċi tiegħek jeżegwixxiha, inti tirritorna r-riżultat, u l-mudell ikompli. Issa introduċi erba’ jew sittax-il aġent li jaħdmu parallelament, u l-mistoqsijiet jimmultiplikaw. Liema wieħed jiddeċiedi li jsejjaħ il-funzjoni? X’jiġri jekk żewġ aġenti jsejħu l-istess funzjoni fl-istess ħin b’argumenti differenti? Kif il-mexxej jissintetizza r-riżultati miksuba minn sotto-aġenti li r-raġunament tagħhom ma segwiex?

L-għodod integrati huma ddisinjati għal dan il-kuntest u jafu kif iġibu ruħhom b’mod korrett meta diversi aġenti jitolbuhom fl-istess ħin. Il-funzjonijiet tiegħek, madankollu, kienu miktuba billi tassumi sejjaħ wieħed biss. Din il-limitazzjoni tirrifletti dik id-differenza fid-disinn aktar milli nuqqas temporanju.

Esponi l-APIs Tiegħek permezz ta’ Server MCP

L-aktar soluzzjoni nadifa hija li ma tipprova ddurx magħha, iżda tuża d-dħul maħsub għal dan. Jekk għandek bżonn tsejjaħ is-servizzi tiegħek stess, esponihom permezz ta’ server MCP: l-aġenti mbagħad jittrattawhom bħala għodod nattivi, bil-ġestjoni tal-konkorrenza meħtieġa. Huwa ftit aktar xogħol minn qabel milli dikjarazzjoni ta’ funzjoni, iżda jibqa’ l-uniku mod biex tidħol is-sistema tal-informazzjoni tiegħek fiċ-ċiklu tat-tiftix.

Separa r-Riċerka mill-Azzjoni

It-tieni strateġija, spiss dik it-tajba meta l-funzjonijiet tiegħek jipprovokaw effetti sekondarji, hija li taqsam il-proċess f’żewġ partijiet. Il-multi-aġent jagħmel dak li jaf jagħmel, jiġifieri jfittex u janalizza; mudell standard jieħu f’idejh il-parti li ssejjaħ l-APIs tiegħek.

# Step 1: multi-agent research
chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=4,
    tools=[web_search()],
)
chat.append(user("Find the best Italian restaurants in Paris"))
research_result = ""
for response, chunk in chat.stream():
    if chunk.content:
        research_result += chunk.content

# Step 2: action with standard model + function calling
# Use grok-4.5 or another model that supports function calling

Din is-separazzjoni għandha vantaġġ sottovalutat: tippermettilek li tispezzjona u tivvalida r-riżultat tat-tiftix qabel ma tiġi attivata azzjoni irreversibbli. Rari tkun idea tajba li aġent jibbukkja mejda ibbażat fuq riċerka mhux ivverifikata.

Arrikkixxi Qabel, Ipproċessa Wara

It-tielet approċċ, l-iżjed ħafif: sejjaħ l-APIs tiegħek barra mill-konversazzjoni, ‘il fuq biex tarrikkixxi l-prompt, jew ‘l isfel biex tisfrutta r-rispons. Ħafna ħtiġijiet li wieħed jaħseb li jeħtieġu sejħa ta’ funzjoni fil-fatt jinżlu għall-injezzjoni tad-data t-tajba fil-ħin it-tajjeb.

# Pre-processing: enrich context
user_data = my_api.get_user_profile(user_id)
context = f"User profile: {user_data}"

# Multi-agent with enriched context
chat.append(user(f"{context}\n\nAnalyze options matching this profile"))

Il-profil tal-klijent, l-istorja tal-ordnijiet, jew ir-restrizzjonijiet tal-baġit m’għandhomx jiġu rkuprati mill-mudell: inti diġà tafhom, sempliċiment agħtihomlu. Fl-aħħar nett, żomm f’moħħok li l-API qiegħda f’beta u din il-limitazzjoni tista’ tevolvi—raġun biżżejjed biex tiżola l-parti multi-aġent tal-kodiċi tiegħek wara interfaċċa li tista’ tevolvi mingħajr ma terġa’ tikteb kollox.

Punti Ewlenin

  • Is-sejħa ta’ funzjonijiet personalizzati mhix appoġġjata mal-multi-aġent
  • Jgħoddu biss l-għodod integrati (web_search, x_search, code_execution, collections_search, Remote MCP)
  • Uża Remote MCP biex tesponi l-APIs tiegħek stess lill-aġenti
  • Adotta arkitettura f’żewġ passi jekk għandek bżonn sejħa ta’ funzjonijiet
  • Din il-limitazzjoni tista’ tevolvi f’verżjonijiet futuri (API beta)