Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Implementacija s xAI SDK-om

Lekcija 5 od 14 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Izvorni xAI SDK
  2. Osnovno postavljanje
  3. Zahtjev s 4 agenta (brzi način)
  4. Zahtjev s 16 agenata (način dubinske analize)
  5. Dodavanje ugrađenih alata
  6. Šifrirani sadržaj za razgovore u više koraka
  7. Rukovanje greškama
  8. Ključne točke

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.

xai_sdk
Službeni Python paket
agent_count
Ekskluzivni parametar
Streaming
Odgovor u stvarnom vremenu
Alati
web_search, x_search...

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_count za izravno upravljanje brojem agenata
  • Uvijek koristi streaming za više agenata (.stream())
  • verbose_streaming otkriva pozive alata u stvarnom vremenu
  • use_encrypted_content=True za razgovore u više koraka
  • Uvijek isplaniraj rukovanje greškama (beta API)