Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Teostus xAI SDK-ga

Õppetund 5 / 14 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Native xAI SDK
  2. Põhiseadistused
  3. 4-agendi päring (kiire režiim)
  4. 16-agendi päring (põhjalik režiim)
  5. Sisseehitatud tööriistade lisamine
  6. Krüpteeritud sisu mitmevoorulisteks vestlusteks
  7. Veakäsitlus
  8. Peamised punktid

Native xAI SDK

xAI SDK on kõige otsesem viis mitme agendi režiimi kasutamiseks ja ainus, mis paljastab parameetreid nagu agent_count, mida kolmandate osapoolte SDK-d ei paku. Kui alustad ilma ökosüsteemi piiranguteta, alusta siit: sul on juurdepääs kogu seadistuste valikule.

xai_sdk
Ametlik Pythoni pakett
agent_count
Eksklusiivne parameeter
Streaming
Reaalajas vastus
Tools
web_search, x_search...

Põhiseadistused

Kliendi initsialiseerimine taandub kolmele impordile ja API võtme lugemisele keskkonnamuutujast:

import os
from xai_sdk import Client
from xai_sdk.chat import user

client = Client(api_key=os.getenv("XAI_API_KEY"))

Keskkonnamuutuja XAI_API_KEY peab sisaldama sinu xAI API võtit. Ära kunagi kodeeri võtit otse koodi: see satuks Git’i hoidlasse ja selle ajalukku, kust seda on raske eemaldada.

4-agendi päring (kiire režiim)

Kiireks ja fokuseeritud otsinguks edasta agent_count=4, kui lood vestlust:

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=4
)
chat.append(user("Võrdle üksikasjalikult TCP-d ja UDP-d"))

for response, chunk in chat.stream():
    if chunk.content:
        print(chunk.content, end="", flush=True)

Pane tähele, et tarbid vastust meetodi chat.stream() kaudu. See on soovitatud viis: ilma selleta jääb su programm kogu otsingu ajaks elutuna seisma ja sa ei tea, kas päring töötab endiselt või on kokku jooksnud.

16-agendi päring (põhjalik režiim)

Põhjalikule režiimile üleminek nõuab ainult ühe väärtuse muutmist, kuid sellega kaasnev päring peab vastama sinu kasutusele võetava meeskonna mastaabile:

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=16
)
chat.append(user(
    "Anna mulle täielik ülevaade RAG arhitektuuridest aastal 2026, "
    "võrreldes hübriidlähenemisi, jõudlust ja kulusid"
))

for response, chunk in chat.stream():
    if chunk.content:
        print(chunk.content, end="", flush=True)

Sisseehitatud tööriistade lisamine

Lisad tööriistu lihtsa loendiga ja SDK pakub vastavaid konstruktoreid:

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("Millised on xAI viimased teadaanded sel nädalal?"))

for response, chunk in chat.stream():
    if chunk.content:
        print(chunk.content, end="", flush=True)

Parameeter include=["verbose_streaming"] muudab seda, mida saad: tööriistakutsed ilmuvad reaalajas, samal ajal kui agendid töötavad, ja sa tead, millele praegune otsing keskendub.

Krüpteeritud sisu mitmevoorulisteks vestlusteks

Kui plaanid sama teema kohta esitada järjest mitu küsimust, lülita vestluse loomisel sisse krüpteeritud sisu:

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=4,
    use_encrypted_content=True,
)

Mudel hoiab siis alaagentide olekut voorude vahel, mis muudab pikemad vahetused palju sidusamaks.

Veakäsitlus

Kuna API on beetaversioonis, võib päring ebaõnnestuda sinust sõltumatutel põhjustel. Paki kõne ümber ja planeeri varuväljapääs:

try:
    chat = client.chat.create(
        model="grok-4.20-multi-agent-0309",
        agent_count=4
    )
    chat.append(user("Minu küsimus"))

    for response, chunk in chat.stream():
        if chunk.content:
            print(chunk.content, end="", flush=True)
except Exception as e:
    print(f"Mitme agendi viga: {e}")
    # Vajadusel lange tagasi standardsele mudelile

Viimase rea kommentaar ootab asendamist tegeliku koodiga. Tooteversioonis peab see plokk tegelikult langema tagasi standardsele mudelile, vastasel juhul lakkab su funktsioon töötamast esimesel korral, kui mitme agendi režiim pole saadaval.

Peamised punktid

  • xAI SDK paljastab agent_count, et kontrollida agentide arvu otse
  • Kasuta mitme agendi puhul alati streamingut (.stream())
  • verbose_streaming paljastab tööriistakutsed reaalajas
  • use_encrypted_content=True mitmevooruliste vestluste jaoks
  • Planeeri alati veakäsitlust (beeta-API)