Grok-työkalujen kaksi luokkaa
Tällä sivulla
Ymmärrä Grok API:n työkaluekosysteemi
Grok API tekee muutakin kuin tuottaa tekstiä. Se tarjoaa joukon työkaluja, joiden avulla malli voi olla vuorovaikutuksessa ulkomaailman kanssa: hakea reaaliaikaista tietoa, analysoida dataa sosiaalisesta mediasta tai suorittaa Python-koodia. Jotta pystyt hyödyntämään näitä ominaisuuksia, sinun on ymmärrettävä niiden organisointi.
Grok API erottaa kaksi perustavanlaatuista työkaluluokkaa. Tämä ero määrittää, kuka suorittaa työkalun, missä käsittely tapahtuu ja mitä sinun tulee hallita kehittäjänä.
Sisäänrakennetut työkalut – palvelinpuoli
Sisäänrakennetut työkalut suoritetaan suoraan xAI:n palvelimilla. Kun malli päättää käyttää jotakin näistä työkaluista, suoritus on automaattista ja läpinäkyvää. Sinun ei tarvitse hallita infrastruktuuria eikä käsitellä välituloksia.
Tässä ovat viisi käytettävissä olevaa sisäänrakennettua työkalua:
- Web Search (
web_search): Reaaliaikainen verkkohaku, jossa on verkkotunnussuodatus ja automaattiset lähdeviitteet - X Search (
x_search): Haku X:stä/Twitteristä, jossa on tili- ja päivämääräsuodatus - Code Execution (
code_interpreter/code_execution): Python-koodin suoritus turvatussa hiekkalaatikoympäristössä - Collections Search (
collections_search/file_search): Haku aiemmin lataamistasi dokumenteista - Remote MCP (
mcp): Yhteys ulkoisiin MCP-palvelimiin (Model Context Protocol)
Ottaaksesi sisäänrakennetun työkalun käyttöön, lisää se yksinkertaisesti pyyntösi tools-taulukkoon:
{
"tools": [{"type": "web_search"}]
}
Funktion kutsuminen – asiakaspuoli
Funktion kutsuminen toimii eri tavalla. Määrittelet mukautettuja funktioita, joita malli voi kutsua. Toisin kuin sisäänrakennetuissa työkaluissa, asiakaspuolen koodisi suorittaa funktion ja palauttaa tuloksen mallille.
Virtaus etenee seuraavasti:
- Kuvailet funktiosi (nimi, parametrit, kuvaus) pyynnössä
- Malli analysoi käyttäjän pyynnön
- Jos malli toteaa funktion tarvittavan, se palauttaa funktion kutsun argumentteineen
- Koodisi suorittaa funktion (API-kutsu, tietokantakysely, laskenta…)
- Lähetät tuloksen takaisin mallille
- Malli muotoilee lopullisen vastauksensa
Tämä lähestymistapa antaa sinulle täyden hallinnan: päätät, mitä funktiosi tekevät, mitä dataa ne käsittelevät ja miten ne yhdistyvät infrastruktuuriisi.
Milloin käyttää kumpaakin luokkaa
Sisäänrakennetut työkalut ovat ihanteellisia, kun tarvitset pääsyn reaaliaikaiseen tietoon (web, sosiaalinen media) tai kun haluat suorittaa laskutoimituksia hallitsematta infrastruktuuria. Funktion kutsuminen on suositeltavaa, kun tarvitset vuorovaikutusta omien järjestelmiesi kanssa: sisäiset tietokannat, liiketoiminnan API:t tai mikä tahansa sovelluksellesi ominainen palvelu.
Voit yhdistää molemmat luokat samaan pyyntöön. Voit esimerkiksi ottaa Web Searchin käyttöön samalla kun määrittelet mukautetun funktion, joka tallentaa tulokset tietokantaasi.
Keskeiset asiat
- Grok API tarjoaa kaksi työkaluluokkaa: sisäänrakennetut työkalut (suorittaa xAI) ja funktion kutsuminen (suorittaa koodisi)
- Sisäänrakennetut työkalut eivät vaadi asiakaspuolen infrastruktuuria
- Funktion kutsuminen tarjoaa täyden hallinnan, mutta vaatii enemmän kehitystyötä
- Molemmat luokat voidaan yhdistää samaan pyyntöön
- Tämä kurssi keskittyy kolmeen tärkeimpään sisäänrakennettuun työkaluun: Web Search, X Search ja Code Execution