Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

OpenAI SDK -yhteensopivuus

Oppitunti 6 / 14 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Moniagenttikäyttö OpenAI SDK:n kautta
  2. Asiakasohjelman määritys
  3. Agenttien määrän ohjaus parametrilla reasoning.effort
  4. Ponnistus → agentit -kuvaus
  5. Chat Completionsia ei tueta
  6. Streamaus OpenAI SDK:n kanssa
  7. Tämän lähestymistavan hyödyt ja rajoitukset
  8. Keskeiset asiat

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