Cur i bhfeidhm leis an xAI SDK
Ar an leathanach seo
An xAI SDK dúchasach
Is é an xAI SDK an bealach is díreacha chun an mód il-ghníomhaire a úsáid, agus is é an t-aon cheann a nochtann paraiméadair cosúil le agent_count nach bhfuil ar fáil i SDKanna tríú páirtí. Mura bhfuil srianta éiceachórais ort, tosaigh anseo: beidh rochtain agat ar an tacar iomlán socruithe.
Bunshocrú
Ní gá duit ach trí allmhairiú a dhéanamh agus do eochair API a léamh ón timpeallacht chun an cliant a thionscnaimh:
import os
from xai_sdk import Client
from xai_sdk.chat import user
client = Client(api_key=os.getenv("XAI_API_KEY"))
Caithfidh an athróg timpeallachta XAI_API_KEY do eochair API xAI a bheith ann. Ná cuir an eochair i gcrích riamh sa chód: chríochnódh sé sa stór Git, agus ansin ina stair, áit a bhfuil sé deacair é a bhaint.
Iarratas 4-ghníomhaire (mód tapa)
Chun cuardach tapa, dírithe a dhéanamh, seolann tú agent_count=4 nuair a chruthaíonn tú an comhrá:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4
)
chat.append(user("Déan comparáid mhionsonraithe idir TCP agus UDP"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Tabhair faoi deara go n-itheann tú an fhreagairt trí chat.stream(). Sin an modh a mholtar: gan é, fanfaidh do chlár gan aon chomhartha beatha ar feadh an chuardaigh iomláin, agus ní inseoidh aon rud duit an bhfuil an t-iarratas fós ag rith nó an bhfuil sé tar éis titim as a chéile.
Iarratas 16-ghníomhaire (mód domhain)
Ní gá duit ach luach amháin a athrú chun aistriú go dtí an mód domhain, ach caithfidh an t-iarratas a phéireáiltear leis a bheith oiriúnach do scála an fhoirne atá tú a imlonnú:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=16
)
chat.append(user(
"Tabhair staid ealaíne iomlán dom ar ailtireachtaí RAG in 2026, "
"ag déanamh comparáide idir cur chuige hibrideacha, feidhmíocht, agus costais"
))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Uirlisí ionsuite a chur leis
Cuirtear uirlisí leis liosta simplí, agus soláthraíonn an SDK na tógálaithe comhfhreagracha:
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("Cad iad na fógraí is déanaí ó xAI an tseachtain seo?"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Athraíonn an paraiméadar include=["verbose_streaming"] an rud a fhaigheann tú: feictear glaonna uirlisí i bhfíor-am agus na gníomhairí ag obair, agus tá a fhios agat ar cad atá an cuardach reatha dírithe.
Ábhar criptithe do chomhráite il-chasacha
Má phleanálann tú roinnt ceisteanna a chur i ndiaidh a chéile ar an ábhar céanna, cas air an t-ábhar criptithe nuair a chruthaíonn tú an comhrá:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4,
use_encrypted_content=True,
)
Coinníonn an múnla staid na fo-ghníomhairí ansin idir casanna, rud a fhágann go bhfuil malartuithe fadaithe i bhfad níos comhleanúnaí.
Láimhseáil earráidí
Toisc go bhfuil an API i mbéite, féadfaidh iarratas teipthe gan a bheith faoi do locht. Cuir an glao i gclúdach agus pleanáil bealach éalaithe:
try:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4
)
chat.append(user("Mo cheist"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
except Exception as e:
print(f"Earráid il-ghníomhaire: {e}")
# Fill ar mhúnla caighdeánach más gá
Tá an nóta ar an líne dheireanach ag fanacht le cód fíor a chur ina ionad. Sa táirgeadh, caithfidh an bloc seo filleadh go gníomhach ar mhúnla caighdeánach, nó stopfaidh do ghné ag obair an chéad uair nach bhfuil an mód il-ghníomhaire ar fáil.
Príomhphointí
- Nochtann an xAI SDK
agent_countchun líon na ngníomhairí a rialú go díreach - Úsáid streaming i gcónaí don il-ghníomhaire (
.stream()) - Léiríonn
verbose_streamingglaonna uirlisí i bhfíor-am - Úsáid
use_encrypted_content=Truedo chomhráite il-chasacha - Pleanáil láimhseáil earráidí i gcónaí (API béite)