Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Implementacija s paketom SDK xAI

Lekcija 5 od 14 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Izvirni paket SDK xAI
  2. Osnovna nastavitev
  3. Zahteva za 4 agente (hitri način)
  4. Zahteva za 16 agentov (poglobljeni način)
  5. Dodajanje vgrajenih orodij
  6. Šifrirana vsebina za večkratne pogovore
  7. Obravnava napak
  8. Ključne ugotovitve

Izvirni paket SDK xAI

Paket SDK xAI je najbolj neposreden način za uporabo načina z več agenti in edini, ki omogoča dostop do parametrov, kot je agent_count, ki jih paketi SDK tretjih strani ne podpirajo. Če nimaš omejitev glede ekosistema, začni tukaj: imel boš dostop do celotnega nabora nastavitev.

xai_sdk
Uradni paket za Python
agent_count
Ekskluzivni parameter
Streaming
Odziv v realnem času
Orodja
web_search, x_search...

Osnovna nastavitev

Inicializacija klienta zahteva le tri uvoze in branje ključa API iz okolja:

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

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

Okoljska spremenljivka XAI_API_KEY mora vsebovati tvoj ključ API za xAI. Ključa nikoli ne vgrajuj neposredno v kodo: končal bi v repozitoriju Git, nato v njegovi zgodovini, od koder ga je težko odstraniti.

Zahteva za 4 agente (hitri način)

Za hitro in usmerjeno iskanje ob ustvarjanju klepeta podaj agent_count=4:

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=4
)
chat.append(user("Podrobno primerjaj TCP in UDP"))

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

Upoštevaj, da odziv porabiš prek chat.stream(). To je priporočena metoda: brez nje se tvoj program med celotnim iskanjem obesí brez znakov življenja, nič pa ti ne pove, ali se zahtevek še izvaja ali se je sesul.

Zahteva za 16 agentov (poglobljeni način)

Preklop v poglobljeni način zahteva le spremembo ene vrednosti, vendar mora biti zahtevek, ki ga s tem povežeš, prilagojen obsegu ekipe, ki jo razporejaš:

chat = client.chat.create(
    model="grok-4.20-multi-agent-0309",
    agent_count=16
)
chat.append(user(
    "Pripravi popoln pregled stanja tehnologije za arhitekture RAG leta 2026, "
    "s primerjavo hibridnih pristopov, zmogljivosti in stroškov"
))

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

Dodajanje vgrajenih orodij

Orodja dodaš s preprostim seznamom, paket SDK pa zagotavlja ustrezne konstruktorje:

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("Kakšne so najnovejše napovedi xAI ta teden?"))

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

Parameter include=["verbose_streaming"] spremeni, kaj prejmeš: klici orodij se prikažejo v realnem času, medtem ko agenti delajo, in veš, na kaj je trenutno usmerjeno iskanje.

Šifrirana vsebina za večkratne pogovore

Če nameravaš zaporedoma zastaviti več vprašanj na isto temo, ob ustvarjanju klepeta vklopi šifrirano vsebino:

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

Model tako ohranja stanje pod-agentov med zaporednimi koraki, kar podaljšane izmenjave naredi veliko bolj koherentne.

Obravnava napak

Ker je API v beta različici, lahko zahtevek odpove brez tvoje krivde. Obdaj klic in načrtuj izhodno pot:

try:
    chat = client.chat.create(
        model="grok-4.20-multi-agent-0309",
        agent_count=4
    )
    chat.append(user("Moje vprašanje"))

    for response, chunk in chat.stream():
        if chunk.content:
            print(chunk.content, end="", flush=True)
except Exception as e:
    print(f"Napaka večagentnega sistema: {e}")
    # Po potrebi preklopi na standardni model

Komentar v zadnji vrstici čaka na zamenjavo z dejansko kodo. V produkcijskem okolju mora ta blok dejansko izvesti preklop na standardni model, sicer tvoja funkcionalnost preneha delovati že ob prvi nedostopnosti večagentnega sistema.

Ključne ugotovitve

  • Paket SDK xAI omogoča parameter agent_count za neposreden nadzor števila agentov
  • Za večagentne sisteme vedno uporabi streaming (.stream())
  • verbose_streaming razkrije klice orodij v realnem času
  • Za večkratne pogovore uporabi use_encrypted_content=True
  • Vedno načrtuj obravnavo napak (API v beta različici)