Združljivost z OpenAI SDK
Na tej strani
Uporaba večagentnega načina prek OpenAI SDK
Številne ekipe so svoj sloj klicev že zgradile okoli OpenAI SDK, z njegovimi ovoji, testi in konvencijami beleženja. Dobra novica: dostop do večagentnega načina Grok te ne prisili, da bi vse prepisal. xAI izpostavlja API, združljiv z obliko Responses od OpenAI, tako da lahko obdržiš odjemalca OpenAI in ga preprosto usmeriš na API xAI.
Konfiguracija odjemalca
Potrebuješ le dve nastavitvi: osnovni URL xAI in svoj ključ API xAI.
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1",
)
Od tu naprej API Responses uporabljaš kot običajno, pri čemer kot model določiš grok-4.20-multi-agent-0309. Preostala koda za klice ostane nespremenjena.
Nadzor števila agentov z reasoning.effort
Tu pride do prevoda med obema svetovoma. Medtem ko SDK xAI izpostavlja ekspliciten parameter agent_count, SDK OpenAI ponuja le reasoning.effort – torej ne zahtevaš števila agentov, temveč raven napora, ki jo xAI pretvori v število agentov.
# 4 agenti (nizek napor)
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 agentov (visok napor)
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)
Preslikava effort → agenti
Polje sprejme štiri vrednosti, vendar te proizvedejo le dve velikosti ekip: "low" in "medium" uporabita 4 agente, medtem ko "high" in "xhigh" uporabita 16.
Ta podrobnost si zasluži posebno pozornost. Premik od low do medium ali od high do xhigh ne spremeni števila agentov: te vmesne ravni lahko vplivajo na druge vidike obnašanja modela, vendar znotraj vsakega para ekipa ostane enaka. Predstavljaj si vmesnik, kjer bi uporabniku ponudil štiri ravni globine raziskave – zaznal bi le dve, tvoja dva dodatna gumba pa bi le zmedla njegovo izbiro.
Chat Completions ni podprt
Tu je omejitev, ki večino razvijalcev preseneti ob prvem poskusu: Chat Completions ni podprt za večagentni način. Uporabiti moraš API Responses, kar pomeni client.responses.create, ne pa client.chat.completions.create.
# NE DELUJE
response = client.chat.completions.create(
model="grok-4.20-multi-agent-0309",
messages=[{"role": "user", "content": "..."}],
)
Ta klic vrne napako. Če se tvoja obstoječa koda v celoti zanaša na Chat Completions – kar velja za številne obstoječe kode – sprememba ni le zamenjava imena modela: klic moraš preseliti v drugačen vhodni in izhodni format. Pred obljubo integracije oceni potreben napor.
Pretakanje z OpenAI SDK
Pretakanje je še vedno na voljo, prav tako prek API-ja 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)
Preizkus hasattr(event, 'delta') je vredno obdržati takšen, kot je: tok dogodkov API-ja Responses vsebuje več kot le besedilo in slepo branje event.delta pri vsakem dogodku bi sprožilo izjemo.
Prednosti in omejitve tega pristopa
Glavna prednost te poti je prihranek časa: namestiti ne moraš drugega SDK-ja, tvoji razvijalci dobijo znano sintakso, preklop med modeli xAI in OpenAI v isti kodi pa postane trivialen. Za ekipo, ki želi ovrednotiti večagentni način, ne da bi se zavezala celotnemu projektu, je to najkrajša pot.
Vse omejitve izhajajo iz istega vzroka: prehajaš skozi plast združljivosti, zato izgubiš tisto, kar je specifično za xAI. Ne dobiš agent_count (nadomeščen z posrednim nadzorom prek reasoning.effort), verbose_streaming ali use_encrypted_content. Poleg tega preslikava effort → agenti izvira iz beta API-ja in se lahko spremeni: če tvoj izdelek specifično temelji na številu uporabljenih agentov, ostaja domači SDK preudarna izbira.
Ključne ugotovitve
- OpenAI SDK deluje z večagentnim načinom prek
base_url="https://api.x.ai/v1" - Število agentov nadzoruješ prek
reasoning.effort(low/medium = 4, high/xhigh = 16) - Chat Completions NI podprt – uporabi izključno API Responses
- Nekateri parametri, značilni za SDK xAI (
agent_count,verbose_streaming), niso na voljo