Egyéni függvények (függvényhívás)
Ezen az oldalon
Grok összekapcsolása a saját szolgáltatásaiddal
A szerveroldali eszközök (web_search, x_search, code_interpreter) hasznosak, de kizárólag az xAI szolgáltatásaira korlátozódnak. Egyéni function eszközökkel azonban Grokot infrastruktúrád bármely API-jához vagy szolgáltatásához csatlakoztathatod.
Hogyan működik
A függvényhívás egy három lépésből álló ciklus:
- Deklaráció: A kérésben leírod a függvényeidet (név, leírás, paraméterek).
- Hívás: A modell generál egy függvényhívást a megfelelő argumentumokkal, majd megszakítja a generálást.
- Eredmény: A kódod végrehajtja a függvényt, majd visszaküldöd az eredményt a modellnek, hogy az megfogalmazhassa a válaszát.
Függvény deklarálása
{
"model": "grok-4.20-0309-reasoning",
"input": "Foglalj asztalt 2 főre ma este 8 órára.",
"tools": [{
"type": "function",
"name": "book_restaurant",
"description": "Asztalfoglalás egy étteremben",
"parameters": {
"type": "object",
"properties": {
"restaurant_name": {
"type": "string",
"description": "Az étterem neve"
},
"date": {
"type": "string",
"description": "Dátum ÉÉÉÉ-HH-NN formátumban"
},
"time": {
"type": "string",
"description": "Időpont ÓÓ:PP formátumban"
},
"guests": {
"type": "integer",
"description": "Vendégek száma"
}
},
"required": ["date", "time", "guests"]
}
}]
}
Minden függvény és paraméter leírása döntő fontosságú. A modell ezeket használja annak eldöntésére, mikor hívja meg a függvényt, és hogyan töltse ki az argumentumokat.
A függvényhívás fogadása
Amikor a modell úgy dönt, hogy meghívja a függvényedet, a válasz tartalmaz egy function_call elemet:
{
"id": "resp-xyz789",
"status": "completed",
"output": [{
"type": "function_call",
"name": "book_restaurant",
"arguments": "{\"date\": \"2026-04-03\", \"time\": \"20:00\", \"guests\": 2}",
"call_id": "call-abc123"
}]
}
Az arguments mező egy JSON-karakterlánc, amelyet elemezned (parse) kell. A call_id azonosítja ezt a konkrét hívást.
Az eredmény visszaküldése
Miután a kódod végrehajtotta a függvényt, küldd vissza az eredményt:
import json
# 1. Kezdeti kérés
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Milyen az időjárás Párizsban?",
tools=[{
"type": "function",
"name": "get_weather",
"description": "Lekéri az aktuális időjárást",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string"}
},
"required": ["city"]
}
}]
)
# 2. Ellenőrizd, hogy a modell függvényt akar-e hívni
for item in response.output:
if item.type == "function_call":
args = json.loads(item.arguments)
# 3. Hajtsd végre a függvényedet
weather_data = get_weather_from_api(args["city"])
# 4. Küldd vissza az eredményt a modellnek
final = client.responses.create(
model="grok-4.20-0309-reasoning",
input=[{
"type": "function_call_output",
"call_id": item.call_id,
"output": json.dumps(weather_data)
}],
previous_response_id=response.id
)
print(final.output[0].content[0].text)
Legjobb gyakorlatok a leírásokhoz
A modell a leírások alapján érti meg a függvényeidet. Légy precíz:
{
"name": "search_products",
"description": "Termékek keresése az e-kereskedelmi katalógusban. Visszaadja a relevancia szerint rendezett legjobb 10 találatot. Támogatja a keresést név, kategória vagy ártartomány alapján.",
"parameters": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Keresési kifejezések (terméknév, márka, kulcsszó)"
},
"category": {
"type": "string",
"enum": ["electronics", "clothing", "home", "sports"],
"description": "Szűrendő termékkategória"
},
"max_price": {
"type": "number",
"description": "Maximális ár euróban"
}
},
"required": ["query"]
}
}
Használj enum-ot az előre definiált értékekhez, részletes description-t minden paraméterhez, és csak a lényeges paramétereket jelöld required-ként.
Hibakezelés
Ha a függvényed hibázik, add vissza a hibát eredményként:
try:
result = call_external_api(args)
output = json.dumps(result)
except Exception as e:
output = json.dumps({"error": str(e)})
final = client.responses.create(
model="grok-4.20-0309-reasoning",
input=[{
"type": "function_call_output",
"call_id": call_id,
"output": output
}],
previous_response_id=response.id
)
A modell értelmezi a hibát, és átfogalmazhatja a válaszát, vagy más megközelítést próbálhat ki.
Főbb megállapítások
- Az egyéni függvények összekötik Grokot a saját szolgáltatásaiddal
- A ciklus: deklaráld, fogadd a hívást, hajtsd végre, küldd vissza az eredményt
- A függvény- és paraméterleírások irányítják a modell döntését
- Az
argumentsmező egy JSON-karakterlánc, amelyet a kliens oldalon kell elemezni - A hibákat eredményként add vissza, hogy a modell alkalmazkodhasson