Funktionkutsujen ymmärtäminen
Tällä sivulla
Mikä on funktionkutsu?
Funktionkutsu on yksi Grok API:n tehokkaimmista ominaisuuksista. Se antaa mallille mahdollisuuden pyytää määrittämiesi funktioiden suorittamista tietojen hakemiseksi tai toimintojen toteuttamiseksi todellisessa maailmassa.
Tärkein ymmärrettävä seikka: Grok ei koskaan suorita funktioita itse. Malli analysoi pyyntösi, toteaa tarvitsevansa ulkoista tietoa ja palauttaa sinulle jäsennellyn kutsun (funktion nimi + argumentit). Sinun asiakaspuolen koodisi suorittaa varsinaisen funktion ja lähettää tuloksen takaisin mallille.
Kuuden vaiheen kulku
Jokainen funktionkutsuun perustuva vuorovaikutus noudattaa tarkkaa kuuden vaiheen sykliä. Tämä kulku on perustavanlaatuinen – se määrittää koko arkkitehtuurisi.
Määritä työkalut
Kuvaat funktiosi JSON-skeemoilla: nimi, kuvaus ja odotetut parametrit.
Lähetä pyyntö
Lähetät käyttäjän viestin yhdessä työkalumääritelmien kanssa API:lle.
Vastaanota tool_call
Malli palauttaa tool_call-objektin, joka sisältää funktion nimen ja JSON-argumentit.
Suorita funktio
Asiakaspuolen koodisi suorittaa varsinaisen funktion (API-kutsu, tietokantakysely, laskenta...).
Palauta tulos
Lähetät suorituksen tuloksen takaisin mallille viestinä, jossa on tool-rooli.
Lopullinen vastaus
Malli integroi tuloksen ja tuottaa luonnollisen kielen vastauksen käyttäjälle.
Miksi funktionkutsu on niin tärkeä?
Ilman funktionkutsua kielimalli rajoittuu pelkkään koulutusdataansa. Se ei voi hakea tietoa tietokannasta, kysyä kolmannen osapuolen API:lta tai tehdä reaaliaikaisia laskutoimituksia. Funktionkutsu ratkaisee tämän perustavanlaatuisen ongelman antamalla mallille kyvyn vuorovaikuttaa ulkomaailman kanssa jäsennellyllä ja hallitulla tavalla.
Tässä muutama konkreettinen käyttötapa:
- Reaaliaikainen data: sää, osakekurssit, tilausten status
- Liiketoimintatoimet: tiketin luominen, sähköpostin lähetys, ajan varaaminen
- Tarkat laskelmat: matemaattiset operaatiot, muunnokset, aggregoinnit
- Tietokannat: tuotuhaku, asiakashistoria, varastosaldo
Ero tavalliseen kehotteeseen
Tavallisessa vuorovaikutuksessa esität kysymyksen ja malli vastaa suoraan. Funktionkutsun avulla malli voi keskeyttää vastauksensa pyytääkseen lisätietoja funktionkutsun kautta. Juuri tämä kyky keskeyttää generointivirta tekee mekanismista niin tehokkaan.
Malli päättelee seuraavasti: “Vastatakseni tähän kysymykseen tarvitsen Pariisin tämänhetkisen sään. Kutsun funktiota get_weather parametrilla city: Paris.”
Huomioitavat rajoitukset
Grok API hyväksyy enintään 200 työkalua pyyntöä kohden. Tämä riittää useimpiin käyttötarkoituksiin, mutta pidä mielessä, että jokainen työkalumääritelmä kuluttaa input-tokensia. Mitä enemmän työkaluja määrität, sitä kalliimmaksi pyyntö tulee – ja sitä kauemmin mallilta kestää oikean työkalun valitseminen.
Keskeiset asiat
- Funktionkutsu antaa mallille mahdollisuuden pyytää funktioiden suorittamista, ei suorittaa niitä itse
- Kulku noudattaa aina kuutta vaihetta: määritä, lähetä, vastaanota, suorita, palauta, vastaa
- Funktiot suoritetaan asiakaspuolella, sinun koodissasi
- Enintään 200 työkalua pyyntöä kohden
- Jokainen työkalumääritelmä kuluttaa tokeneita – ole valikoiva