Dvi „Grok“ įrankių kategorijos
Šiame puslapyje
Susipažink su „Grok“ API įrankių ekosistema
„Grok“ API gali ne tik generuoti tekstą. Jis suteikia įrankių rinkinį, leidžiantį modeliui sąveikauti su išoriniu pasauliu: ieškoti naujausios informacijos realiuoju laiku, analizuoti duomenis socialiniuose tinkluose arba vykdyti „Python“ kodą. Norint pasinaudoti šiomis galimybėmis, reikia suprasti, kaip šie įrankiai yra suskirstyti.
„Grok“ API išskiria dvi pagrindines įrankių kategorijas. Šis skirtumas lemia, kas vykdo įrankį, kur vyksta duomenų apdorojimas ir ką tau, kaip kūrėjui, reikia valdyti.
Integruoti įrankiai – serverio pusėje
Integruoti įrankiai vykdomi tiesiogiai „xAI“ serveriuose. Kai modelis nusprendžia naudoti vieną iš šių įrankių, vykdymas yra automatinis ir nematomas. Tau nereikia valdyti jokios infrastruktūros ar apdoroti tarpinių rezultatų.
Štai penki galimi integruoti įrankiai:
- Web Search (
web_search): Interneto paieška realiuoju laiku su domenų filtravimu ir automatinėmis citatomis - X Search (
x_search): Paieška „X“/„Twitter“ platformoje su paskyrų ir datų filtravimu - Code Execution (
code_interpreter/code_execution): „Python“ kodo vykdymas saugioje izoliuotoje aplinkoje - Collections Search (
collections_search/file_search): Paieška anksčiau įkeltuose dokumentuose - Remote MCP (
mcp): Prisijungimas prie išorinių MCP (Model Context Protocol) serverių
Norėdamas įjungti integruotą įrankį, tiesiog pridėk jį į savo užklausos masyvą tools:
{
"tools": [{"type": "web_search"}]
}
Funkcijų kvietimas – kliento pusėje
Funkcijų kvietimas veikia kitaip. Tu apibrėži tinkintas funkcijas, kurias modelis gali iškviesti. Tačiau, skirtingai nei naudojant integruotus įrankius, funkciją vykdo tavo kliento pusės kodas, o rezultatas grąžinamas modeliui.
Procesas vyksta taip:
- Užklausoje aprašai savo funkcijas (pavadinimą, parametrus, aprašymą)
- Modelis išanalizuoja naudotojo užklausą
- Jei nustatoma, kad reikia funkcijos, jis grąžina funkcijos kvietimą su argumentais
- Tavo kodas įvykdo funkciją (API užklausą, duomenų bazės užklausą, skaičiavimą…)
- Siunti rezultatą atgal modeliui
- Modelis suformuluoja galutinį atsakymą
Šis požiūris suteikia tau visišką kontrolę: pats sprendži, ką daro tavo funkcijos, kokius duomenis jos apdoroja ir kaip jos jungiasi prie tavo infrastruktūros.
Kada naudoti kiekvieną kategoriją
Integruoti įrankiai idealiai tinka, kai reikia pasiekti naujausią informaciją (internete, socialiniuose tinkluose) arba atlikti skaičiavimus nevaldant infrastruktūros. Funkcijų kvietimas yra geresnis pasirinkimas, kai reikia sąveikauti su tavo pačių sistemomis: vidinėmis duomenų bazėmis, verslo API ar bet kuria tavo programai specifine paslauga.
Abi kategorijas gali derinti vienoje užklausoje. Pavyzdžiui, gali įjungti „Web Search“ ir tuo pačiu apibrėžti tinkintą funkciją, kuri išsaugo rezultatus į tavo duomenų bazę.
Svarbiausi punktai
- „Grok“ API siūlo dvi įrankių kategorijas: integruotus įrankius (vykdo „xAI“) ir funkcijų kvietimą (vykdo tavo kodas)
- Integruotiems įrankiams nereikia kliento pusės infrastruktūros
- Funkcijų kvietimas suteikia visišką kontrolę, tačiau reikalauja daugiau kūrimo darbo
- Abi kategorijas galima derinti vienoje užklausoje
- Šiame kurse daugiausia dėmesio skiriama trims pagrindiniams integruotiems įrankiams: „Web Search“, „X Search“ ir „Code Execution“