OpenAI SDK -yhteensopivuus
Tällä sivulla
Moniagenttikäyttö OpenAI SDK:n kautta
Monet tiimit ovat jo rakentaneet kutsukerroksensa OpenAI SDK:n ympärille omien käärijensä, testiensä ja lokituskäytäntöjensä kera. Hyviä uutisia: Grokin moniagenttitilan käyttö ei pakota sinua kirjoittamaan kaikkea uudelleen. xAI tarjoaa OpenAI:n Responses-muodon kanssa yhteensopivan rajapinnan, joten voit pitää OpenAI-asiakasohjelman käytössä ja suunnata sen yksinkertaisesti xAI:n rajapintaan.
Asiakasohjelman määritys
Tarvitset vain kaksi asetusta: xAI:n perus-URL-osoitteen ja xAI API -avaimesi.
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1",
)
Tämän jälkeen käytät Responses API:a totuttuun tapaan määrittämällä malliksi grok-4.20-multi-agent-0309. Muu kutsukoodisi pysyy muuttumattomana.
Agenttien määrän ohjaus parametrilla reasoning.effort
Tässä kohdassa kahden maailman välinen käännös tapahtuu. Kun xAI SDK tarjoaa suoran agent_count-parametrin, OpenAI SDK tarjoaa vain reasoning.effort-parametrin. Et siis pyydä tiettyä agenttien määrää, vaan pyydät ponnistelutasoa, jonka xAI muuntaa agenttien määräksi.
# 4 agenttia (matala ponnistus)
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 agenttia (korkea ponnistus)
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)
Ponnistus → agentit -kuvaus
Kenttä hyväksyy neljä arvoa, mutta ne tuottavat vain kaksi tiimin kokoa: "low" ja "medium" käyttävät 4 agenttia, kun taas "high" ja "xhigh" käyttävät 16.
Tämä yksityiskohta vaatii huolellista huomiota. Siirtyminen tasolta low tasolle medium tai tasolta high tasolle xhigh ei muuta agenttien määrää: nämä välitasot voivat vaikuttaa muihin mallin käyttäytymisen näkökohtiin, mutta kummassakin parissa tiimi pysyy samana. Kuvittele käyttöliittymä, jossa tarjoat käyttäjälle neljä tutkimussyvyyden tasoa – he havaitsevat vain kaksi, ja kaksi ylimääräistä painikettasi vain sekoittaisivat valintaa.
Chat Completionsia ei tueta
Tässä on rajoitus, joka kompastuttaa useimmat kehittäjät ensimmäisellä yrityksellä: Chat Completionsia ei tueta moniagenttitilassa. Sinun on käytettävä Responses API:a, eli client.responses.create, ei client.chat.completions.create.
# EI TOIMI
response = client.chat.completions.create(
model="grok-4.20-multi-agent-0309",
messages=[{"role": "user", "content": "..."}],
)
Tämä kutsu palauttaa virheen. Jos olemassa oleva koodisi luottaa täysin Chat Completionsiin – kuten monet koodikannat tekevät – muutos ei ole pelkkä mallin nimen vaihto: sinun on siirrettävä kutsu eri syöte- ja tulostemuotoon. Arvioi tämä työmäärä ennen kuin lupaat integraation.
Streamaus OpenAI SDK:n kanssa
Streamaus on edelleen saatavilla, jälleen Responses API:n kautta:
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')-tarkistus kannattaa pitää ennallaan: Responses API:n tapahtumavirta sisältää muutakin kuin tekstiä, ja event.delta:n sokea lukeminen jokaisessa tapahtumassa aiheuttaisi poikkeuksen.
Tämän lähestymistavan hyödyt ja rajoitukset
Tämän reitin suurin etu on ajan säästö: et asenna toista SDK:ta, kehittäjäsi saavat tutun syntaksin, ja vaihtaminen xAI- ja OpenAI-mallien välillä samassa koodikannassa muuttuu triviaaliksi. Tiimille, joka haluaa arvioida moniagenttitilaa sitoutumatta koko projektiin, tämä on lyhin polku.
Rajoitukset kaikki johtuvat samasta syystä: kuljet yhteensopivuuskerroksen läpi, joten menetät xAI:lle ominaiset ominaisuudet. Et saa käyttöön agent_count-parametria (sen korvaa epäsuora ohjaus reasoning.effort-parametrilla), verbose_streaming-tai use_encrypted_content-ominaisuuksia. Tämän lisäksi ponnistus → agentit -kuvaus perustuu beta-vaiheen rajapintaan ja voi muuttua: jos tuotteesi riippuu nimenomaan käytettyjen agenttien määrästä, natiivi SDK on harkitumpi valinta.
Keskeiset asiat
- OpenAI SDK toimii moniagenttitilassa asetuksella
base_url="https://api.x.ai/v1" - Ohjaat agenttien määrää parametrilla
reasoning.effort(low/medium = 4, high/xhigh = 16) - Chat Completionsia EI tueta – käytä vain Responses API:a
- Jotkin xAI SDK:lle yksinoikeutetut parametrit (
agent_count,verbose_streaming) eivät ole saatavilla