Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Kompatibilnost s OpenAI SDK-jem

Lekcija 6 od 14 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Korištenje multi-agent načina putem OpenAI SDK-ja
  2. Konfiguracija klijenta
  3. Upravljanje brojem agenata putem reasoning.effort
  4. Mapiranje effort → agenti
  5. Chat Completions nije podržan
  6. Strujanje (Streaming) s OpenAI SDK-jem
  7. Prednosti i ograničenja ovog pristupa
  8. Ključne točke

Korištenje multi-agent načina putem OpenAI SDK-ja

Mnogi timovi već su izgradili svoj sloj za pozive oko OpenAI SDK-ja, zajedno s njegovim omotačima, testovima i konvencijama bilježenja. Dobre vijesti: pristup Grokovom multi-agent načinu ne prisiljava te da prepišeš sve. xAI izlaže API kompatibilan s OpenAI formatom Responses, tako da možeš zadržati OpenAI klijenta i jednostavno ga usmjeriti na xAI API.

Konfiguracija klijenta

Potrebne su ti samo dvije postavke: xAI-ov osnovni URL i tvoj xAI API ključ.

from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1",
)

Od tog trenutka koristiš Responses API kao i obično, navodeći grok-4.20-multi-agent-0309 kao model. Ostatak tvog koda za pozive ostaje nepromijenjen.

Upravljanje brojem agenata putem reasoning.effort

Ovdje se odvija prijevod između ta dva svijeta. Dok xAI SDK izlaže eksplicitan agent_count, OpenAI SDK nudi samo reasoning.effort – dakle, ne tražiš broj agenata, već razinu napora koju xAI pretvara u broj agenata.

# 4 agenta (nizak napor)
response = client.responses.create(
    model="grok-4.20-multi-agent-0309",
    reasoning={"effort": "low"},
    input=[{"role": "user", "content": "Koji su najnoviji modeli otvorenog koda iz 2026.?"}],
)
print(response.output_text)
# 16 agenata (visok napor)
response = client.responses.create(
    model="grok-4.20-multi-agent-0309",
    reasoning={"effort": "high"},
    input=[{"role": "user", "content": "Usporedi strategije EU i SAD-a za umjetnu inteligenciju u 2026."}],
)
print(response.output_text)

Mapiranje effort → agenti

Polje prihvaća četiri vrijednosti, ali one proizvode samo dvije veličine tima: "low" i "medium" koriste 4 agenta, dok "high" i "xhigh" koriste 16.

Ova pojedinost zaslužuje pažnju. Prelazak s low na medium ili s high na xhigh ne mijenja broj agenata: te međurazine mogu utjecati na druge aspekte ponašanja modela, ali unutar svakog para tim ostaje isti. Zamisli sučelje u kojem korisniku nudiš četiri razine dubine istraživanja – on bi percipirao samo dvije, a tvoja dva dodatna gumba samo bi zbunila njegov izbor.

Chat Completions nije podržan

Ovo je ograničenje koje zbuni većinu developera pri prvom pokušaju: Chat Completions nije podržan za multi-agent. Moraš koristiti Responses API, što znači client.responses.create, a ne client.chat.completions.create.

# NE RADI
response = client.chat.completions.create(
    model="grok-4.20-multi-agent-0309",
    messages=[{"role": "user", "content": "..."}],
)

Ovaj poziv vraća grešku. Ako se tvoj postojeći kod u potpunosti oslanja na Chat Completions – kao što to čine mnoge postojeće baze koda – promjena nije samo zamjena imena modela: moraš migrirati poziv na drugačiji format ulaza i izlaza. Procijeni taj napor prije nego obećaš integraciju.

Strujanje (Streaming) s OpenAI SDK-jem

Strujanje je i dalje dostupno, ponovno putem Responses API-ja:

stream = client.responses.create(
    model="grok-4.20-multi-agent-0309",
    reasoning={"effort": "low"},
    input=[{"role": "user", "content": "Sažmi ovogodišnja tehnološka objavljivanja"}],
    stream=True,
)

for event in stream:
    if hasattr(event, 'delta') and event.delta:
        print(event.delta, end="", flush=True)

Test hasattr(event, 'delta') vrijedi zadržati kakav jest: tok događaja Responses API-ja sadrži više od teksta, a slijepo čitanje event.delta na svakom događaju izazvalo bi iznimku.

Prednosti i ograničenja ovog pristupa

Glavna prednost ovog puta je ušteda vremena: ne instaliraš drugi SDK, tvoji programeri dobivaju poznatu sintaksu, a prelazak između xAI i OpenAI modela u istoj bazi koda postaje trivijalan. Za tim koji želi evaluirati multi-agent način bez obvezivanja na cijeli projekt, to je najkraći put.

Sva ograničenja proizlaze iz istog uzroka: prolaziš kroz sloj kompatibilnosti, pa gubiš ono što je specifično za xAI. Ne dobivaš agent_count (zamijenjen neizravnim upravljanjem putem reasoning.effort), verbose_streaming ili use_encrypted_content. Uz to, mapiranje effort → agenti dolazi iz beta API-ja i moglo bi se promijeniti: ako tvoj proizvod specifično ovisi o broju korištenih agenata, nativni SDK ostaje razborit izbor.

Ključne točke

  • OpenAI SDK radi s multi-agentom putem base_url="https://api.x.ai/v1"
  • Broj agenata kontroliraš putem reasoning.effort (low/medium = 4, high/xhigh = 16)
  • Chat Completions NIJE podržan – koristi isključivo Responses API
  • Neki parametri ekskluzivni za xAI SDK (agent_count, verbose_streaming) nisu dostupni