Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Saderība ar OpenAI SDK

Nodarbība 6 no 14 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Multi-agent režīma izmantošana, izmantojot OpenAI SDK
  2. Klienta konfigurācija
  3. Aģentu skaita kontrole, izmantojot reasoning.effort
  4. Piepūles un aģentu skaita atbilstība
  5. Chat Completions netiek atbalstīts
  6. Straumēšana, izmantojot OpenAI SDK
  7. Šīs pieejas priekšrocības un ierobežojumi
  8. Galvenās atziņas

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