Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Grok-työkalujen kaksi luokkaa

Oppitunti 1 / 16 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Ymmärrä Grok API:n työkaluekosysteemi
  2. Sisäänrakennetut työkalut – palvelinpuoli
  3. Funktion kutsuminen – asiakaspuoli
  4. Milloin käyttää kumpaakin luokkaa
  5. Keskeiset asiat

Ymmärrä Grok API:n työkaluekosysteemi

Yleiskatsaus dokumentaation työkaluihin 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.

🔍
Web Search
Real-time web search
𝕏
X Search
Search on X/Twitter
🐍
Code Execution
Isolated Python sandbox
📁
Collections Search
Search within your documents
🔌
Remote MCP
External MCP servers

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:

  1. Kuvailet funktiosi (nimi, parametrit, kuvaus) pyynnössä
  2. Malli analysoi käyttäjän pyynnön
  3. Jos malli toteaa funktion tarvittavan, se palauttaa funktion kutsun argumentteineen
  4. Koodisi suorittaa funktion (API-kutsu, tietokantakysely, laskenta…)
  5. Lähetät tuloksen takaisin mallille
  6. 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