Kompatibilita s OpenAI SDK
Na této stránce
Využití víceagentního režimu prostřednictvím OpenAI SDK
Mnoho týmů již postavilo svou vrstvu pro volání API kolem OpenAI SDK, včetně jeho obálek, testů a konvencí pro logování. Dobrá zpráva: přístup k víceagentnímu režimu modelu Grok tě nenutí přepisovat vše od nuly. xAI vystavuje API kompatibilní s formátem Responses od OpenAI, takže můžeš ponechat klienta OpenAI a pouze jej nasměrovat na API xAI.
Konfigurace klienta
Stačí ti pouze dvě nastavení: základní URL adresa xAI a tvůj API klíč xAI.
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1",
)
Od této chvíle používáš API Responses jako obvykle, přičemž jako model specifikuješ grok-4.20-multi-agent-0309. Zbytek kódu pro volání zůstává nezměněn.
Řízení počtu agentů pomocí reasoning.effort
Zde dochází k převodu mezi těmito dvěma světy. Zatímco SDK od xAI nabízí explicitní parametr agent_count, SDK od OpenAI nabízí pouze reasoning.effort. Nepožaduješ tedy konkrétní počet agentů, ale úroveň úsilí, kterou xAI převede na počet agentů.
# 4 agenti (nízké úsilí)
response = client.responses.create(
model="grok-4.20-multi-agent-0309",
reasoning={"effort": "low"},
input=[{"role": "user", "content": "What are the latest open source models from 2026?"}],
)
print(response.output_text)
# 16 agentů (vysoké úsilí)
response = client.responses.create(
model="grok-4.20-multi-agent-0309",
reasoning={"effort": "high"},
input=[{"role": "user", "content": "Compare the EU and US AI strategies in 2026"}],
)
print(response.output_text)
Mapování úsilí na počet agentů
Toto pole přijímá čtyři hodnoty, které však produkují pouze dvě velikosti týmu: "low" a "medium" využívají 4 agenty, zatímco "high" a "xhigh" využívají 16 agentů.
Tento detail si zaslouží pečlivou pozornost. Přechod z low na medium nebo z high na xhigh nemění počet agentů: tyto střední úrovně mohou ovlivnit jiné aspekty chování modelu, ale v rámci každé dvojice zůstává tým stejný. Představ si rozhraní, kde bys uživateli nabídl čtyři úrovně hloubky výzkumu – on by vnímal pouze dvě a tvá dvě extra tlačítka by jeho rozhodování pouze mátla.
Chat Completions není podporováno
Zde je omezení, na které narazí většina vývojářů při prvním pokusu: Chat Completions není pro víceagentní režim podporováno. Musíš použít API Responses, tedy client.responses.create, nikoliv client.chat.completions.create.
# NEFUNGUJE
response = client.chat.completions.create(
model="grok-4.20-multi-agent-0309",
messages=[{"role": "user", "content": "..."}],
)
Toto volání vrátí chybu. Pokud se tvůj stávající kód spoléhá výhradně na Chat Completions – což dělá mnoho existujících kódových základen – změna není jen o záměně názvu modelu: musíš migrovat volání na jiný formát vstupu a výstupu. Před slíbením integrace si tedy rozmysli rozsah tohoto úsilí.
Streamování s OpenAI SDK
Streamování je stále dostupné, opět prostřednictvím API Responses:
stream = client.responses.create(
model="grok-4.20-multi-agent-0309",
reasoning={"effort": "low"},
input=[{"role": "user", "content": "Summarize this week's tech announcements"}],
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 ponechat tak, jak je: stream událostí API Responses obsahuje více než jen text a slepé čtení event.delta u každé události by vyvolalo výjimku.
Výhody a limity tohoto přístupu
Hlavní výhodou této cesty je úspora času: nemusíš instalovat další SDK, tvoji vývojáři získají známou syntaxi a přepínání mezi modely xAI a OpenAI ve stejné kódové základně se stane triviálním. Pro tým, který chce vyhodnotit víceagentní režim bez závazku k celému projektu, je to nejkratší cesta.
Všechny limity pramení ze stejné příčiny: procházíš přes vrstvu kompatibility, takže přicházíš o to, co je specifické pro xAI. Nemáš k dispozici agent_count (nahrazeno nepřímým řízením přes reasoning.effort), verbose_streaming ani use_encrypted_content. Navíc mapování úsilí na počet agentů pochází z beta verze API a může se změnit: pokud tvůj produkt závisí specificky na počtu použitých agentů, zůstává nativní SDK obezřetnější volbou.
Klíčové poznatky
- OpenAI SDK funguje s víceagentním režimem prostřednictvím
base_url="https://api.x.ai/v1" - Počet agentů řídíš pomocí
reasoning.effort(low/medium = 4, high/xhigh = 16) - Chat Completions NENÍ podporováno – používej výhradně API Responses
- Některé parametry exkluzivní pro SDK xAI (
agent_count,verbose_streaming) nejsou dostupné