Implementace pomocí xAI SDK
Na této stránce
Natívní xAI SDK
xAI SDK je nejpřímější způsob, jak využít režim více agentů, a jediný, který zpřístupňuje parametry jako agent_count, jež SDK třetích stran nenabízejí. Pokud začínáš bez omezení daných ekosystémem, začni zde: získáš přístup k celé sadě nastavení.
Základní nastavení
Inicializace klienta spočívá ve třech importech a načtení tvého API klíče z prostředí:
import os
from xai_sdk import Client
from xai_sdk.chat import user
client = Client(api_key=os.getenv("XAI_API_KEY"))
Proměnná prostředí XAI_API_KEY musí obsahovat tvůj API klíč xAI. Klíč nikdy neukládej přímo do kódu: skončil by v Git repozitáři, následně v jeho historii, odkud se obtížně odstraňuje.
Požadavek se 4 agenty (rychlý režim)
Pro rychlé a cílené vyhledávání předáš při vytváření chatu parametr agent_count=4:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4
)
chat.append(user("Podrobně porovnej TCP a UDP"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Všimni si, že odpověď zpracováváš prostřednictvím chat.stream(). To je doporučená metoda: bez ní by se tvůj program na celou dobu vyhledávání zasekl bez jakékoli odezvy a nic by ti neřeklo, zda požadavek stále běží, nebo spadl.
Požadavek s 16 agenty (hloubkový režim)
Přepnutí do hloubkového režimu vyžaduje pouze změnu jedné hodnoty, ale požadavek, který k tomu připojíš, musí odpovídat rozsahu týmu, který nasazuješ:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=16
)
chat.append(user(
"Poskytni mi kompletní přehled současného stavu architektur RAG v roce 2026, "
"včetně porovnání hybridních přístupů, výkonu a nákladů"
))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Přidání vestavěných nástrojů
Nástroje přidáš pomocí jednoduchého seznamu a SDK poskytuje odpovídající konstruktory:
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("Jaká jsou nejnovější oznámení xAI z tohoto týdne?"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Parametr include=["verbose_streaming"] mění to, co přijímáš: volání nástrojů se zobrazují v reálném čase, zatímco agenti pracují, a ty víš, na co se aktuální vyhledávání zaměřuje.
Šifrovaný obsah pro vícekolové konverzace
Pokud plánuješ položit několik otázek po sobě na stejné téma, při vytváření 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 mezi jednotlivými koly uchovává stav sub-agentů, což činí rozsáhlejší výměny mnohem soudržnějšími.
Zpracování chyb
Protože je API ve fázi beta, může požadavek selhat bez tvé vlastní viny. Obal volání a připrav si únikovou cestu:
try:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4
)
chat.append(user("Moje otázka"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
except Exception as e:
print(f"Chyba více agentů: {e}")
# V případě potřeby přejdi na standardní model
Komentář na posledním řádku čeká na nahrazení skutečným kódem. V produkčním prostředí musí tento blok skutečně přejít na standardní model, jinak ti funkce přestane fungovat při první nedostupnosti režimu více agentů.
Klíčové poznatky
- xAI SDK zpřístupňuje
agent_countpro přímé řízení počtu agentů - Pro více agentů vždy používej streaming (
.stream()) verbose_streamingodhaluje volání nástrojů v reálném čase- Pro vícekolové konverzace použij
use_encrypted_content=True - Vždy plánuj zpracování chyb (API je v beta verzi)