Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Implementácia pomocou xAI SDK

Lekcia 5 z 14 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Natívne xAI SDK
  2. Základné nastavenie
  3. Požiadavka pre 4 agentov (rýchly režim)
  4. Požiadavka pre 16 agentov (hĺbkový režim)
  5. Pridanie vstavaných nástrojov
  6. Šifrovaný obsah pre viac-krokové konverzácie
  7. Ošetrenie chýb
  8. Kľúčové poznatky

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

xai_sdk
Oficiálny balík pre Python
agent_count
Exkluzívny parameter
Streaming
Odozva v reálnom čase
Nástroje
web_search, x_search...

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_count na priamu kontrolu počtu agentov
  • Pre multi-agent vždy používaj streaming (.stream())
  • verbose_streaming odhaľuje volania nástrojov v reálnom čase
  • use_encrypted_content=True pre viac-krokové konverzácie
  • Vždy plánuj ošetrenie chýb (beta API)