Beépített eszközök a Responses API-hoz
Ezen az oldalon
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.
A 4 eszköztípus
web_search
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.
x_search
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
functioneszkö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