Kompatibilnost s OpenAI SDK-jem
Na ovoj stranici
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