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

OpenAI SDK kompatibilitás

6. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Többügynökös mód használata az OpenAI SDK-n keresztül
  2. Kliens konfiguráció
  3. Ügynökök számának vezérlése a reasoning.effort paraméterrel
  4. Az erőfeszítés → ügynökök leképezése
  5. A Chat Completions nem támogatott
  6. Streamelés az OpenAI SDK-val
  7. A megközelítés előnyei és korlátai
  8. Főbb megállapítások

Többügynökös mód használata az OpenAI SDK-n keresztül

Számos csapat már az OpenAI SDK köré építette a hívási rétegét, a saját wrapperjeivel, tesztjeivel és naplózási szokásaival. Jó hír: a Grok többügynökös módjának eléréséhez nem kell mindent újraírnod. Az xAI egy az OpenAI Responses formátumával kompatibilis API-t tesz közzé, így megtarthatod az OpenAI klienst, és egyszerűen az xAI API-ra irányíthatod azt.

Kliens konfiguráció

Csak két beállításra van szükséged: az xAI alap URL-jére és az xAI API-kulcsodra.

from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1",
)

Innentől kezdve a Responses API-t a szokásos módon használhatod, ahol a modellt grok-4.20-multi-agent-0309-ként adod meg. A hívási kódod többi része változatlan marad.

Ügynökök számának vezérlése a reasoning.effort paraméterrel

Itt történik meg a fordítás a két világ között. Míg az xAI SDK egy explicit agent_count paramétert tesz elérhetővé, addig az OpenAI SDK csak a reasoning.effort lehetőséget kínálja – tehát nem az ügynökök számát kéred közvetlenül, hanem egy erőfeszítési szintet, amelyet az xAI átalakít egy konkrét ügynökszámmá.

# 4 ügynök (alacsony erőfeszítés)
response = client.responses.create(
    model="grok-4.20-multi-agent-0309",
    reasoning={"effort": "low"},
    input=[{"role": "user", "content": "Mik a legfrissebb nyílt forráskódú modellek 2026-ból?"}],
)
print(response.output_text)
# 16 ügynök (magas erőfeszítés)
response = client.responses.create(
    model="grok-4.20-multi-agent-0309",
    reasoning={"effort": "high"},
    input=[{"role": "user", "content": "Hasonlítsd össze az EU és az USA AI stratégiáit 2026-ban"}],
)
print(response.output_text)

Az erőfeszítés → ügynökök leképezése

A mező négy értéket fogad el, de ezek csak két csapatméretet eredményeznek: a "low" és a "medium" 4 ügynököt használ, míg a "high" és az "xhigh" 16-ot.

Ez a részlet alapos figyelmet érdemel. Ha low-ról medium-ra, vagy high-ról xhigh-ra váltasz, az ügynökök száma nem változik: ezek a köztes szintek a modell viselkedésének egyéb aspektusait befolyásolhatják, de minden egyes páron belül a csapat mérete állandó. Képzeld el egy felületet, ahol a felhasználónak a kutatás mélységének négy szintjét kínálod fel – ők csak kettőt érzékelnek majd, és a két extra gombjuk csak összezavarná a választásukat.

A Chat Completions nem támogatott

Íme az a korlátozás, amin a fejlesztők többsége első próbálkozásra elbukik: a Chat Completions nem támogatott a többügynökös módhoz. A Responses API-t kell használnod, ami azt jelenti, hogy a client.responses.create metódust hívod meg, nem pedig a client.chat.completions.create-et.

# NEM MŰKÖDIK
response = client.chat.completions.create(
    model="grok-4.20-multi-agent-0309",
    messages=[{"role": "user", "content": "..."}],
)

Ez a hívás hibát ad vissza. Ha a meglévő kódod kizárólag a Chat Completions-re támaszkodik – ahogy sok régi kódbase teszi –, akkor a változtatás nem csupán a modell nevének cseréjét jelenti: át kell migrálnod a hívást egy másik bemeneti és kimeneti formátumra. Becsüld fel ezt a ráfordítást, mielőtt ígéretet tennél az integrációra.

Streamelés az OpenAI SDK-val

A streamelés továbbra is elérhető, szintén a Responses API-n keresztül:

stream = client.responses.create(
    model="grok-4.20-multi-agent-0309",
    reasoning={"effort": "low"},
    input=[{"role": "user", "content": "Foglald össze ezen hét technológiai bejelentéseit"}],
    stream=True,
)

for event in stream:
    if hasattr(event, 'delta') and event.delta:
        print(event.delta, end="", flush=True)

Érdemes meghagyni a hasattr(event, 'delta') ellenőrzést olyannak, amilyen: a Responses API eseményfolyama többet tartalmaz, mint pusztán szöveget, és ha vakon olvasnád az event.delta attribútumot minden egyes eseménynél, az kivételt dobna.

A megközelítés előnyei és korlátai

Ennek az útnak a fő előnye az időmegtakarítás: nem kell telepítened egy másik SDK-t, a fejlesztőid ismerős szintaxist kapnak, és ugyanazon kódbase-en belül triviálissá válik az xAI és az OpenAI modellek közötti váltás. Egy olyan csapat számára, amely anélkül szeretné kiértékelni a többügynökös módot, hogy teljes projektre kötelezné el magát, ez a legrövidebb út.

A korlátok mind ugyanabból az okból fakadnak: egy kompatibilitási rétegen keresztül mész, így elveszíted az xAI-ra jellemző sajátosságokat. Nem férhetsz hozzá az agent_count paraméterhez (helyette közvetett vezérlés áll rendelkezésre a reasoning.effort segítségével), a verbose_streaming-hez vagy a use_encrypted_content-hez. Ráadásul az erőfeszítés → ügynökök leképezés egy béta API-ból származik, és változhat: ha a terméked kifejezetten a használt ügynökök számától függ, a natív SDK marad a körültekintő választás.

Főbb megállapítások

  • Az OpenAI SDK működik a többügynökös móddal a base_url="https://api.x.ai/v1" beállítással
  • Az ügynökök számát a reasoning.effort paraméterrel vezérled (low/medium = 4, high/xhigh = 16)
  • A Chat Completions NEM támogatott – kizárólag a Responses API-t használd
  • Az xAI SDK-ra jellemző egyes paraméterek (agent_count, verbose_streaming) nem érhetők el