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

Egyéni függvények (függvényhívás)

11. lecke 16 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. Grok összekapcsolása a saját szolgáltatásaiddal
  2. Hogyan működik
  3. Függvény deklarálása
  4. A függvényhívás fogadása
  5. Az eredmény visszaküldése
  6. Legjobb gyakorlatok a leírásokhoz
  7. Hibakezelés
  8. Főbb megállapítások

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:

  1. Deklaráció: A kérésben leírod a függvényeidet (név, leírás, paraméterek).
  2. Hívás: A modell generál egy függvényhívást a megfelelő argumentumokkal, majd megszakítja a generálást.
  3. 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 arguments mező egy JSON-karakterlánc, amelyet a kliens oldalon kell elemezni
  • A hibákat eredményként add vissza, hogy a modell alkalmazkodhasson