Implementácia pomocou xAI SDK
Na tejto strane
Natívne xAI SDK
xAI SDK je najpriamejší spôsob, ako využiť režim viacerých agentov, a jediný, ktorý odhaľuje parametre ako agent_count, ktoré SDK tretích strán neposkytujú. Ak začínaš bez obmedzení ekosystému, začni práve tu: budeš mať prístup k celej sade nastavení.
Základné nastavenie
Inicializácia klienta sa obmedzuje na tri importy a načítanie tvojho API kľúča z prostredia:
import os
from xai_sdk import Client
from xai_sdk.chat import user
client = Client(api_key=os.getenv("XAI_API_KEY"))
Premenná prostredia XAI_API_KEY musí obsahovať tvoj API kľúč xAI. Nikdy kľúč neukladaj priamo do kódu: skončil by v Git repozitári, následne v jeho histórii, odkiaľ sa ťažko odstraňuje.
Požiadavka pre 4 agentov (rýchly režim)
Pre rýchle a cielené vyhľadávanie pri vytváraní chatu zadáš agent_count=4:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4
)
chat.append(user("Podrobne porovnaj TCP a UDP"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Všimni si, že odpoveď spracúvaš prostredníctvom chat.stream(). Toto je odporúčaná metóda: bez nej by sa tvoj program zasekol bez známky života na celú dobu vyhľadávania a nič by ti nenapovedalo, či požiadavka stále beží, alebo spadla.
Požiadavka pre 16 agentov (hĺbkový režim)
Prepnutie do hĺbkového režimu si vyžaduje zmenu len jednej hodnoty, ale požiadavka, ktorú s tým spáruješ, musí zodpovedať rozsahu tímu, ktorý nasadzuješ:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=16
)
chat.append(user(
"Poskytni mi kompletný prehľad stavu technológií architektúr RAG v roku 2026, "
"porovnaj hybridné prístupy, výkon a náklady"
))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Pridanie vstavaných nástrojov
Nástroje pridáš pomocou jednoduchého zoznamu a SDK poskytuje zodpovedajúce konštruktory:
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("Aké sú najnovšie oznámenia xAI z tohto týždňa?"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Parameter include=["verbose_streaming"] mení to, čo dostávaš: volania nástrojov sa zobrazujú v reálnom čase, zatiaľ čo agenti pracujú, a ty vieš, na čo sa aktuálne vyhľadávanie zameriava.
Šifrovaný obsah pre viac-krokové konverzácie
Ak plánuješ klásť niekoľko otázok po sebe na rovnakú tému, pri vytváraní chatu zapni šifrovaný obsah:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4,
use_encrypted_content=True,
)
Model si tak medzi jednotlivými krokmi uchováva stav sub-agentov, čo robí rozšírené výmeny oveľa koherentnejšími.
Ošetrenie chýb
Keďže API je v beta verzii, požiadavka môže zlyhať aj bez tvojej viny. Obal volanie a naplánuj si únikovú cestu:
try:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4
)
chat.append(user("Moja otázka"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
except Exception as e:
print(f"Chyba multi-agent: {e}")
# V prípade potreby prepadni na štandardný model
Komentár na poslednom riadku čaká na nahradenie skutočným kódom. V produkčnom prostredí musí tento blok reálne prepadnúť na štandardný model, inak tvoja funkcia prestane fungovať hneď pri prvom výskyte nedostupnosti multi-agent režimu.
Kľúčové poznatky
- xAI SDK odhaľuje
agent_countna priamu kontrolu počtu agentov - Pre multi-agent vždy používaj streaming (
.stream()) verbose_streamingodhaľuje volania nástrojov v reálnom časeuse_encrypted_content=Truepre viac-krokové konverzácie- Vždy plánuj ošetrenie chýb (beta API)