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

Beépített eszközök a Responses API-hoz

9. lecke 16 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. Képességek bővítése a modellnél
  2. A 4 eszköztípus
  3. Több eszköz kombinálása
  4. Szerveroldali és kliensoldali eszközök
  5. Főbb megállapítások

Képességek bővítése a modellnél

A Grok modellek nem korlátozódnak csupán szöveggenerálásra. A tools paraméter segítségével olyan eszközökhöz férhetnek hozzá, amelyek jelentősen kibővítik a lehetőségeiket: valós idejű webes keresés, keresés az X-en (korábban Twitter), Python kód futtatása és saját egyedi függvényeid.

web_search
Valós idejű webes keresés
x_search
Keresés az X-en
code
Python értelmező
function
Egyedi függvények

A 4 eszköztípus

Lehetővé teszi a modell számára, hogy valós időben keressen információkat a weben:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What's the latest news on AI in Europe?",
  "tools": [{"type": "web_search"}]
}

A modell automatikusan eldönti, mikor végezzen keresést. Az eredmények hivatkozásokkal együtt épülnek be a válaszába.

Bejegyzéseket keres az X-en (korábban Twitter):

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What is the tech community saying about the latest iPhone?",
  "tools": [{"type": "x_search"}]
}

Különösen hasznos a közvélemény, a trendek és a valós idejű reakciók feltérképezésére.

code_interpreter

Python kódot futtat szerveroldalon számításokhoz, adatelemzéshez vagy diagramok készítéséhez:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Calculate the mean and standard deviation of these values: 12, 15, 18, 22, 9, 31",
  "tools": [{"type": "code_interpreter"}]
}

A modell megírja a Python kódot, lefuttatja azt az xAI szerverein, és az eredményeket beépíti a válaszába.

function

Saját függvények, amelyeket a modell meghívhat. A modell generálja az argumentumokat, de a te kódod hajtja végre a függvényt:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What's the weather in Paris?",
  "tools": [{
    "type": "function",
    "name": "get_weather",
    "description": "Retrieves the weather for a given city",
    "parameters": {
      "type": "object",
      "properties": {
        "city": {"type": "string", "description": "City name"},
        "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
      },
      "required": ["city"]
    }
  }]
}

Több eszköz kombinálása

Egyetlen kérésben legfeljebb 128 eszközt adhatsz meg. A modell kiválasztja a megfelelő eszközt (vagy eszközöket):

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Search for the latest Ligue 1 results and create a scoreboard.",
  "tools": [
    {"type": "web_search"},
    {"type": "code_interpreter"}
  ]
}

Ebben a példában a modell először a web_search eszközt használhatja az eredmények megtalálásához, majd a code_interpreter eszközt az adatok táblázatba rendezéséhez.

Szerveroldali és kliensoldali eszközök

A megkülönböztetés alapvető fontosságú:

  • Szerveroldali eszközök (web_search, x_search, code_interpreter): Az xAI szerverei automatikusan végrehajtják ezeket. Neked semmit sem kell tenned – a modell elindítja a keresést vagy a kódfuttatást, lekéri az eredményt, és beépíti azt a válaszába.

  • Kliensoldali eszközök (function): A modell generál egy függvényhívást az argumentumokkal, majd megszakítja a generálást. A te kódod hajtja végre a függvényt, és te küldöd vissza az eredményt egy új kérésben.

Ez a különbség közvetlenül befolyásolja az alkalmazásod architektúráját, ahogy azt a következő leckékben látni fogod.

Főbb megállapítások

  • Négy eszköztípus létezik: web_search, x_search, code_interpreter, function
  • Az első három szerveroldalon fut – nincs szükséged saját infrastruktúrára
  • A function eszközök kliensoldalon futnak – a te kódod végzi a végrehajtást
  • Kérésenként legfeljebb 128 eszközt kombinálhatsz
  • A modell automatikusan eldönti, mikor és mely eszközöket használja