Taħlit ta' Għodod tas-Server u tal-Klijent
F'din il-paġna
Ż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’:
- Juża
web_searchbiex isib informazzjoni (eżekuzzjoni awtomatika naħa s-server) - Isejjaħ
save_to_databasebiex 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_calllill-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