Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Szerver- és klienseszközök keverése

8. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Két eszközkategória ugyanazon a platformon
  2. Mindkettő kombinálása egyetlen kérésben
  3. A hibrid folyamat
  4. Valós példák
  5. Számlázás a szervereszközöknél
  6. Főbb megállapítások

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:

  1. A web_search használatára információkereséshez (automatikus szerveroldali végrehajtás)
  2. A save_to_database meghí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_call hí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