Implimentazzjoni bis-SDK ta' xAI
F'din il-paġna
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.
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_countbiex tikkontrolla n-numru ta’ aġenti direttament - Dejjem uża l-istreaming għall-multi-aġent (
.stream()) verbose_streamingjiżvela s-sejħiet tal-għodod f’ħin realiuse_encrypted_content=Truegħal konversazzjonijiet b’diversi dawriet- Dejjem ippjana għall-ġestjoni tal-iżbalji (API beta)