Kompatibilita s OpenAI SDK
Na tejto strane
Používanie multi-agent cez OpenAI SDK
Mnohé tímy už postavili svoju vrstvu volaní okolo OpenAI SDK spolu s jeho obalmi, testami a konvenciami logovania. Dobrá správa: prístup k režimu multi-agent modelu Grok ťa nenúti prepisovať všetko od nuly. xAI vystavuje API kompatibilné s formátom Responses od OpenAI, takže môžeš ponechať klienta OpenAI a jednoducho ho nasmerovať na API xAI.
Konfigurácia klienta
Potrebuješ len dve nastavenia: základnú URL xAI a tvoj API kľúč xAI.
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1",
)
Od tohto momentu používaš API Responses ako zvyčajne, pričom ako model určíš grok-4.20-multi-agent-0309. Zvyšok kódu pre volania zostáva nezmenený.
Ovládanie počtu agentov pomocou reasoning.effort
Tu dochádza k prevodu medzi týmito dvoma svetmi. Kým SDK od xAI vystavuje explicitný parameter agent_count, SDK od OpenAI ponúka iba reasoning.effort – nežiadate teda konkrétny počet agentov, ale úroveň úsilia, ktorú xAI prevedie na počet agentov.
# 4 agenti (nízke úsilie)
response = client.responses.create(
model="grok-4.20-multi-agent-0309",
reasoning={"effort": "low"},
input=[{"role": "user", "content": "Aké sú najnovšie modely s otvoreným zdrojovým kódom z roku 2026?"}],
)
print(response.output_text)
# 16 agentov (vysoké úsilie)
response = client.responses.create(
model="grok-4.20-multi-agent-0309",
reasoning={"effort": "high"},
input=[{"role": "user", "content": "Porovnajte stratégie EÚ a USA v oblasti umelej inteligencie v roku 2026"}],
)
print(response.output_text)
Mapovanie úsilia na počet agentov
Toto pole prijíma štyri hodnoty, ktoré však produkujú iba dve veľkosti tímov: "low" a "medium" využívajú 4 agentov, zatiaľ čo "high" a "xhigh" využívajú 16.
Tento detail si zaslúži pozornosť. Prechod z low na medium alebo z high na xhigh nemení počet agentov: tieto stredné úrovne môžu ovplyvniť iné aspekty správania modelu, ale v rámci každého páru zostáva tím rovnaký. Predstav si rozhranie, kde by si používateľovi ponúkol štyri úrovne hĺbky výskumu – on by vnímal iba dve a tvoje dve extra tlačidlá by len zmätočili jeho výber.
Chat Completions nie je podporované
Tu je obmedzenie, na ktorom väčšina vývojárov prvýkrát stroskotá: Chat Completions nie je pre multi-agent podporované. Musíš použiť API Responses, čo znamená client.responses.create, nie client.chat.completions.create.
# NEFUNGUJE
response = client.chat.completions.create(
model="grok-4.20-multi-agent-0309",
messages=[{"role": "user", "content": "..."}],
)
Toto volanie vráti chybu. Ak sa tvoj existujúci kód spolieha výlučne na Chat Completions – čo robí mnoho existujúcich kódových báze – zmena nie je len o výmene názvu modelu: musíš migrovať volanie na iný formát vstupu a výstupu. Odhadni si túto námahu skôr, než sľúbiš integráciu.
Streamovanie s OpenAI SDK
Streamovanie je stále dostupné, opäť prostredníctvom API Responses:
stream = client.responses.create(
model="grok-4.20-multi-agent-0309",
reasoning={"effort": "low"},
input=[{"role": "user", "content": "Zhrň technologické oznámenia tohto týždňa"}],
stream=True,
)
for event in stream:
if hasattr(event, 'delta') and event.delta:
print(event.delta, end="", flush=True)
Test hasattr(event, 'delta') stojí za to ponechať tak, ako je: stream udalostí API Responses obsahuje viac než len text a slepé čítanie event.delta pri každej udalosti by vyvolalo výnimku.
Výhody a obmedzenia tohto prístupu
Hlavnou výhodou tejto cesty je úspora času: neinštaluješ ďalšie SDK, tvoji vývojári dostanú známu syntax a prepínanie medzi modelmi xAI a OpenAI v rámci tej istej kódovej bázy sa stáva triviálnym. Pre tím, ktorý chce vyhodnotiť režim multi-agent bez záväzku k celému projektu, je to najkratšia cesta.
Všetky obmedzenia pramenia z tej istej príčiny: prechádzaš cez vrstvu kompatibility, takže strácaš to, čo je špecifické pre xAI. Nedostaneš agent_count (nahradený nepriamym ovládaním cez reasoning.effort), verbose_streaming ani use_encrypted_content. Navyše, mapovanie úsilia na agentov pochádza z beta verzie API a môže sa zmeniť: ak tvoj produkt závisí konkrétne od počtu použitých agentov, natívne SDK zostáva opatrnejšou voľbou.
Kľúčové poznatky
- OpenAI SDK funguje s multi-agent prostredníctvom
base_url="https://api.x.ai/v1" - Počet agentov ovládaš cez
reasoning.effort(low/medium = 4, high/xhigh = 16) - Chat Completions NIE JE podporované – používaj výlučne API Responses
- Niektoré parametre exkluzívne pre xAI SDK (
agent_count,verbose_streaming) nie sú dostupné