Compatibilitatea cu SDK-ul OpenAI
Pe această pagină
Utilizarea modului multi-agent prin SDK-ul OpenAI
Multe echipe și-au construit deja stratul de apeluri în jurul SDK-ului OpenAI, împreună cu wrapper-ele, testele și convențiile de jurnalizare specifice. Vestea bună este că accesarea modului multi-agent al lui Grok nu vă obligă să rescrieți totul. xAI expune un API compatibil cu formatul „Responses“ al OpenAI, astfel încât puteți păstra clientul OpenAI și să îl direcționați pur și simplu către API-ul xAI.
Configurarea clientului
Sunt necesare doar două setări: URL-ul de bază al xAI și cheia dvs. API xAI.
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1",
)
De aici, utilizați API-ul Responses ca de obicei, specificând grok-4.20-multi-agent-0309 drept model. Restul codului de apel rămâne neschimbat.
Controlul numărului de agenți prin reasoning.effort
Aici are loc traducerea dintre cele două lumi. În timp ce SDK-ul xAI expune un parametru explicit agent_count, SDK-ul OpenAI oferă doar reasoning.effort – astfel, nu solicitați un număr de agenți, ci un nivel de efort pe care xAI îl convertește într-un număr de agenți.
# 4 agenți (efort redus)
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 agenți (efort ridicat)
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)
Corespondența efort → agenți
Câmpul acceptă patru valori, dar acestea produc doar două dimensiuni ale echipei: "low" și "medium" utilizează 4 agenți, în timp ce "high" și "xhigh" utilizează 16.
Acest detaliu merită o atenție deosebită. Trecerea de la low la medium sau de la high la xhigh nu modifică numărul de agenți: aceste niveluri intermediare pot influența alte aspecte ale comportamentului modelului, dar în cadrul fiecărei perechi, echipa rămâne aceeași. Imaginați-vă o interfață în care ați oferi utilizatorului patru niveluri de profunzime a cercetării – acesta ar percepe doar două, iar cele două butoane suplimentare nu ar face decât să îi confuzeze alegerea.
Chat Completions nu este suportat
Iată constrângerea care îi pune în dificultate pe majoritatea dezvoltatorilor la prima încercare: Chat Completions nu este suportat pentru modul multi-agent. Trebuie să utilizați API-ul Responses, adică client.responses.create, și nu client.chat.completions.create.
# NU FUNCȚIONEAZĂ
response = client.chat.completions.create(
model="grok-4.20-multi-agent-0309",
messages=[{"role": "user", "content": "..."}],
)
Acest apel returnează o eroare. Dacă codul existent se bazează în întregime pe Chat Completions – așa cum se întâmplă în multe baze de cod existente – schimbarea nu constă doar în înlocuirea numelui modelului: trebuie să migrați apelul către un format diferit de intrare și ieșire. Evaluați acest efort înainte de a promite integrarea.
Streaming cu SDK-ul OpenAI
Streaming-ul este disponibil în continuare, tot prin intermediul API-ului Responses:
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)
Testul hasattr(event, 'delta') merită păstrat așa cum este: fluxul de evenimente al API-ului Responses conține mai mult decât text, iar citirea orb a lui event.delta la fiecare eveniment ar genera o excepție.
Avantaje și limite ale acestei abordări
Principalul avantaj al acestei rute este economisirea de timp: nu instalați un alt SDK, dezvoltatorii dvs. beneficiază de o sintaxă familiară, iar comutarea între modelele xAI și OpenAI în aceeași bază de cod devine trivială. Pentru o echipă care dorește să evalueze modul multi-agent fără a se angaja într-un proiect complet, aceasta este cea mai scurtă cale.
Limitele decurg toate din aceeași cauză: treceți printr-un strat de compatibilitate, astfel încât pierdeți ceea ce este specific xAI. Nu aveți acces la agent_count (înlocuit de controlul indirect prin reasoning.effort), verbose_streaming sau use_encrypted_content. În plus, corespondența efort → agenți provine dintr-un API beta și se poate modifica: dacă produsul dvs. depinde în mod specific de numărul de agenți utilizați, SDK-ul nativ rămâne alegerea prudentă.
Puncte cheie
- SDK-ul OpenAI funcționează cu modul multi-agent prin
base_url="https://api.x.ai/v1" - Controlați numărul de agenți prin
reasoning.effort(low/medium = 4, high/xhigh = 16) - Chat Completions NU este suportat – utilizați doar API-ul Responses
- Anumiți parametri exclusivi SDK-ului xAI (
agent_count,verbose_streaming) nu sunt disponibili