Реализация с xAI SDK
На тази страница
Нативният xAI SDK
xAI SDK е най-прекият начин за използване на мулти-агентен режим и единственият, който излага параметри като agent_count, недостъпни за SDK на трети страни. Ако започвате без ограничения от екосистемата, започнете тук: ще имате достъп до пълния набор от настройки.
Основна настройка
Инициализирането на клиента се свежда до три импорта и четене на Вашия API ключ от средата:
import os
from xai_sdk import Client
from xai_sdk.chat import user
client = Client(api_key=os.getenv("XAI_API_KEY"))
Променливата на средата XAI_API_KEY трябва да съдържа Вашия xAI API ключ. Никога не вграждайте ключа директно в кода: той ще попадне в Git хранилището, след това в неговата история, откъдето е трудно да бъде премахнат.
Заявка с 4 агента (бърз режим)
За бързо и фокусирано търсене предавате agent_count=4, когато създавате чата:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4
)
chat.append(user("Compare TCP and UDP in detail"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Обърнете внимание, че консумирате отговора чрез chat.stream(). Това е препоръчителният метод: без него програмата Ви ще увисне без никакъв признак на живот за цялото време на търсенето и нищо няма да Ви подскаже дали заявката все още се изпълнява или е блокирала.
Заявка с 16 агента (задълбочен режим)
Превключването към задълбочен режим изисква само промяна на една стойност, но заявката, която съчетавате с него, трябва да отговаря на мащаба на екипа, който разполагате:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=16
)
chat.append(user(
"Give me a complete state of the art on RAG architectures in 2026, "
"comparing hybrid approaches, performance, and costs"
))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Добавяне на вградени инструменти
Добавяте инструменти чрез обикновен списък, а SDK предоставя съответните конструктори:
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("What are xAI's latest announcements this week?"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
Параметърът include=["verbose_streaming"] променя това, което получавате: извикванията на инструменти се появяват в реално време, докато агентите работят, и Вие знаете върху какво е фокусирано текущото търсене.
Криптирано съдържание за многократни разговори
Ако планирате да зададете няколко въпроса последователно по една и съща тема, включете криптирано съдържание, когато създавате чата:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4,
use_encrypted_content=True,
)
Моделът тогава запазва състоянието на под-агентите между отделните обръщения, което прави разширените размени много по-кохерентни.
Обработка на грешки
Тъй като API е в бета версия, една заявка може да се провали без Ваша вина. Оградете извикването и предвидете резервен план:
try:
chat = client.chat.create(
model="grok-4.20-multi-agent-0309",
agent_count=4
)
chat.append(user("My question"))
for response, chunk in chat.stream():
if chunk.content:
print(chunk.content, end="", flush=True)
except Exception as e:
print(f"Multi-agent error: {e}")
# Fall back to a standard model if needed
Коментарът на последния ред чака да бъде заменен с реален код. В производствена среда този блок трябва действително да превключи към стандартен модел, в противен случай Вашата функция ще спре да работи при първата недостъпност на мулти-агентния режим.
Ключови изводи
- xAI SDK излага
agent_count, за да контролирате директно броя на агентите - Винаги използвайте streaming за мулти-агентен режим (
.stream()) verbose_streamingразкрива извикванията на инструменти в реално време- Използвайте
use_encrypted_content=Trueза многократни разговори - Винаги планирайте обработка на грешки (бета API)