A függvényhívás megértése
Ezen az oldalon
Mi az a függvényhívás?
A függvényhívás a Grok API egyik leghatékonyabb funkciója. Lehetővé teszi a modell számára, hogy végrehajtást kérjen az általad definiált függvényektől adatok lekéréséhez vagy valós világbeli műveletek elvégzéséhez.
A legfontosabb tudnivaló: a Grok sosem hajtja végre maga a függvényeket. A modell elemzi a kérésedet, felismeri, hogy külső információra van szüksége, majd egy strukturált hívást (függvénynév + argumentumok) küld vissza neked. A kliens oldali kódod hajtja végre ténylegesen a függvényt, majd elküldi az eredményt a modellnek.
A 6 lépésből álló folyamat
Minden függvényhívási interakció egy pontos, hatlépéses ciklust követ. Ez a folyamat alapvető fontosságú – ez határozza meg a teljes architektúrádat.
Eszközök definiálása
JSON sémákkal írod le a függvényeidet: név, leírás, várt paraméterek.
Kérés elküldése
Elküldöd a felhasználói üzenetet az eszközmeghatározásokkal együtt az API-nak.
A tool_call fogadása
A modell visszaad egy tool_call objektumot a függvénynévvel és a JSON argumentumokkal.
Függvény végrehajtása
A kliens oldali kódod hajtja végre a tényleges függvényt (API-hívás, adatbázis-lekérdezés, számítás stb.).
Eredmény visszaküldése
Elküldöd a végrehajtás eredményét a modellnek egy üzenetben, tool szerepkörrel.
Végső válasz
A modell integrálja az eredményt, és természetes nyelvű választ generál a felhasználónak.
Miért olyan fontos a függvényhívás?
Függvényhívás nélkül a nyelvi modell csak a betanítási tudására korlátozódik. Nem tud adatbázist lekérdezni, harmadik féltől származó API-t hívni, vagy valós idejű számításokat végezni. A függvényhívás ezt az alapvető problémát oldja meg azzal, hogy lehetőséget ad a modellnek a külvilággal való interakcióra strukturált és ellenőrzött módon.
Íme néhány konkrét alkalmazási eset:
- Valós idejű adatok: időjárás, részvényárak, rendelési állapotok
- Üzleti műveletek: jegy létrehozása, e-mail küldése, időpont foglalása
- Pontos számítások: matematikai műveletek, átváltások, aggregációk
- Adatbázisok: termékkeresés, ügyféltörténet, készletnyilvántartás
Különbség a szabványos promptokhoz képest
Egy szabványos beszélgetésben felteszel egy kérdést, a modell pedig közvetlenül válaszol. Függvényhívás esetén a modell megszakíthatja a válaszadást, hogy egy függvényhívással további információt kérjen. Ez a képesség a generálási folyamat megszakítására teszi ezt a mechanizmust olyan erőteljessé.
A modell így gondolkodik: „Ahhoz, hogy megválaszoljam ezt a kérdést, szükségem van Párizs aktuális időjárására. Meghívom a get_weather függvényt a city: Paris paraméterrel.“
Ismerendő korlátok
A Grok API kérésenként legfeljebb 200 eszközt fogad el. Ez a legtöbb alkalmazási esetre bőven elég, de ne feledd: minden eszközmeghatározás bemeneti tokeneket fogyaszt. Minél több eszközt deklarál, annál drágább lesz a kérés, és annál tovább tart a modellnek a megfelelő eszköz kiválasztása.
Főbb megállapítások
- A függvényhívás lehetővé teszi a modell számára, hogy kérje a függvények végrehajtását, de nem hajtja végre azokat maga
- A folyamat mindig 6 lépésből áll: definiálás, küldés, fogadás, végrehajtás, visszaküldés, válaszadás
- A függvények kliens oldalon, a te kódodban futnak
- Kérésenként maximum 200 eszköz használható
- Minden eszközmeghatározés tokeneket fogyaszt – légy válogatós