A Grok-eszközök két kategóriája
Ezen az oldalon
Ismerd meg a Grok API eszközeinek ökoszisztémáját
A Grok API nem csupán szöveg generálására képes. Olyan eszközök készletét biztosítja, amelyekkel a modell kapcsolatba léphet a külvilággal: valós idejű információkat kereshet, adatokat elemezhet a közösségi médiában, vagy Python-kódot futtathat. Ezen képességek kiaknázásához meg kell értened, hogyan vannak ezek szervezve.
A Grok API az eszközök két alapvető kategóriáját különbözteti meg. Ez a megkülönböztetés határozza meg, hogy ki hajtja végre az eszközt, hol történik a feldolgozás, és neked fejlesztőként mit kell kezelned.
Beépített eszközök — Szerveroldali
A beépített eszközök közvetlenül az xAI szerverein futnak. Amikor a modell úgy dönt, hogy használja az egyiket, a végrehajtás automatikus és átlátható. Neked nem kell semmilyen infrastruktúrát kezelned, sem közbenső eredményeket feldolgoznod.
Íme az öt elérhető beépített eszköz:
- Web Search (
web_search): Valós idejű webes keresés, doménszűréssel és automatikus hivatkozásokkal - X Search (
x_search): Keresés az X/Twitter platformon, fiók és dátum szerinti szűréssel - Code Execution (
code_interpreter/code_execution): Python-kód futtatása biztonságos, homokozó környezetben - Collections Search (
collections_search/file_search): Keresés a korábban feltöltött dokumentumaid között - Remote MCP (
mcp): Kapcsolódás külső MCP (Model Context Protocol) szerverekhez
Egy beépített eszköz engedélyezéséhez egyszerűen add hozzá a tools tömbhöz a kérésedben:
{
"tools": [{"type": "web_search"}]
}
Függvényhívás (Function Calling) — Kliensoldali
A függvényhívás másképp működik. Te határozod meg azokat az egyéni függvényeket, amelyeket a modell meghívhat. A beépített eszközökkel ellentétben azonban itt a te kliensoldali kódod hajtja végre a függvényt, és adja vissza az eredményt a modellnek.
A folyamat a következő:
- Leírod a függvényeidet (név, paraméterek, leírás) a kérésben
- A modell elemzi a felhasználó kérését
- Ha úgy ítéli meg, hogy szükség van egy függvényre, visszaad egy függvényhívást az argumentumokkal
- A te kódod végrehajtja a függvényt (API-hívás, adatbázis-lekérdezés, számítás stb.)
- Visszaküldöd az eredményt a modellnek
- A modell megfogalmazza a végső válaszát
Ez a megközelítés teljes kontrollt biztosít: te döntöd el, mit csinálnak a függvényeid, milyen adatokat kezelnek, és hogyan kapcsolódnak az infrastruktúrádhoz.
Mikor melyik kategóriát használd?
A beépített eszközök ideálisak, amikor valós idejű információkra (web, közösségi média) van szükséged, vagy számításokat kell futtatnod infrastruktúra-kezelés nélkül. A függvényhívás akkor előnyös, ha a saját rendszereiddel kell interagálnod: belső adatbázisokkal, üzleti API-kkal vagy bármilyen, az alkalmazásodra specifikus szolgáltatással.
Mindkét kategória kombinálható egyetlen kérésben. Például engedélyezheted a Web Search funkciót, miközben definiálsz egy egyéni függvényt, amely elmenti az eredményeket az adatbázisodba.
Főbb megállapítások
- A Grok API az eszközök két kategóriáját kínálja: beépített eszközök (az xAI hajtja végre) és függvényhívás (a te kódod hajtja végre)
- A beépített eszközök nem igényelnek kliensoldali infrastruktúrát
- A függvényhívás teljes kontrollt biztosít, de több fejlesztési munkát igényel
- Mindkét kategória kombinálható egyetlen kérésben
- Ez a tanfolyam a három fő beépített eszközre fókuszál: Web Search, X Search és Code Execution