Implementálás az xAI SDK-val
Ezen az oldalon
A natív xAI SDK
Az xAI SDK a legközvetlenebb módja a többügynökös mód használatának, és ez az egyetlen, amely olyan paramétereket tesz elérhetővé, mint az agent_count, amelyeket a harmadik féltől származó SDK-k nem támogatnak. Ha nincs kötve konkrét ökoszisztémához, kezdj itt: így hozzáférész a beállítások teljes készletéhez.
Alapbeállítás
A kliens inicializálása három importálásból és az API-kulcs környezeti változóból történő beolvasásából áll:
import os
from xai_sdk import Client
from xai_sdk.chat import user
client = Client(api_key=os.getenv("XAI_API_KEY"))
Az XAI_API_KEY környezeti változónak tartalmaznia kell az xAI API-kulcsodat. Soha ne kódold be közvetlenül a kulcsot: így belekerülne a Git tárolóba, majd annak előzményeibe is, ahonnan nehéz eltávolítani.
4 ügynökös kérés (gyors mód)
Egy gyors, fókuszált kereséshez add meg az agent_count=4 értéket a csevegés létrehozásakor:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4
)
chat.append(user("Hasonlítsd össze részletesen a TCP-t és az UDP-t"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Vedd észre, hogy a választ a chat.stream() metóduson keresztül fogyasztod el. Ez az ajánlott módszer: enélkül a programod életjel nélkül lógna a teljes keresés ideje alatt, és semmi sem jelezné, hogy a kérés még fut, vagy összeomlott-e.
16 ügynökös kérés (mélyreható mód)
A mélyreható módra való váltáshoz csak egyetlen értéket kell megváltoztatnod, de a hozzá társított kérésnek összhangban kell lennie a bevetett csapat méretével:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=16
)
chat.append(user(
"Adj egy teljes állapotfelmérést a RAG architektúrákról 2026-ban, "
"összehasonlítva a hibrid megközelítéseket, a teljesítményt és a költségeket"
))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Beépített eszközök hozzáadása
Az eszközöket egy egyszerű listával adhatod hozzá, és az SDK biztosítja a megfelelő konstruktort:
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("Mik az xAI legfrissebb bejelentései ezen a héten?"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Az include=["verbose_streaming"] paraméter megváltoztatja, mit kapsz vissza: az eszközlehívások valós időben jelennek meg, miközben az ügynökök dolgoznak, így látod, mire fókuszál az aktuális keresés.
Titkosított tartalom többmenetes beszélgetésekhez
Ha ugyanarról a témáról szeretnél egymás után több kérdést feltenni, engedélyezd a titkosított tartalmat a csevegés létrehozásakor:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4,
use_encrypted_content=True,
)
A modell így megőrzi az alügynökök állapotát a menetek között, ami sokkal koherensebbé teszi a hosszabb beszélgetéseket.
Hibakezelés
Mivel az API még béta verzióban van, a kérés a te hibádon kívül is meghiúsulhat. Csomagold be a hívást, és tervezz ki menekülő útvonalat:
try:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4
)
chat.append(user("A kérdésem"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
except Exception as e:
print(f"Többügynökös hiba: {e}")
# Szükség esetén térj vissza egy szabványos modellre
Az utolsó sorban lévő megjegyzés arra vár, hogy valódi kódra cseréld. Éles környezetben ennek a blokknak ténylegesen vissza kell térnie egy szabványos modellhez, különben a funkcióod már az első alkalommal leáll, amikor a többügynökös mód nem elérhető.
Főbb megállapítások
- Az xAI SDK elérhetővé teszi az
agent_countparamétert az ügynökök számának közvetlen vezérléséhez - Többügynökös módban mindig használd a streaminget (
.stream()) - A
verbose_streamingvalós időben fedi fel az eszközlehívásokat - Használd a
use_encrypted_content=Trueértéket többmenetes beszélgetésekhez - Mindig tervezz hibakezelést (béta API)