Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Įgyvendinimas naudojant xAI SDK

Paskaita 5 iš 14 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Gimtasis xAI SDK
  2. Pagrindinis nustatymas
  3. 4 agentų užklausa (greitoji veiksena)
  4. 16 agentų užklausa (išsami veiksena)
  5. Integruotų įrankių pridėjimas
  6. Šifruotas turinys kelių etapų pokalbiams
  7. Klaidų apdorojimas
  8. Svarbiausi punktai

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ų.

xai_sdk
Oficialus Python paketas
agent_count
Ekskliuzyvus parametras
Streaming
Atsakymas realiuoju laiku
Įrankiai
web_search, x_search...

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_streaming realiuoju laiku atskleidžia įrankių kvietimus
  • Kelių etapų pokalbiams naudok use_encrypted_content=True
  • Visada numatyk klaidų apdorojimą (beta API)