Saderība ar OpenAI SDK
Šajā lapā
Multi-agent režīma izmantošana, izmantojot OpenAI SDK
Daudzas komandas jau ir izveidojušas savu izsaukumu slāni, balstoties uz OpenAI SDK, ar tās apvalkiem, testiem un žurnālu reģistrēšanas konvencijām. Labās ziņas: piekļuve Grok multi-agent režīmam neliek tev visu pārrakstīt. xAI piedāvā API, kas ir saderīgs ar OpenAI atbilžu (Responses) formātu, tāpēc vari saglabāt OpenAI klientu un vienkārši norādīt tam xAI API adresi.
Klienta konfigurācija
Tev vajag tikai divus iestatījumus: xAI bāzes URL un savu xAI API atslēgu.
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1",
)
No šī brīža tu izmanto atbilžu (Responses) API kā parasti, norādot grok-4.20-multi-agent-0309 kā modeli. Pārējais tava izsaukuma kods paliek nemainīgs.
Aģentu skaita kontrole, izmantojot reasoning.effort
Tieši šeit notiek tulkošana starp abām pasaulēm. Kamēr xAI SDK piedāvā tiešu agent_count parametru, OpenAI SDK piedāvā tikai reasoning.effort — tāpēc tu nepieprasi konkrētu aģentu skaitu, bet gan piepūles līmeni, ko xAI pārveido aģentu skaitā.
# 4 aģenti (zema piepūle)
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 aģenti (augsta piepūle)
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)
Piepūles un aģentu skaita atbilstība
Lauks pieņem četras vērtības, taču tās rada tikai divus komandas lielumus: "low" un "medium" izmanto 4 aģentus, savukārt "high" un "xhigh" izmanto 16.
Šī detaļa ir pelnījusi rūpīgu uzmanību. Pāreja no low uz medium vai no high uz xhigh nemaina aģentu skaitu: šie starplīmeņi var ietekmēt citus modeļa uzvedības aspektus, taču katrā pārī komanda paliek tāda pati. Iedomājies saskarni, kurā lietotājam piedāvā četrus pētniecības dziļuma līmeņus — viņš uztvers tikai divus, un tavas divas papildu pogas tikai sajauks viņa izvēli.
Chat Completions netiek atbalstīts
Šis ir ierobežojums, kurā iekrīt vairums izstrādātāju pirmajā mēģinājumā: Chat Completions netiek atbalstīts multi-agent režīmam. Tev ir jāizmanto atbilžu (Responses) API, tas nozīmē client.responses.create, nevis client.chat.completions.create.
# NEDARBOJAS
response = client.chat.completions.create(
model="grok-4.20-multi-agent-0309",
messages=[{"role": "user", "content": "..."}],
)
Šis izsaukums atgriezīs kļūdu. Ja tavs esošais kods pilnībā paļaujas uz Chat Completions — kā daudzas esošās kodbāzes —, tad izmaiņas nav tikai modeļa nosaukuma maiņa: tev ir jāpārvieto izsaukums uz citu ievades un izvades formātu. Novērtē šo darba apjomu, pirms sola integrāciju.
Straumēšana, izmantojot OpenAI SDK
Straumēšana joprojām ir pieejama, atkal izmantojot atbilžu (Responses) API:
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)
Ir vērts atstāt hasattr(event, 'delta') pārbaudi tieši tādu, kāda tā ir: atbilžu (Responses) API notikumu straume satur ne tikai tekstu, un akla event.delta nolasīšana katrā notikumā izraisītu izņēmumu.
Šīs pieejas priekšrocības un ierobežojumi
Galvenā šī ceļa priekšrocība ir laika ietaupījums: tev nav jāinstalē cits SDK, tavi izstrādātāji iegūst pazīstamu sintaksi, un pāreja starp xAI un OpenAI modeļiem vienā kodbāzē kļūst triviāla. Komandai, kas vēlas novērtēt multi-agent režīmu, neuzņemoties pilnu projektu, tas ir īsākais ceļš.
Visi ierobežojumi izriet no viena iemesla: tu izmanto saderības slāni, tāpēc zaudē to, kas ir specifisks xAI. Tu nesaņem agent_count (to aizstāj netieša kontrole caur reasoning.effort), verbose_streaming vai use_encrypted_content. Turklāt piepūles un aģentu skaita atbilstība nāk no beta API un var mainīties: ja tavs produkts ir specifiski atkarīgs no izmantoto aģentu skaita, natīvais SDK paliek prātīgākā izvēle.
Galvenās atziņas
- OpenAI SDK darbojas ar multi-agent režīmu, izmantojot
base_url="https://api.x.ai/v1" - Tu kontrolē aģentu skaitu, izmantojot
reasoning.effort(low/medium = 4, high/xhigh = 16) - Chat Completions NAV atbalstīts — izmanto tikai atbilžu (Responses) API
- Daži parametri, kas ekskluzīvi xAI SDK (
agent_count,verbose_streaming), nav pieejami