Szerver- és klienseszközök keverése
Ezen az oldalon
Két eszközkategória ugyanazon a platformon
A Grok API a végrehajtás módja alapján két alapvetően eltérő eszköztípust különböztet meg. E különbség megértése elengedhetetlen a robusztus architektúrák tervezéséhez.
Beépített eszközök (szerveroldali)
Ezeket az eszközöket az xAI automatikusan hajtja végre a saját szerverein. Neked semmit sem kell kezelned – nincs helyi végrehajtás, nincs eredménytovábbítás. A modell meghívja őket, és közvetlenül megkapja az eredményeket.
| Eszköz | Azonosító | Leírás |
|---|---|---|
| Web Search | web_search | Valós idejű webes keresés |
| X Search | x_search | Keresés az X/Twitter platformon |
| Code Interpreter | code_interpreter | Homokozózott Python-végrehajtás |
| Collections Search | collections_search | Keresés a feltöltött dokumentumaid között |
| Remote MCP | mcp | Kapcsolódás külső MCP-szerverekhez |
Egyéni függvények (kliensoldali)
Ezek a saját függvényeid, amelyeket function calling útján definiálsz. A modell visszaad egy tool_call hívást, a te kódod futtatja le a függvényt, majd te küldöd vissza az eredményt. Ez az a mechanizmus, amit az előző leckékben tanultál.
Mindkettő kombinálása egyetlen kérésben
A Grok API ereje abban rejlik, hogy egyetlen kérésben keverheted a szerver- és klienseszközöket:
tools = [
# Szervereszköz – az xAI automatikusan végrehajtja
{"type": "web_search"},
# Klienseszköz – a te kódod hajtja végre
{
"type": "function",
"function": {
"name": "save_to_database",
"description": "Információ mentése az adatbázisba",
"parameters": {
"type": "object",
"properties": {
"key": {"type": "string"},
"value": {"type": "string"}
},
"required": ["key", "value"]
}
}
}
]
Amikor a modell megkapja ezt a kérést, képes:
- A
web_searchhasználatára információkereséshez (automatikus szerveroldali végrehajtás) - A
save_to_databasemeghívására az eredmény mentéséhez (visszaküldés a kliensnek)
A hibrid folyamat
A viselkedés eszköztípusonként eltér:
- Szervereszköz: a modell meghívja az eszközt, az xAI végrehajtja, az eredmény automatikusan integrálódik, a modell folytatja a munkát
- Klienseszköz: a modell visszaadja a
tool_callhívást a kliensnek, a végrehajtás leáll, és csak akkor folytatódik, amikor te visszaküldöd az eredményt
Ha a modell ugyanabban a kérésben mindkét típust használja, a szervereszközök futnak le először (a te beavatkozásod nélkül). Ezután, ha a modellnek klienseszközre is szüksége van, visszaadja neked a tool_call hívást úgy, hogy a szervereszközök eredményei már integrálódtak a kontextusába.
Valós példák
Webes keresés + üzleti logika
# Felhasználói kérés: „Keresd meg a Bitcoin árát, és mentsd el“
# A modell:
# 1. Meghívja a web_search-t az ár megtalálásához (szerveroldali, automatikus)
# 2. Meghívja a save_price(symbol="BTC", price=68432) függvényt (kliensoldali)
X-keresés + értesítés
# „Értesíts, ha tegnap óta tweeteltek a termékünkről“
# A modell:
# 1. Meghívja az x_search-t a tweetek megtalálásához (szerveroldali)
# 2. Meghívja a send_notification(count=12, summary="...") függvényt (kliensoldali)
Kódértelmező + tárolás
# „Számold ki ennek az adathalmaznak az átlagát, és mentsd el az eredményt“
# A modell:
# 1. Meghívja a code_interpreter-t a számításhoz (szerveroldali)
# 2. Meghívja a save_result(key="avg", value="42.5") függvényt (kliensoldali)
Számlázás a szervereszközöknél
A beépített eszközök kétféleképpen kerülnek számlázásra:
- Tokenek: szabványos fogyasztás (bemenet + kimenet)
- Meghívások: fix költség eszközhívásonként
A modell egyetlen kérés során több szervereszközt is meghívhat – a költségek összeadódnak. Tartsd ezt észben, amikor engedélyezed a web_search használatát: a modell több keresést is végezhet az eredmények pontosítása érdekében.
Főbb megállapítások
- Két eszköztípus létezik: szerver (automatikus) és kliens (function calling)
- A szervereszközök (
web_search,x_search,code_interpreter) a te beavatkozásod nélkül futnak le - Mindkét típust keverheted egyetlen kérésben
- A szervereszközök futnak le először, ezt követően hívhatja meg a modell a te függvényeidet
- Minden szervereszköz-meghívás számlázásra kerül (tokenek + hívásonkénti költség)
- A szervereszközökből származó adatokhoz automatikusan hivatkozások (citations) generálódnak