Divas Grok rīku kategorijas
Šajā lapā
Iepazīsties ar Grok API rīku ekosistēmu
Grok API spēj ne tikai ģenerēt tekstu. Tas nodrošina rīku kopu, kas ļauj modelim mijiedarboties ar ārējo pasauli: meklēt informāciju reāllaikā, analizēt datus sociālajos tīklos vai izpildīt Python kodu. Lai izmantotu šīs iespējas, tev ir jāsaprot, kā tās ir organizētas.
Grok API izšķir divas fundamentālas rīku kategorijas. Šī atšķirība nosaka, kurš izpilda rīku, kur notiek apstrāde un kas tev kā izstrādātājam ir jāpārvalda.
Iebūvētie rīki — servera puse
Iebūvētie rīki darbojas tieši xAI serveros. Kad modelis nolemj izmantot kādu no šiem rīkiem, izpilde notiek automātiski un caurspīdīgi. Tev nav jāpārvalda nekāda infrastruktūra vai jāapstrādā starprezultāti.
Lūk, pieci pieejamie iebūvētie rīki:
- Web Search (
web_search): Meklēšana tīmeklī reāllaikā ar domēnu filtrēšanu un automātiskām atsaucēm - X Search (
x_search): Meklēšana platformā X/Twitter ar konta un datuma filtrēšanu - Code Execution (
code_interpreter/code_execution): Python koda izpilde drošā izolētā vidē (smilškastē) - Collections Search (
collections_search/file_search): Meklēšana iepriekš augšupielādētos dokumentos - Remote MCP (
mcp): Savienojums ar ārējiem MCP (Model Context Protocol) serveriem
Lai aktivizētu iebūvētu rīku, vienkārši pievieno to masīvam tools savā pieprasījumā:
{
"tools": [{"type": "web_search"}]
}
Funkciju izsaukšana — klienta puse
Funkciju izsaukšana (Function Calling) darbojas citādāk. Tu definē pielāgotas funkcijas, ko modelis var izsaukt. Atšķirībā no iebūvētajiem rīkiem, tavam klienta puses kodam ir jāizpilda funkcija un jāatgriež rezultāts modelim.
Plūsma ir šāda:
- Tu pieprasījumā apraksti savas funkcijas (nosaukums, parametri, apraksts)
- Modelis analizē lietotāja pieprasījumu
- Ja tas secina, ka nepieciešama funkcija, tas atgriež funkcijas izsaukumu ar argumentiem
- Tavs kods izpilda funkciju (API izsaukums, datubāzes vaicājums, aprēķins…)
- Tu nosūti rezultātu atpakaļ modelim
- Modelis formulē savu galīgo atbildi
Šī pieeja dod tev pilnu kontroli: tu lemj, ko dara tavas funkcijas, kādus datus tās apstrādā un kā tās savienojas ar tavu infrastruktūru.
Kad lietot katru kategoriju
Iebūvētie rīki ir ideāli, ja tev nepieciešama piekļuve informācijai reāllaikā (tīmeklis, sociālie mediji) vai jāveic aprēķini, nepārvaldot infrastruktūru. Funkciju izsaukšana ir piemērotāka, ja tev jā mijiedarbojas ar savām sistēmām: iekšējām datubāzēm, biznesa API vai jebkuru servisu, kas specifisks tavai lietotnei.
Abas kategorijas vari kombinēt vienā pieprasījumā. Piemēram, vari aktivizēt Web Search, vienlaikus definējot pielāgotu funkciju, kas saglabā rezultātus tavā datubāzē.
Galvenās atziņas
- Grok API piedāvā divas rīku kategorijas: iebūvētos rīkus (izpilda xAI) un funkciju izsaukšanu (izpilda tavs kods)
- Iebūvētie rīki neprasa klienta puses infrastruktūru
- Funkciju izsaukšana nodrošina pilnu kontroli, bet prasa lielāku izstrādes apjomu
- Abas kategorijas var kombinēt vienā pieprasījumā
- Šis kurss fokusējas uz trim galvenajiem iebūvētajiem rīkiem: Web Search, X Search un Code Execution