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

Eszközök a szerveren és függvényhívás

10. lecke 12 közül Frissítve 2026. november 2. Fejlesztő
Ezen az oldalon
  1. Kötegek gazdagítása eszközökkel
  2. Szerveroldali eszközök
  3. Kliensoldali függvényhívás
  4. Eszközök kombinálása
  5. A kötegelt eszközök korlátai
  6. Főbb megállapítások

A tanfolyam frissítve: 2026. november 2. az xAI dokumentációja alapján: a kötegelt kedvezmény 20% a jogosult szöveges modelleken (nem 50%), a példák a REST API-t és a hivatalos xai-sdk-t (client.batch.*) követik (az xAI Batch API-ja nem az OpenAI formátumát használja, az OpenAI SDK nem alkalmazható), és a Responses API elsőbbséget élvez a Chat Completions felett, amely az xAI-nál már elavult végpont. Források: Batch API · REST Referencia · Batch Árazás.

Kötegek gazdagítása eszközökkel

A kötegelt kérések nem korlátozódnak nyers szövegre. A szerveroldali eszközök és a függvényhívás aszinkron módban is működnek, egy kulcsfontosságú különbséggel: az előbbiek az xAI feldolgozása során futnak, míg az utóbbi visszaadja az irányítást neked.

Szerveroldali eszközök

A szerveroldali eszközök a kötegelt feldolgozás során futnak, pontosan úgy, mint valós időben: a Grok meghívja az eszközt, megkapja az eredményt, beépíti azt a következtetési folyamatába, és a köteg visszaküldi a végső választ. Ezek a Responses API-val működnek.

Webes keresés

{"custom_id": "news-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What are the latest developments in quantum computing?"}], "tools": [{"type": "web_search"}]}}

Kötegelt módban a webes keresés az adatok gazdagítását szolgálja: információk ellenőrzése, friss tények gyűjtése, profilok összehasonlítása online forrásokkal.

X keresés

Az x_search eszköz posztokat kérdez le az X-en, ami hasznos egy téma vagy márka körüli hangulat nyomon követésére:

{"custom_id": "x-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What is the dominant sentiment on X regarding this product launch?"}], "tools": [{"type": "x_search"}]}}

Kódfuttatás

A Grok képes Python kódot írni és futtatni egy elszigetelt környezetben. A Responses API-ban az eszközt code_interpreter-nek hívják (az xAI SDK code_execution néven hivatkozik rá):

{"custom_id": "calc-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Calculate the 3-point moving average for this data: [12, 15, 18, 14, 22, 19, 25, 28, 30, 27]"}], "tools": [{"type": "code_interpreter"}]}}

A kódfuttatás akkor releváns, ha pontos számításokra, statisztikákra vagy adattranszformációkra van szükség, amelyeket a modell a memóriájából kevésbé megbízhatóan kezelne.

Távoli MCP szerverek

Az mcp eszköz összeköti a Grok-ot egy távoli MCP szerverrel, amelyet maga a kérés ír le: nincs szükség előzetes fiókkonfigurációra. A server_url és a server_label kötelező; az allowed_tools korlátozza a kitett eszközöket, az authorization pedig tokent ad át a szervernek. Csak a Streamable HTTP és az SSE transzportok elfogadottak.

{"custom_id": "mcp-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What does the xai-sdk-python repository do?"}], "tools": [{"type": "mcp", "server_label": "deepwiki", "server_url": "https://mcp.deepwiki.com/mcp"}]}}

Az allowed_tools nélkül a szerver összes eszközdefiníciója bekerül a modell kontextusába, és minden egyes kötegelt kérésnél bemeneti tokenként kerül elszámolásra: 50 000 kérésnél a lista korlátozása gyorsan megtérül.

Kliensoldali függvényhívás

A függvényhívás egy kliensoldali eszköz: a Grok strukturált függvényhívást generál, de a te kódod hajtja végre azt. Kötegelt módban a modell ezeket a hívásokat az eredményeiben adja vissza, offline feldolgozásra.

Függvénydefiníciók

A Responses API-ban a függvényt laposan deklarálod, a name, description és parameters mezőkkel a legfelső szinten. A tool_choice: "required" beállítás arra kényszeríti a modellt, hogy legalább egy eszközt hívjon meg, ami kiválóan alkalmas kinyerésre:

{"custom_id": "extract-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Extract the contact: Jean Dupont, 01 23 45 67 89, [email protected]"}], "tools": [{"type": "function", "name": "save_contact", "description": "Saves a contact extracted from text", "parameters": {"type": "object", "properties": {"name": {"type": "string"}, "phone": {"type": "string"}, "email": {"type": "string"}}, "required": ["name"]}}], "tool_choice": "required"}}

Eredmények feldolgozása

Az SDK segítségével az egyes sikeres eredmények tool_calls mezőjében olvashatod ki a függvényhívásokat:

import json

for r in page.succeeded:
    for call in r.response.tool_calls:
        if call.function.name == "save_contact":
            contact = json.loads(call.function.arguments)
            save_to_database(r.batch_request_id, contact)

A kötegelt függvényhívás ideális strukturált kinyeréshez: te definiálod az adatasémát, a Grok beolvassa a dokumentumokat és előállítja a hívásokat, majd te tömbösen feldolgozod azokat.

Eszközök kombinálása

Több szerveroldali eszközt is kombinálhatsz egyetlen kérésen belül:

{"custom_id": "multi-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Find the Bitcoin closing price for the last seven days and calculate its change"}], "tools": [{"type": "web_search"}, {"type": "code_interpreter"}]}}

A Grok a számára releváns sorrendben használja az eszközöket: itt először a webes keresést az adatok megszerzéséhez, majd a kódfuttatást a számításhoz.

A kötegelt eszközök korlátai

  • A szerveroldali eszközök növelik az egyes kérések, és így a teljes köteg feldolgozási idejét.
  • A keresést tartalmazó kérések attól függenek, hogy mit tesznek közzé a források a feldolgozás időpontjában, nem a beküldés időpontjában.
  • A függvényhívás csak egy oda-vissza utat tesz meg kérésenként: a folytatáshoz egy új kötegelt kérést kell benyújtanod, amely tartalmazza a beszélgetést és a függvényeredményeidet.
  • A szűretlen MCP eszközdefiníciók felfújnak minden egyes kérést.

Főbb megállapítások

  • A szerveroldali eszközök (web, X, kód, MCP) az xAI által futnak a feldolgozás során, a Responses API-n keresztül.
  • Írd le az MCP szervert a kérésben (server_url, server_label), előzetes konfiguráció nélkül.
  • A függvényhívás strukturált hívásokat ad vissza, amelyeket te hajtasz végre a kliensoldalon.
  • A többmenetes párbeszédhez menetenként új kötegelt kérés szükséges.
  • Korlátozd a kitett eszközöket, hogy elkerüld azok definíciójának kifizetését minden egyes kérésnél.