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

Taħlit ta' Għodod tas-Server u tal-Klijent

Lezzjoni 8 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Żewġ kategoriji ta’ għodod fuq l-istess pjattaforma
  2. Tagħqid taż-żewġ tipi f’talba waħda
  3. Il-fluss ibridu
  4. Eżempji fid-dinja reali
  5. Fatturar għall-għodod tas-server
  6. Punti Ewlenin

Żewġ kategoriji ta’ għodod fuq l-istess pjattaforma

L-API ta’ Grok tiddistingwi żewġ tipi ta’ għodod fundamentali differenti bbażati fuq l-eżekuzzjoni. Li tifhem din id-distinzjoni hija essenzjali biex tiddisinja arkitetturi robusti.

Għodod integrati (naħa tas-server)

xAI tesegwixxi dawn l-għodod awtomatikament fuq is-servers tagħha. Int ma timmaniġġja xejn—l-ebda eżekuzzjoni lokali, l-ebda inoltrar tar-riżultati. Il-mudell isejjaħhom u jirċievi r-riżultati direttament.

Għodda Identifikatur Deskrizzjoni
Web Search web_search Tfittxija fuq il-web f'ħin reali
X Search x_search Tfittxija fuq X/Twitter
Code Interpreter code_interpreter Eżekuzzjoni ta' Python f'ambjent iżolat (sandbox)
Collections Search collections_search Tfittxija fid-dokumenti mibgħuta tiegħek
Remote MCP mcp Konnessjoni ma' servers MCP esterni

Funzjonijiet personalizzati (naħa tal-klijent)

Dawn huma l-funzjonijiet tiegħek stess, definiti permezz tas-sejħa tal-funzjonijiet (function calling). Il-mudell jirritorna tool_call, il-kodiċi tiegħek jesegwixxi l-funzjoni, u inti tibgħat lura r-riżultat. Dan huwa l-mekkaniżmu li tgħallimt fil-lezzjonijiet preċedenti.

Tagħqid taż-żewġ tipi f’talba waħda

Is-saħħa tal-API ta’ Grok tinsab fil-kapaċità li tħallat għodod tas-server u tal-klijent f’talba waħda:

tools = [
    # Għodda tas-server — eżegwita awtomatikament minn xAI
    {"type": "web_search"},

    # Għodda tal-klijent — eżegwita mill-kodiċi tiegħek
    {
        "type": "function",
        "function": {
            "name": "save_to_database",
            "description": "Save information to the database",
            "parameters": {
                "type": "object",
                "properties": {
                    "key": {"type": "string"},
                    "value": {"type": "string"}
                },
                "required": ["key", "value"]
            }
        }
    }
]

Meta l-mudell jirċievi din it-talba, jista’:

  1. Juża web_search biex isib informazzjoni (eżekuzzjoni awtomatika naħa s-server)
  2. Isejjaħ save_to_database biex isalva r-riżultat (jirritorna lill-klijent)

Il-fluss ibridu

L-imġiba tvarja skont it-tip ta’ għodda:

  • Għodda tas-server: il-mudell isejjaħ l-għodda, xAI tesegwixxiha, ir-riżultat jiġi integrat awtomatikament, u l-mudell ikompli.
  • Għodda tal-klijent: il-mudell jirritorna l-tool_call lill-klijent, l-eżekuzzjoni tieqaf, u terġa’ tibda meta tibgħat lura r-riżultat.

Meta l-mudell juża ż-żewġ tipi fl-istess talba, l-għodod tas-server jesegwixxu l-ewwel (mingħajr intervent tiegħek). Imbagħad, jekk il-mudell ikollu bżonn ukoll għodda tal-klijent, jirritorna l-tool_call lilek bir-riżultati tal-għodod tas-server diġà integrati fil-kuntest tiegħu.

Eżempji fid-dinja reali

Tfittxija fuq il-web + loġika tan-negozju

# L-utent jistaqsi: "Sib il-prezz tal-Bitcoin u salvah"
# Il-mudell:
# 1. Isejjaħ web_search biex isib il-prezz (naħa s-server, awtomatiku)
# 2. Isejjaħ save_price(symbol="BTC", price=68432) (naħa tal-klijent)

Tfittxija fuq X + notifika

# "Avżani bit-tweets dwar il-prodott tagħna minn bieraħ"
# Il-mudell:
# 1. Isejjaħ x_search biex isib it-tweets (naħa s-server)
# 2. Isejjaħ send_notification(count=12, summary="...") (naħa tal-klijent)

Interpretu tal-Kodiċi + ħażna

# "Ikkalkula l-medja ta' dawn id-data u salva r-riżultat"
# Il-mudell:
# 1. Isejjaħ code_interpreter għall-kalkolu (naħa s-server)
# 2. Isejjaħ save_result(key="avg", value="42.5") (naħa tal-klijent)

Fatturar għall-għodod tas-server

L-għodod integrati jiġu ffratturati b’żewġ modi:

  • Tokens: konsum standard (input + output)
  • Invokazzjonijiet: kost fiss għal kull sejħa tal-għodda

Il-mudell jista’ jsejjaħ għodod multipli tas-server għal talba waħda—l-ispejjeż jiġu miżjuda. Żomm dan f’moħħok meta tħabbil web_search: il-mudell jista’ jwettaq tfittxijiet multipli biex jirfina r-riżultati tiegħu.

Punti Ewlenin

  • Żewġ tipi ta’ għodod: server (awtomatiku) u klijent (sejħa tal-funzjoni)
  • L-għodod tas-server (web_search, x_search, code_interpreter) jesegwixxu mingħajr intervent tiegħek
  • Tista’ tħallat iż-żewġ tipi f’talba waħda
  • L-għodod tas-server jesegwixxu l-ewwel, imbagħad il-mudell jista’ jsejjaħ il-funzjonijiet tiegħek
  • Kull invokazzjoni ta’ għodda tas-server tiġi ffratturata (tokens + kost għal kull sejħa)
  • Iċ-ċitazzjonijiet jiġu ġġenerati awtomatikament għad-data mill-għodod tas-server