Съвместимост на OpenAI SDK
На тази страница
Използване на мулти-агент режим чрез OpenAI SDK
Много екипи вече са изградили своя слой за заявки около OpenAI SDK, заедно със своите обвивки, тестове и конвенции за логиране. Добрата новина е, че достъпът до мулти-агент режима на Grok не Ви принуждава да пренаписвате всичко. xAI предоставя API, съвместим с формата Responses на OpenAI, така че можете да запазите клиента на OpenAI и просто да го насочите към API на xAI.
Конфигурация на клиента
Необходими са Ви само две настройки: базовият URL на xAI и Вашият API ключ на xAI.
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1",
)
От този момент нататък използвате Responses API както обикновено, като посочвате grok-4.20-multi-agent-0309 като модел. Останалата част от кода за заявки остава непроменена.
Контрол на броя агенти чрез reasoning.effort
Тук се осъществява преводът между двата свята. Докато xAI SDK излага изричен параметър agent_count, OpenAI SDK предлага единствено reasoning.effort – така че не заявявате брой агенти, а ниво на усилие, което xAI преобразува в брой агенти.
# 4 агента (ниско усилие)
response = client.responses.create(
model="grok-4.20-multi-agent-0309",
reasoning={"effort": "low"},
input=[{"role": "user", "content": "What are the latest open source models from 2026?"}],
)
print(response.output_text)
# 16 агента (високо усилие)
response = client.responses.create(
model="grok-4.20-multi-agent-0309",
reasoning={"effort": "high"},
input=[{"role": "user", "content": "Compare the EU and US AI strategies in 2026"}],
)
print(response.output_text)
Съответствие effort → агенти
Полето приема четири стойности, но те генерират само два размера на екипа: "low" и "medium" използват 4 агента, докато "high" и "xhigh" използват 16.
Този детайл заслужава внимателно разглеждане. Преминаването от low към medium или от high към xhigh не променя броя на агентите: тези междинни нива могат да повлияят на други аспекти от поведението на модела, но във всяка двойка екипът остава същият. Представете си интерфейс, в който предлагате на потребителя четири нива на дълбочина на изследването – той ще възприеме само две, а допълнителните Ви два бутона единствено ще объркат избора му.
Chat Completions не се поддържа
Ето ограничението, в което повечето разработчици се спъват при първия си опит: Chat Completions не се поддържа за мулти-агент режим. Трябва да използвате Responses API, което означава client.responses.create, а не client.chat.completions.create.
# НЕ РАБОТИ
response = client.chat.completions.create(
model="grok-4.20-multi-agent-0309",
messages=[{"role": "user", "content": "..."}],
)
Тази заявка връща грешка. Ако съществуващият Ви код разчита изцяло на Chat Completions – както правят много текущи кодови бази – промяната не е просто замяна на името на модела: трябва да мигрирате заявката към различен входен и изходен формат. Преценете това усилие, преди да обещаєте интеграцията.
Стрийминг с OpenAI SDK
Стриймингът остава наличен, отново чрез Responses API:
stream = client.responses.create(
model="grok-4.20-multi-agent-0309",
reasoning={"effort": "low"},
input=[{"role": "user", "content": "Summarize this week's tech announcements"}],
stream=True,
)
for event in stream:
if hasattr(event, 'delta') and event.delta:
print(event.delta, end="", flush=True)
Проверката hasattr(event, 'delta') си заслужава да се запази такава, каквато е: потокът от събития на Responses API съдържа повече от просто текст и сляпото четене на event.delta при всяко събитие би предизвикало изключение.
Предимства и ограничения на този подход
Основното предимство на този път е спестеното време: не инсталирате друг SDK, Вашите разработчици получават познат синтаксис, а превключването между модели на xAI и OpenAI в една и съща кодова база става тривиално. За екип, който иска да оцени мулти-агент режима, без да се ангажира с пълен проект, това е най-краткият път.
Ограниченията всички произтичат от една и съща причина: минавате през слой за съвместимост, затова губите това, което е специфично за xAI. Не получавате agent_count (заменен от индиректен контрол чрез reasoning.effort), verbose_streaming или use_encrypted_content. Отгоре на това, съответствието effort → агенти идва от бета API и може да се промени: ако Вашият продукт зависи конкретно от броя използвани агенти, родният SDK остава разумният избор.
Ключови изводи
- OpenAI SDK работи с мулти-агент режим чрез
base_url="https://api.x.ai/v1" - Контролирате броя на агентите чрез
reasoning.effort(low/medium = 4, high/xhigh = 16) - Chat Completions НЕ се поддържа – използвайте единствено Responses API
- Някои параметри, ексклузивни за xAI SDK (
agent_count,verbose_streaming), не са налични