Groki tööriistade kaks kategooriat
Sellel lehel
Mõista Groki API tööriistade ökosüsteemi
Groki API ei piirdu ainult teksti genereerimisega. See pakub tööriistade komplekti, mis võimaldab mudelil suhelda välismaailmaga: otsida reaalajas teavet, analüüsida sotsiaalmeedia andmeid või käivitada Pythoni koodi. Nende võimaluste ärakasutamiseks pead mõistma, kuidas need on organiseeritud.
Groki API eristab kahte põhilist tööriistade kategooriat. See eristus määrab, kes tööriista käivitab, kus toimub töötlemine ja mida pead arendajana haldama.
Sisseehitatud tööriistad – serveripoolne
Sisseehitatud tööriistad käivituvad otse xAI serverites. Kui mudel otsustab üht neist kasutada, toimub täitmine automaatselt ja läbipaistvalt. Sa ei pea haldama mingit taristut ega töötlema vahepealseid tulemusi.
Siin on viis saadaolevat sisseehitatud tööriista:
- Web Search (
web_search): Reaalajas veebiotsing koos domeenifiltreerimise ja automaatsete viidetega - X Search (
x_search): Otsing X-is/Twitteris koos konto ja kuupäeva filtreerimisega - Code Execution (
code_interpreter/code_execution): Pythoni koodi käivitamine turvalises liivakastis - Collections Search (
collections_search/file_search): Otsing eelnevalt üles laaditud dokumentidest - Remote MCP (
mcp): Ühendus väliste MCP (Model Context Protocol) serveritega
Sisseehitatud tööriista lubamiseks lisa see lihtsalt oma päringus olevasse tools massiivi:
{
"tools": [{"type": "web_search"}]
}
Funktsioonide kutsumine – kliendipoolne
Funktsioonide kutsumine (Function Calling) toimib teistmoodi. Sa defineerid kohandatud funktsioonid, mida mudel saab kutsuda. Erinevalt sisseehitatud tööriistadest käivitab funktsiooni sinu kliendipoolne kood ja tagastab tulemuse mudelile.
Voog toimub järgmiselt:
- Kirjeldad oma päringus funktsioone (nimi, parameetrid, kirjeldus)
- Mudel analüüsib kasutaja päringut
- Kui ta tuvastab funktsiooni vajaduse, tagastab ta funktsioonikutse argumentidega
- Sinu kood käivitab funktsiooni (API päring, andmebaasipäring, arvutus jne)
- Saadad tulemuse mudelile tagasi
- Mudel formuleerib oma lõpliku vastuse
See lähenemine annab sulle täieliku kontrolli: sina otsustad, mida sinu funktsioonid teevad, milliste andmetega need töötavad ja kuidas need sinu taristuga ühenduvad.
Millal kumbagi kategooriat kasutada
Sisseehitatud tööriistad on ideaalsed, kui vajad juurdepääsu reaalajas teabele (veeb, sotsiaalmeedia) või pead tegema arvutusi ilma taristut haldamata. Funktsioonide kutsumine on eelistatud, kui pead suhtlema oma süsteemidega: sisemiste andmebaaside, äri-API-de või mis tahes sinu rakendusele spetsiifiliste teenustega.
Saad mõlemat kategooriat ühes päringus kombineerida. Näiteks saad lubada veebiotsingu ja samal ajal defineerida kohandatud funktsiooni, mis salvestab tulemused sinu andmebaasi.
Peamised punktid
- Groki API pakub kahte tööriistade kategooriat: sisseehitatud tööriistad (täidab xAI) ja funktsioonide kutsumine (täidab sinu kood)
- Sisseehitatud tööriistad ei nõua kliendipoolset taristut
- Funktsioonide kutsumine pakub täielikku kontrolli, kuid nõuab rohkem arendustööd
- Mõlemat kategooriat saab ühes päringus kombineerida
- See kursus keskendub kolmele peamisele sisseehitatud tööriistale: Web Search, X Search ja Code Execution