OpenAI SDK ühilduvus
Sellel lehel
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