Lähe põhisisu juurde
Eesti— Vali keel
Menüü

OpenAI SDK ühilduvus

Õppetund 6 / 14 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Mitme agendi kasutamine OpenAI SDK kaudu
  2. Kliendi seadistamine
  3. Agentide arvu juhtimine parameetriga reasoning.effort
  4. Jõupingutuse ja agentide arvu vastavus
  5. Chat Completions ei ole toetatud
  6. Voogedastus OpenAI SDK-ga
  7. Selle lähenemise eelised ja piirangud
  8. Peamised punktid

Mitme agendi kasutamine OpenAI SDK kaudu

Paljud meeskonnad on juba ehitanud oma päringukihi OpenAI SDK ümber, koos selle mähiste, testide ja logimiskokkulepetega. Hea uudis: Groki mitme agendi režiimi kasutamine ei sunni sind kõike ümber kirjutama. xAI pakub API-d, mis on ühilduv OpenAI vastuste (Responses) formaadiga, nii et saad säilitada OpenAI kliendi ja suunata selle lihtsalt xAI API-le.

Kliendi seadistamine

Vaja on vaid kahte seadet: xAI baas-URL-i ja sinu xAI API võtit.

from openai import OpenAI

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

Alates sellest hetkest kasutad vastuste API-d nagu tavaliselt, määrates mudeliks grok-4.20-multi-agent-0309. Ülejäänud päringukood jääb muutumatuks.

Agentide arvu juhtimine parameetriga reasoning.effort

Siin toimub kahe maailma vaheline tõlge. Kui xAI SDK pakub otsest parameetrit agent_count, siis OpenAI SDK pakub vaid reasoning.effort – seega ei küsi sa agentide arvu, vaid jõupingutuse taset, mille xAI teisendab agentide arvukaks.

# 4 agenti (madal jõupingutus)
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 agenti (kõrge jõupingutus)
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)

Jõupingutuse ja agentide arvu vastavus

Väli aktsepteerib nelja väärtust, kuid need genereerivad vaid kahte meeskonna suurust: "low" ja "medium" kasutavad 4 agenti, samas kui "high" ja "xhigh" kasutavad 16.

See detail väärib hoolikat tähelepanu. Liikumine tasemelt low tasemele medium või high tasemelt xhigh ei muuda agentide arvu: need vaheastmed võivad mõjutada muid mudeli käitumise aspekte, kuid iga paari sees jääb meeskond samaks. Kujuta ette liidest, kus pakud kasutajale nelja uurimissügavuse taset – nemad tajuvad vaid kahte ja sinu kaks lisaklahvi tekitaksid valikus ainult segadust.

Chat Completions ei ole toetatud

Siin on piirang, millesse enamik arendajaid oma esimesel katsel komistab: Chat Completions ei ole mitme agendi jaoks toetatud. Pead kasutama vastuste API-d, ehk client.responses.create, mitte client.chat.completions.create.

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

See päring tagastab vea. Kui sinu olemasolev kood tugineb täielikult Chat Completionsile – nagu paljud olemasolevad koodibaasid teevad – ei ole muutus pelgalt mudeli nime vahetamine: pead viima päringu üle teisele sisendi ja väljundi formaadile. Hinda seda jõupingutust enne, kui lubad integratsiooni teha.

Voogedastus OpenAI SDK-ga

Voogedastus on endiselt saadaval, samuti vastuste API kaudu:

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)

Kontrolli hasattr(event, 'delta') tasub jätta selliseks, nagu see on: vastuste API sündmuste voog sisaldab rohkemat kui ainult teksti ja event.delta pimesi lugemine igal sündmusel põhjustaks erindi.

Selle lähenemise eelised ja piirangud

Selle tee peamine eelis on ajasääst: sa ei paigalda teist SDK-d, sinu arendajad saavad kasutada tuttavat süntaksit ja lülitumine xAI ja OpenAI mudelite vahel samas koodibaasis muutub tühiseks. Meeskonnale, kes soovib hinnata mitme agendi režiimi ilma täieliku projektiga seostumata, on see lühim tee.

Piirangud tulenevad kõik samast põhjusest: liigud läbi ühilduvuskihi, nii et kaotad xAI-spetsiifilised võimalused. Sa ei saa kasutada agent_count (asendatud kaudse juhtimisega läbi reasoning.effort), verbose_streaming ega use_encrypted_content. Lisaks põhineb jõupingutuse ja agentide arvu vastavus beeta-API-l ja see võib muutuda: kui sinu toode sõltub konkreetselt kasutatavate agentide arvust, on emakeelne SDK ettevaatlikum valik.

Peamised punktid

  • OpenAI SDK töötab mitme agendiga, kasutades base_url="https://api.x.ai/v1"
  • Agentide arvu juhid parameetriga reasoning.effort (low/medium = 4, high/xhigh = 16)
  • Chat Completions EI OLE toetatud – kasuta ainult vastuste API-d
  • Mõned xAI SDK-le omased parameetrid (agent_count, verbose_streaming) ei ole saadaval