Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Kompatibilita s OpenAI SDK

Lekce 6 z 14 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Využití víceagentního režimu prostřednictvím OpenAI SDK
  2. Konfigurace klienta
  3. Řízení počtu agentů pomocí reasoning.effort
  4. Mapování úsilí na počet agentů
  5. Chat Completions není podporováno
  6. Streamování s OpenAI SDK
  7. Výhody a limity tohoto přístupu
  8. Klíčové poznatky

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é