Implementacija s xAI SDK-om
Na ovoj stranici
Izvorni xAI SDK
xAI SDK najizravniji je način korištenja načina rada s više agenata i jedini koji izlaže parametre poput agent_count do kojih SDK-ovi trećih strana nemaju pristup. Ako krećeš bez ograničenja ekosustava, kreni ovdje: imat ćeš pristup cijelom skupu postavki.
Osnovno postavljanje
Inicijalizacija klijenta svodi se na tri uvoza i čitanje tvog API ključa iz okoline:
import os
from xai_sdk import Client
from xai_sdk.chat import user
client = Client(api_key=os.getenv("XAI_API_KEY"))
Varijabla okoline XAI_API_KEY mora sadržavati tvoj xAI API ključ. Nikada nemoj hardkodirati ključ: završio bi u Git repozitoriju, a zatim u njegovoj povijesti, gdje ga je teško ukloniti.
Zahtjev s 4 agenta (brzi način)
Za brzo i fokusirano pretraživanje prosljeđuješ agent_count=4 prilikom stvaranja chata:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4
)
chat.append(user("Detaljno usporedi TCP i UDP"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Imaj na umu da odgovor trošiš putem chat.stream(). To je preporučena metoda: bez nje tvoj program visi bez ikakvih znakova života tijekom cijelog pretraživanja, a ništa ti ne govori radi li se zahtjev još uvijek ili je srušio.
Zahtjev s 16 agenata (način dubinske analize)
Prelazak na način dubinske analize zahtijeva samo promjenu jedne vrijednosti, ali zahtjev koji s time upariš mora odgovarati razmjeru tima koji raspoređuješ:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=16
)
chat.append(user(
"Daj mi potpuni pregled najnovijih dostignuća u RAG arhitekturama za 2026., "
"uspoređujući hibridne pristupe, performanse i troškove"
))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Dodavanje ugrađenih alata
Alate dodaješ jednostavnim popisom, a SDK pruža odgovarajuće konstruktore:
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("Koje su najnovije najave xAI-ja ovaj tjedan?"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Parametar include=["verbose_streaming"] mijenja ono što primaš: pozivi alata pojavljuju se u stvarnom vremenu dok agenti rade, pa znaš na što je trenutno pretraživanje usmjereno.
Šifrirani sadržaj za razgovore u više koraka
Ako planiraš postaviti nekoliko pitanja zaredom na istu temu, uključi šifrirani sadržaj prilikom stvaranja chata:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4,
use_encrypted_content=True,
)
Model tada zadržava stanje podagenata između koraka, što produžene razmjene čini mnogo koherentnijima.
Rukovanje greškama
Budući da je API u beta fazi, zahtjev može neuspjeti bez tvoje krivnje. Obloži poziv i isplaniraj izlaznu strategiju:
try:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4
)
chat.append(user("Moje pitanje"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
except Exception as e:
print(f"Greška više agenata: {e}")
# Po potrebi se vrati na standardni model
Komentar u posljednjem retku čeka zamjenu stvarnim kodom. U proizvodnji ovaj blok mora stvarno prijeći na standardni model; inače će tvoja značajka prestati raditi čim više agenata bude nedostupno.
Ključne točke
- xAI SDK izlaže
agent_countza izravno upravljanje brojem agenata - Uvijek koristi streaming za više agenata (
.stream()) verbose_streamingotkriva pozive alata u stvarnom vremenuuse_encrypted_content=Trueza razgovore u više koraka- Uvijek isplaniraj rukovanje greškama (beta API)