Kompatibbiltà tal-SDK ta' OpenAI
F'din il-paġna
Użu tal-multi-agent permezz tal-SDK ta’ OpenAI
Ħafna timijiet diġà bnew is-saff ta’ sejħiet tagħhom madwar l-SDK ta’ OpenAI, bil-wrappers, it-testijiet u l-konvenzjonijiet tal-logging tagħhom. Aħbar tajba: l-aċċess għall-modalità multi-agent ta’ Grok ma jfurzakx terġa’ tikteb kollox. xAI jesponi API kompatibbli mal-format tar-Risposti (Responses) ta’ OpenAI, allura tista’ żżomm il-klijent ta’ OpenAI u sempliċiment tindirizzah lejn l-API ta’ xAI.
Konfigurazzjoni tal-klijent
Żewġ impostazzjonijiet biss huma meħtieġa: l-URL bażi ta’ xAI u ċ-ċavetta tal-API ta’ xAI tiegħek.
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1",
)
Minn hemm ‘il quddiem, tuża l-API tar-Risposti bħas-soltu, billi tispeċifika grok-4.20-multi-agent-0309 bħala l-mudell. Il-bqija tal-kodiċi tas-sejħiet tiegħek tibqa’ mingħajr bidla.
Kontroll tan-numru ta’ aġenti b’reasoning.effort
Hawnhekk iseħħ it-traduzzjoni bejn iż-żewġ dinjiet. Filwaqt li l-SDK ta’ xAI jesponi agent_count espliċitu, l-SDK ta’ OpenAI joffri biss reasoning.effort—għalhekk ma titlobx numru ta’ aġenti; titlob livell ta’ sforz li xAI jikkonverti f’numru ta’ aġenti.
# 4 aġenti (sforz baxx)
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-il aġent (sforz għoli)
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)
Il-mappatura sforz → aġenti
Il-qabel jaċċetta erba’ valuri, iżda dawn jipproduċu biss żewġ daqsijiet ta’ timijiet: "low" u "medium" jużaw 4 aġenti, filwaqt li "high" u "xhigh" jużaw 16.
Dan id-dettall jeħtieġ attenzjoni bir-reqqa. Il-moviment minn low għal medium, jew minn high għal xhigh, ma jbiddilx in-numru ta’ aġenti: dawn il-livelli intermedjarji jistgħu jinfluwenzaw aspetti oħra tal-imġiba tal-mudell, iżda fi ħdan kull par it-tim jibqa’ l-istess. Imaġina interfaċċa fejn toffri lill-utent erba’ livelli ta’ fond tar-riċerka—huwa jipperċepixxi biss tnejn, u ż-żewġ buttuni ekstra tiegħek ikunu biss ta’ konfużjoni għall-għażla tiegħu.
Chat Completions mhux appoġġjat
Hawnhekk tidħol il-limitazzjoni li tfalli lill-biċċa l-kbira tal-iżviluppaturi fl-ewwel tentattiv tagħhom: Chat Completions mhux appoġġjat għall-multi-agent. Trid tuża l-API tar-Risposti, jiġifieri client.responses.create, mhux client.chat.completions.create.
# MA JAĦDIMX
response = client.chat.completions.create(
model="grok-4.20-multi-agent-0309",
messages=[{"role": "user", "content": "..."}],
)
Din is-sejħa tirritorna żball. Jekk il-kodiċi eżistenti tiegħek jiddependi kompletament fuq Chat Completions—kif jagħmlu ħafna bażijiet tal-kodiċi eżistenti—il-bidla mhix sempliċiment skambju ta’ isem tal-mudell: trid timmigra s-sejħa għal format ta’ input u output differenti. Ikkalkula dan l-isforz qabel ma twiegħed l-integrazzjoni.
Streaming bl-SDK ta’ OpenAI
L-istreaming għadu disponibbli, ukoll permezz tal-API tar-Risposti:
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)
It-test hasattr(event, 'delta') jixraq li jinżamm hekk kif inhu: l-istreaming tal-avvenimenti tal-API tar-Risposti fih aktar minn sempliċiment test, u l-qari għama ta’ event.delta fuq kull avveniment iqajjem eċċezzjoni.
Vantaġġi u limiti ta’ dan l-approċċ
Il-vantaġġ prinċipali ta’ din ir-rotta huwa li tiffranka l-ħin: ma tinstallax SDK ieħor, l-iżviluppaturi tiegħek ikollhom sintassi familjari, u l-ibdil bejn mudelli ta’ xAI u OpenAI fl-istess bażi tal-kodiċi jsir banali. Għal tim li jrid jevalwa l-modalità multi-agent mingħajr ma jimpenna ruħu għal proġett sħiħ, din hija l-iqsar triq.
Il-limiti kollha joriġinaw mill-istess kawża: qed tgħaddi minn saff ta’ kompatibbiltà, allura titlef dak li hu speċifiku għal xAI. Ma tiksbix agent_count (sostitwit b’kontroll indirett permezz ta’ reasoning.effort), verbose_streaming, jew use_encrypted_content. Barra minn hekk, il-mappatura sforz → aġenti tiġi minn API beta u tista’ tinbidel: jekk il-prodott tiegħek jiddependi speċifikament fuq in-numru ta’ aġenti użati, l-SDK nativ jibqa’ l-għażla prudenti.
Punti Ewlenin
- L-SDK ta’ OpenAI jaħdem mal-multi-agent permezz ta’
base_url="https://api.x.ai/v1" - Tikkontrolla n-numru ta’ aġenti permezz ta’
reasoning.effort(low/medium = 4, high/xhigh = 16) - Chat Completions MHUX appoġġjat—uża l-API tar-Risposti biss
- Xi parametri esklużivi għall-SDK ta’ xAI (
agent_count,verbose_streaming) mhumiex disponibbli