Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Združljivost z OpenAI SDK

Lekcija 6 od 14 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Uporaba večagentnega načina prek OpenAI SDK
  2. Konfiguracija odjemalca
  3. Nadzor števila agentov z reasoning.effort
  4. Preslikava effort → agenti
  5. Chat Completions ni podprt
  6. Pretakanje z OpenAI SDK
  7. Prednosti in omejitve tega pristopa
  8. Ključne ugotovitve

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