Премини към основното съдържание
Български— Изберете език
Меню

Реализация с xAI SDK

Урок 5 от 14 Обновен 29 юли 2026 г. Програмист
На тази страница
  1. Нативният xAI SDK
  2. Основна настройка
  3. Заявка с 4 агента (бърз режим)
  4. Заявка с 16 агента (задълбочен режим)
  5. Добавяне на вградени инструменти
  6. Криптирано съдържание за многократни разговори
  7. Обработка на грешки
  8. Ключови изводи

Нативният xAI SDK

xAI SDK е най-прекият начин за използване на мулти-агентен режим и единственият, който излага параметри като agent_count, недостъпни за SDK на трети страни. Ако започвате без ограничения от екосистемата, започнете тук: ще имате достъп до пълния набор от настройки.

xai_sdk
Официален Python пакет
agent_count
Ексклузивен параметър
Streaming
Отговор в реално време
Tools
web_search, x_search...

Основна настройка

Инициализирането на клиента се свежда до три импорта и четене на Вашия 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)