OpenAI SDK kompatibilitás
Ezen az oldalon
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.effortparamé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