Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Implementace pomocí xAI SDK

Lekce 5 z 14 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Natívní xAI SDK
  2. Základní nastavení
  3. Požadavek se 4 agenty (rychlý režim)
  4. Požadavek s 16 agenty (hloubkový režim)
  5. Přidání vestavěných nástrojů
  6. Šifrovaný obsah pro vícekolové konverzace
  7. Zpracování chyb
  8. Klíčové poznatky

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í.

xai_sdk
Oficiální balíček pro Python
agent_count
Exkluzivní parametr
Streaming
Odezva v reálném čase
Nástroje
web_search, x_search...

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_count pro přímé řízení počtu agentů
  • Pro více agentů vždy používej streaming (.stream())
  • verbose_streaming odhaluje 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)