Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Kompatibbiltà tal-SDK ta' OpenAI

Lezzjoni 6 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Użu tal-multi-agent permezz tal-SDK ta’ OpenAI
  2. Konfigurazzjoni tal-klijent
  3. Kontroll tan-numru ta’ aġenti b’reasoning.effort
  4. Il-mappatura sforz → aġenti
  5. Chat Completions mhux appoġġjat
  6. Streaming bl-SDK ta’ OpenAI
  7. Vantaġġi u limiti ta’ dan l-approċċ
  8. Punti Ewlenin

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