Įgyvendinimas naudojant xAI SDK
Šiame puslapyje
Gimtasis xAI SDK
xAI SDK yra tiesiausias būdas naudoti kelių agentų veikseną ir vienintelis, atskleidžiantis tokius parametrus kaip agent_count, kurių trečiųjų šalių SDK neturi. Jei pradedi darbą be ekosistemos apribojimų, pradėk čia: turėsi prieigą prie visų nustatymų.
Pagrindinis nustatymas
Kliento inicializavimas sumažėja iki trijų importavimų ir API rakto nuskaitymo iš aplinkos kintamųjų:
import os
from xai_sdk import Client
from xai_sdk.chat import user
client = Client(api_key=os.getenv("XAI_API_KEY"))
Aplinkos kintamasis XAI_API_KEY turi turėti tavo xAI API raktą. Niekada neįrašyk rakto tiesiai į kodą: jis atsidurtų „Git“ saugykloje, o vėliau – jos istorijoje, iš kurios jį pašalinti labai sunku.
4 agentų užklausa (greitoji veiksena)
Greitai ir tiksliai paieškai atlikti, kurdamas pokalbį, nurodyk agent_count=4:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4
)
chat.append(user("Išsamiai palygink TCP ir UDP"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Atkreipk dėmesį, kad atsakymą gauni naudodamas chat.stream(). Tai yra rekomenduojamas būdas: be jo tavo programa visos paieškos metu „pakibtų“ be jokių gyvybės požymių, ir niekas nepraneštų, ar užklausa vis dar vykdoma, ar jau žlugo.
16 agentų užklausa (išsami veiksena)
Perjungimas į išsamią veikseną reikalauja pakeisti tik vieną reikšmę, tačiau užklausa, kurią su ja derini, turi atitikti tavo diegiamos komandos mastą:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=16
)
chat.append(user(
"Pateik išsamią 2026 m. RAG architektūrų būklės apžvalgą, "
"palygindamas hibridinius metodus, našumą ir išlaidas"
))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Integruotų įrankių pridėjimas
Įrankius pridedi paprastu sąrašu, o SDK pateikia atitinkamus konstruktorius:
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("Kokie yra naujausi xAI pranešimai šią savaitę?"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Parametras include=["verbose_streaming"] keičia gaunamus duomenis: agentams dirbant, įrankių kvietimai rodomi realiuoju laiku, todėl žinai, į ką šiuo metu orientuota paieška.
Šifruotas turinys kelių etapų pokalbiams
Jei planuoji задаti kelis klausimus iš eilės ta pačia tema, kurdamas pokalbį įjunk šifruotą turinį:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4,
use_encrypted_content=True,
)
Tuomet modelis išlaiko sub-agentų būseną tarp etapų, todėl ilgesni mainai tampa daug nuoseklesni.
Klaidų apdorojimas
Kadangi API yra beta versijoje, užklausa gali nepavykti ne dėl tavo kaltės. Apgaubk kvietimą ir numatyk atsarginį planą:
try:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4
)
chat.append(user("Mano klausimas"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
except Exception as e:
print(f"Kelių agentų klaida: {e}")
# Jei reikia, grįžkite prie standartinio modelio
Komentaras paskutinėje eilutėje laukia, kol bus pakeistas tikru kodu. Gamtinėje aplinkoje šis blokas turi realiai perjungti veikimą į standartinį modelį, kitaip tavo funkcija nustoti veikti jau pirmą kartą, kai kelių agentų veiksena bus nepasiekiama.
Svarbiausi punktai
- xAI SDK atskleidžia
agent_count, kad galėtum tiesiogiai valdyti agentų skaičių - Kelių agentų veiksenai visada naudok srautinį perdavimą (
.stream()) verbose_streamingrealiuoju laiku atskleidžia įrankių kvietimus- Kelių etapų pokalbiams naudok
use_encrypted_content=True - Visada numatyk klaidų apdorojimą (beta API)