---
title: "OpenAI Agents SDK со своим OpenAI-совместимым провайдером"
description: "Как запустить OpenAI Agents SDK для Python на BroadNet Inference через AsyncOpenAI и OpenAIChatCompletionsModel и отключить трейсинг, которому нужен ключ OpenAI."
url: https://broadrouter.com/ru/guides/openai-agents-sdk-custom-provider/
lang: ru
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Переведено с английского с помощью ИИ. [Читать оригинал на английском](https://broadrouter.com/guides/openai-agents-sdk-custom-provider/) (обновлён 2026-11-16).

# OpenAI Agents SDK на BroadNet Inference

Обновлено 2026-11-16

Создайте клиент AsyncOpenAI с base\_url https://inference.broadnet.ai/v1 и ключом BroadNet, оберните его в OpenAIChatCompletionsModel с ID модели, например broadnet/glm-5.3, и передайте эту модель в Agent. Вызовите set\_tracing\_disabled(True), если у вас нет отдельного ключа OpenAI для трейсинга.

OpenAI Agents SDK — фреймворк на Python для агентов с инструментами, передачей управления (handoffs) и ограничителями (guardrails). В его документации описано, как подключать провайдеров, отличных от OpenAI. Для OpenAI-совместимого API вроде BroadNet Inference вы передаёте SDK собственный клиент `AsyncOpenAI` и используете класс модели для Chat Completions. По умолчанию SDK работает через Responses API, который многие провайдеры не поддерживают.

## Настройка

1.  **Установите SDK.** Нужен Python 3.10 или новее.

```bash
pip install openai-agents
export BROADNET_API_KEY='your-broadnet-key'
```

2.  **Создайте клиент, модель и агента.** Комментарий в коде напоминает, что для трейсинга нужен ключ с platform.openai.com; инструкции и вопрос агенту написаны по-английски.

```python
import asyncio
import os

from agents import (
    Agent,
    AsyncOpenAI,
    OpenAIChatCompletionsModel,
    Runner,
    function_tool,
    set_tracing_disabled,
)

set_tracing_disabled(disabled=True)  # tracing needs a platform.openai.com key

client = AsyncOpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)

model = OpenAIChatCompletionsModel(model="broadnet/glm-5.3", openai_client=client)

@function_tool
def get_order_status(order_id: str) -> str:
    """Look up an order."""
    return f"Order {order_id}: shipped"

agent = Agent(
    name="Support agent",
    instructions="Answer briefly. Use tools when you need order data.",
    model=model,
    tools=[get_order_status],
)

async def main():
    result = await Runner.run(agent, "Where is order 4471?")
    print(result.final_output)

asyncio.run(main())
```

3.  **Запустите.** Агент должен вызвать `get_order_status` и ответить по его результату.

## Три способа подключить провайдера

В документации SDK перечислены такие встроенные варианты:

-   **Для отдельного агента:** передайте `OpenAIChatCompletionsModel` в `Agent.model`, как выше. Подходит, когда разные агенты работают с разными провайдерами.
-   **Глобально по умолчанию:** `set_default_openai_client(client)` делает ваш клиент клиентом по умолчанию. Используйте его вместе с `set_default_openai_api("chat_completions")`.
-   **Для отдельного запуска:** передайте свой `ModelProvider` в `RunConfig(model_provider=...)`.

Глобальная настройка по умолчанию выглядит так:

```python
import os
from agents import (
    Agent,
    AsyncOpenAI,
    set_default_openai_api,
    set_default_openai_client,
    set_tracing_disabled,
)

client = AsyncOpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
set_default_openai_client(client, use_for_tracing=False)
set_default_openai_api("chat_completions")
set_tracing_disabled(True)

agent = Agent(name="Assistant", instructions="Be brief.", model="broadnet/glm-5.3")
```

Если вы настраиваете всё только переменными окружения, задайте `OPENAI_BASE_URL=https://inference.broadnet.ai/v1`, а в `OPENAI_API_KEY` — ключ BroadNet, после чего сделайте те же вызовы `set_default_openai_api` и `set_tracing_disabled`.

По документации SDK, при работе через Chat Completions он молча отбрасывает поля, которые есть только в Responses API, например `previous_response_id`, `conversation_id` и `prompt`. Чтобы вместо этого получать ошибку, задайте `strict_feature_validation=True` у `OpenAIProvider`. Состояние диалога храните в своём коде: например, передавайте список входных данных из предыдущего результата в следующий запуск. Встроенных инструментов OpenAI, таких как веб-поиск и поиск по файлам, у других провайдеров нет. Всё, что агент должен вызывать, оформляйте через `function_tool`.

## Трейсинг

Трейсинг включён по умолчанию и отправляет трассировки в OpenAI. Документация SDK говорит, что без API-ключа с platform.openai.com его нужно отключить через `set_tracing_disabled()` или настроить другой процессор трейсинга. Если ключ OpenAI у вас есть, трейсинг можно оставить и передать этот ключ через `set_tracing_export_api_key(...)`. SDK использует его только для загрузки трассировок. Ключ BroadNet для этого не подойдёт.

## Какую модель выбрать

| Тип агента | Модель | Примечания |
| --- | --- | --- |
| Агенты с инструментами | [GLM 5.3](https://broadrouter.com/ru/models/glm-5.3/) | Заявлены инструменты и структурированный вывод; контекст 1 млн |
| Изображения на входе и инструменты | [Qwen3.8 27B](https://broadrouter.com/ru/models/qwen3.8-27b/) | Контекст 262K; протестирована на арабском |
| Долгоживущие агенты по фиксированной цене | [DeepSeek V4.1 Flash](https://broadrouter.com/ru/models/deepseek-v4.1-flash/) | Безлимитные тарифы; инструменты у BroadNet не заявлены |

Документация SDK предупреждает, что некоторые провайдеры не поддерживают структурированный вывод по JSON-схеме. Если вы задаёте агенту `output_type`, используйте GLM 5.3 или Qwen3.8 27B. Цены сравните на [странице цен](https://broadrouter.com/ru/pricing/).

## Решение проблем

-   **401.** Ключ BroadNet неверен, истёк или исчерпан лимит оплаты по факту. Ошибки трейсинга в логах — отдельная история: они означают, что трейсинг всё ещё включён без ключа OpenAI.
-   **404 или «not found».** Скорее всего, запросы идут в Responses API. Используйте `OpenAIChatCompletionsModel` или `set_default_openai_api("chat_completions")`. Если это уже сделано, проверьте, что ID модели точно совпадает с ID BroadNet. Для платных моделей нужно пополнить баланс; грант $5 покрывает только Gemma 4 VL 26B.
-   **Пустой `final_output`.** Рассуждения учитываются в `max_tokens`. Если вы задаёте `ModelSettings(max_tokens=...)`, увеличьте значение. [Почему ответы приходят пустыми](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/).
-   **429.** Ключ с оплатой по факту допускает 30 запросов в минуту и 4 одновременно. Каждый вызов инструмента туда и обратно — новый запрос. См. [ошибки и повторные запросы](https://broadrouter.com/ru/guides/errors-and-retries/).
-   **Параллельные агенты на тарифе.** Одна [сессия безлимитного тарифа](https://broadrouter.com/ru/guides/unlimited-llm-api-sessions/) обрабатывает один запрос за раз. Агентам, запущенным вместе через `asyncio.gather`, нужно по сессии на каждого, иначе они встанут в очередь. См. [как запускать параллельных агентов по фиксированной цене](https://broadrouter.com/ru/blog/run-parallel-coding-agents-flat-rate/).

## Термины в этом руководстве

[ИИ-агент (AI agent)](https://broadrouter.com/ru/glossary/agent/)

ИИ-агент — это система, в которой языковая модель сама направляет свои шаги к цели: решает, какие инструменты вызвать, читает результаты и повторяет, пока не выдаст итоговый ответ или не упрётся в лимит. Фиксированный сценарий, который вызывает модель в заранее заданных местах, обычно называют не агентом, а workflow.

[Контекстное окно (context window)](https://broadrouter.com/ru/glossary/context-window/)

Контекстное окно — это максимальное число токенов, с которым языковая модель может работать в одном запросе. В него входят промпт, история диалога, описания инструментов, изображения и сгенерированный ответ, включая токены рассуждений. Всё, что не помещается, приходится обрезать, сжимать в краткое изложение или делить на несколько запросов.

[Лимит запросов (rate limit)](https://broadrouter.com/ru/glossary/rate-limit/)

Лимит запросов (rate limit) — это ограничение, которое API накладывает на объём использования клиентом за отрезок времени, например число запросов или токенов в минуту. Запросы сверх лимита отклоняются, обычно с HTTP 429 Too Many Requests, пока использование снова не опустится ниже порога.

[Ограничители (guardrails)](https://broadrouter.com/ru/glossary/guardrails/)

Ограничители (guardrails) — это проверки, которые приложение выполняет вокруг вызова языковой модели, чтобы удерживать её в заданных рамках. Входные проверяют то, что попадает в модель, выходные — то, что из неё выходит, а ограничители инструментов проверяют действия до их выполнения. Проваленная проверка блокирует, переписывает или помечает запрос.

[Оплата по факту (pay-as-you-go)](https://broadrouter.com/ru/glossary/pay-as-you-go/)

Оплата по факту (pay-as-you-go) — это модель ценообразования, при которой вы платите только за то, что использовали, по счётчику в единицах вроде токенов, запросов или минут аудио, без подписки и минимальных обязательств. Так тарифицирует большинство LLM API — с предоплаченного баланса или по периодическому счёту.

[Параллельность (concurrency)](https://broadrouter.com/ru/glossary/concurrency/)

Параллельность (concurrency) — это число запросов, которые клиент одновременно держит в работе. LLM API часто ограничивают её на ключ или тариф отдельно от лимита запросов в минуту, потому что каждый открытый запрос занимает мощности GPU, пока ответ не будет готов.

[Chat Completions API](https://broadrouter.com/ru/glossary/chat-completions-api/)

Chat Completions API — это HTTP-эндпоинт OpenAI, POST /v1/chat/completions, который принимает имя модели и список сообщений с ролями и возвращает следующее сообщение модели. Формат его запроса и ответа стал общим стандартом, который повторяют OpenAI-совместимые провайдеры и SDK.

[Структурированный вывод (structured output)](https://broadrouter.com/ru/glossary/structured-output/)

Структурированный вывод — это функция LLM API, которая ограничивает ответ модели форматом, заданным разработчиком, обычно JSON Schema, чтобы код мог надёжно его разобрать. Он строже, чем JSON mode, который гарантирует корректный JSON, но не конкретную структуру.

## Вопросы и ответы

### Почему Agents SDK со своим base URL возвращает ошибки 404?

По умолчанию SDK использует Responses API, а BroadNet обслуживает chat completions. Используйте OpenAIChatCompletionsModel или, если клиент настраивается через переменные окружения, вызовите set\_default\_openai\_api("chat\_completions").

### Почему Agents SDK ругается на трейсинг?

Трейсинг отправляет данные в OpenAI, и для него нужен ключ с platform.openai.com. Если такого ключа нет, документация SDK советует вызвать set\_tracing\_disabled() или подключить другой процессор трейсинга.

### Можно ли настроить Agents SDK только переменными окружения?

Да. Задайте OPENAI\_BASE\_URL равным https://inference.broadnet.ai/v1, а в OPENAI\_API\_KEY — ключ BroadNet, затем вызовите set\_default\_openai\_api("chat\_completions") и set\_tracing\_disabled(True). OPENAI\_DEFAULT\_MODEL задаёт модель для агентов, у которых она не указана.

### Сколько сессий тарифа нужно для запуска нескольких агентов?

По одной на каждый запрос, который выполняется одновременно с другими. При handoff агенты работают по очереди, поэтому хватит одной сессии. Агентам, запущенным параллельно через asyncio.gather, нужно по сессии на каждого.

## Похожие руководства

-   [OpenAI Python SDK и BroadNet Inference](https://broadrouter.com/ru/guides/openai-python-sdk/)
-   [Как устроены безлимитные тарифы LLM API для агентов](https://broadrouter.com/ru/guides/unlimited-llm-api-sessions/)
-   [Почему рассуждающая модель возвращает пустой ответ](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/)
-   [LiteLLM и BroadNet Inference: SDK и прокси](https://broadrouter.com/ru/guides/litellm-proxy-custom-provider/)
-   [Все инструменты, которые работают с BroadNet Inference (на английском)](https://broadrouter.com/integrations/): SDK, агенты для программирования, чат-интерфейсы и инструменты автоматизации с точными настройками для каждого

Проверьте на своей реальной нагрузке. Новые аккаунты получают стартовый грант US$5 на Gemma и распознавание речи. Для DeepSeek, GLM и Qwen3.8 нужно пополнить баланс.

[Начать](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-guides-openai-agents-sdk-custom-provider&utm_content=page-cta) ·

**Источники**

-   [Документация OpenAI Agents SDK, Models (провайдеры, отличные от OpenAI) (дата обращения 2026-11-14)](https://openai.github.io/openai-agents-python/models/)
-   [PyPI, пакет openai-agents (0.24, Python 3.10+, дата обращения 2026-11-14)](https://pypi.org/project/openai-agents/)
-   [Справочник API BroadNet Inference (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-guides-openai-agents-sdk-custom-provider&utm_content=sources)
