OpenAI SDK suderinamumas
Šiame puslapyje
Daugiaagenčio režimo naudojimas per OpenAI SDK
Daugelis komandų jau sukūrė savo užklausų sluoksnį, naudodamos OpenAI SDK su jo apvalkalais, testais ir žurnalinimo konvencijomis. Geros žinios: norint pasiekti Grok daugiaagentį režimą, nereikia visko perrašyti iš naujo. xAI pateikia API, suderinamą su OpenAI „Responses“ formatu, todėl galite toliau naudoti OpenAI klientą ir tiesiog nukreipti jį į xAI API.
Kliento konfigūracija
Jums reikia tik dviejų nustatymų: xAI bazinio URL ir jūsų xAI API rakto.
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1",
)
Nuo šiol „Responses“ API naudojate kaip įprasta, nurodydami grok-4.20-multi-agent-0309 kaip modelį. Likusi jūsų užklausų kodo dalis lieka nepakitusi.
Agentų skaičiaus valdymas naudojant reasoning.effort
Būtent čia vyksta vertimas tarp dviejų pasaulių. Kol xAI SDK pateikia aiškų agent_count, OpenAI SDK siūlo tik reasoning.effort – todėl jūs prašote ne agentų skaičiaus, o pastangų lygio, kurį xAI paverčia agentų skaičiumi.
# 4 agentai (mažos pastangos)
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ų (didelės pastangos)
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)
Pastangų ir agentų skaičiaus atitikmuo
Laukas priima keturias reikšmes, tačiau jos sukuria tik du komandos dydžius: "low" ir "medium" naudoja 4 agentus, o "high" ir "xhigh" – 16.
Ši detalė nusipelno ypatingo dėmesio. Perėjimas nuo low prie medium arba nuo high prie xhigh nekeičia agentų skaičiaus: šie tarpiniai lygiai gali turėti įtakos kitiems modelio elgesio aspektams, tačiau kiekvienoje poroje komanda lieka tokia pati. Įsivaizduokite sąsają, kurioje vartotojui siūlote keturis tyrimo gylio lygius – jis matys tik du, o jūsų du papildomi mygtukai tik supainios pasirinkimą.
Chat Completions nepalaikomas
Štai apribojimas, kuris dažniausiai suklaidina daugelį kūrėjų pirmojo bandymo metu: Chat Completions daugiaagenčiam režimui nepalaikomas. Privalote naudoti „Responses“ API, tai yra client.responses.create, o ne client.chat.completions.create.
# NEVEIKIA
response = client.chat.completions.create(
model="grok-4.20-multi-agent-0309",
messages=[{"role": "user", "content": "..."}],
)
Šis kvietimas grąžins klaidą. Jei jūsų esamas kodas visiškai remiasi „Chat Completions“ – kaip ir daugelis esamų kodų bazių – pokytis yra ne tik modelio pavadinimo pakeitimas: turite perkelti užklausą į kitą įvesties ir išvesties formatą. Įvertinkite šias pastangas prieš pažadėdami integraciją.
Transliavimas naudojant OpenAI SDK
Transliavimas vis dar galimas, taip pat per „Responses“ API:
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)
hasattr(event, 'delta') tikrinimą verta palikti tokį, koks jis yra: „Responses“ API įvykių sraute yra ne tik tekstas, aklas event.delta skaitymas kiekviename įvykyje sukeltų išimtį.
Šio požiūrio privalumai ir ribotumai
Pagrindinis šio kelio privalumas – taupomas laikas: nereikia diegti kito SDK, jūsų kūrėjai gauna jiems pažįstamą sintaksę, o perėjimas tarp xAI ir OpenAI modelių toje pačioje kodų bazėje tampa trivialiu uždaviniu. Komandai, norinčiai įvertinti daugiaagentį režimą neįsipareigojant visam projektui, tai yra trumpiausias kelias.
Visi ribotumai kyla iš tos pačios priežasties: einate per suderinamumo sluoksnį, todėl prarandate tai, kas specifiška xAI. Negausite agent_count (jį pakeičia netiesioginis valdymas per reasoning.effort), verbose_streaming arba use_encrypted_content. Be to, pastangų ir agentų skaičiaus atitikmuo yra beta versijos API dalis ir gali keistis: jei jūsų produktas konkrečiai priklauso nuo naudojamų agentų skaičiaus, gimtasis SDK lieka atsargesniu pasirinkimu.
Svarbiausi punktai
- OpenAI SDK veikia su daugiaagenčiu režimu per
base_url="https://api.x.ai/v1" - Agentų skaičių valdote per
reasoning.effort(low/medium = 4, high/xhigh = 16) - Chat Completions NEPALAIKOMAS – naudokite tik „Responses“ API
- Kai kurie parametrai, būdingi tik xAI SDK (
agent_count,verbose_streaming), nėra prieinami