Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Cur i bhfeidhm leis an xAI SDK

Ceacht 5 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. An xAI SDK dúchasach
  2. Bunshocrú
  3. Iarratas 4-ghníomhaire (mód tapa)
  4. Iarratas 16-ghníomhaire (mód domhain)
  5. Uirlisí ionsuite a chur leis
  6. Ábhar criptithe do chomhráite il-chasacha
  7. Láimhseáil earráidí
  8. Príomhphointí

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.

xai_sdk
Pacáiste oifigiúil Python
agent_count
Paraiméadar eisiach
Streaming
Freagairt fíor-ama
Uirlisí
web_search, x_search...

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_count chun 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_streaming glaonna uirlisí i bhfíor-am
  • Úsáid use_encrypted_content=True do chomhráite il-chasacha
  • Pleanáil láimhseáil earráidí i gcónaí (API béite)