Eszközök a szerveren és függvényhívás
Ezen az oldalon
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.