Implementacija s paketom SDK xAI
Na tej strani
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.
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_countza neposreden nadzor števila agentov - Za večagentne sisteme vedno uporabi streaming (
.stream()) verbose_streamingrazkrije klice orodij v realnem času- Za večkratne pogovore uporabi
use_encrypted_content=True - Vedno načrtuj obravnavo napak (API v beta različici)