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

Implimentazzjoni bis-SDK ta' xAI

Lezzjoni 5 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. L-SDK nativ ta’ xAI
  2. Konfigurazzjoni bażika
  3. Talba b’4 aġenti (modalità mgħaġġla)
  4. Talba b’16-il aġent (modalità fil-fond)
  5. Żieda ta’ għodod integrati
  6. Kontenut ikkrittat għal konversazzjonijiet b’diversi dawriet
  7. Ġestjoni tal-iżbalji
  8. Punti Ewlenin

L-SDK nativ ta’ xAI

L-SDK ta’ xAI huwa l-aktar mod dirett biex tuża l-modalità multi-aġent, u l-uniku wieħed li jesponi parametri bħal agent_count li l-SDKs ta’ partijiet terzi ma joffrux. Jekk qed tibda mingħajr restrizzjonijiet tal-ekosistema, ibda hawn: ikollok aċċess għas-sett sħiħ ta’ settings.

xai_sdk
Pakkett uffiċjali tal-Python
agent_count
Parametru esklużiv
Streaming
Risposta f'ħin reali
Għodod
web_search, x_search...

Konfigurazzjoni bażika

L-inizjalizzazzjoni tal-klijent tinvolvi biss tliet imports u l-qari taċ-ċavetta tal-API tiegħek mill-ambjent:

import os
from xai_sdk import Client
from xai_sdk.chat import user

client = Client(api_key=os.getenv("XAI_API_KEY"))

Il-varjabbli tal-ambjent XAI_API_KEY trid fiha ċ-ċavetta tal-API ta’ xAI tiegħek. Qatt ma tħalli ċ-ċavetta miktuba direttament fil-kodiċi: tispiċċa fir-repożitorju Git, imbagħad fl-istorja tiegħu, fejn issir diffiċli biex titneħħa.

Talba b’4 aġenti (modalità mgħaġġla)

Għal tfittxija mgħaġġla u ffukata, tgħaddi agent_count=4 meta toħloq iċ-chat:

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=4
)
chat.append(user("Qabbel it-TCP u l-UDP fid-dettall"))

for response, chunk in chat.stream():
    if chunk.content:
        print(chunk.content, end="", flush=True)

Innota li tikkonsma r-risposta permezz ta’ chat.stream(). Din hija l-metodu rakkomandat: mingħajru, il-programma tiegħek tibqa’ msakkrata mingħajr l-ebda sinjal ta’ ħajja matul it-tfittxija kollha, u xejn ma jgħidlek jekk it-talba għadha għaddejja jew jekk ikkollhiex ħsara.

Talba b’16-il aġent (modalità fil-fond)

Il-bidla għall-modalità fil-fond teħtieġ biss li tbiddel valur wieħed, iżda t-talba li tgħaqqad magħha trid tkun proporzjonata mal-iskala tat-tim li qed tiddispjega:

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=16
)
chat.append(user(
    "Agħtini stat sħiħ tal-art dwar l-arkitetturi RAG fl-2026, "
    "li jqabbel approċċi ibridi, prestazzjoni, u kostijiet"
))

for response, chunk in chat.stream():
    if chunk.content:
        print(chunk.content, end="", flush=True)

Żieda ta’ għodod integrati

Tżid l-għodod b’lista sempliċi, u l-SDK jipprovdi l-kostrutturi korrispondenti:

from xai_sdk.tools import web_search, x_search

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=4,
    tools=[web_search(), x_search()],
    include=["verbose_streaming"],
)

chat.append(user("X'inhu l-aħħar tħabbira ta' xAI din il-ġimgħa?"))

for response, chunk in chat.stream():
    if chunk.content:
        print(chunk.content, end="", flush=True)

Il-parametru include=["verbose_streaming"] ibiddel dak li tirċievi: is-sejħiet tal-għodod jidhru f’ħin reali waqt li l-aġenti jaħdmu, u tkun taf fuq xiex hija ffukata t-tfittxija attwali.

Kontenut ikkrittat għal konversazzjonijiet b’diversi dawriet

Jekk qed tippjana li tagħmel diversi mistoqsijiet fuq l-istess suġġett wara xulxin, ixgħel il-kontenut ikkrittat meta toħloq iċ-chat:

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=4,
    use_encrypted_content=True,
)

Il-mudell iżomm allura l-istat tas-sub-aġenti bejn id-dawriet, li jagħmel skambji estiċi ħafna aktar koerenti.

Ġestjoni tal-iżbalji

Peress li l-API hija f’fażi beta, talba tista’ tfalli mingħajr ma tkun ħtitek. Poġġi s-sejħa f’blocca try u ppjana rotta ta’ ħruġ:

try:
    chat = client.chat.create(
        model="grok-4.20-multi-agent-0309",
        agent_count=4
    )
    chat.append(user("Il-mistoqsija tiegħi"))

    for response, chunk in chat.stream():
        if chunk.content:
            print(chunk.content, end="", flush=True)
except Exception as e:
    print(f"Żball multi-aġent: {e}")
    # Erġa' lura għal mudell standard jekk ikun meħtieġ

Il-kumment fl-aħħar linja qed jistenna biex jiġi sostitwit b’kodiċi reali. Fil-produzzjoni, dan il-blokk irid effettivament jerġa’ lura għal mudell standard, inkella l-funzjonalità tiegħek tieqaf taħdem l-ewwel darba li l-multi-aġent ma jkunx disponibbli.

Punti Ewlenin

  • L-SDK ta’ xAI jesponi agent_count biex tikkontrolla n-numru ta’ aġenti direttament
  • Dejjem uża l-istreaming għall-multi-aġent (.stream())
  • verbose_streaming jiżvela s-sejħiet tal-għodod f’ħin reali
  • use_encrypted_content=True għal konversazzjonijiet b’diversi dawriet
  • Dejjem ippjana għall-ġestjoni tal-iżbalji (API beta)