OpenAI Agents SDK API: настройка и подключение
OpenAI Agents SDK по умолчанию ходит в Responses API и отправляет трассы на сервер OpenAI. Для шлюза задайте свой клиент, переключите SDK на Chat Completions и отключите трассировку, иначе ключ уйдёт не туда.
- Тип: Фреймворк и SDK
- Протокол: OpenAI Chat Completions, OpenAI Responses
- Статус: Работает
- Версия при сверке: 0.22.3
Что заработает
| Возможность | Отметка | Примечание |
|---|---|---|
| Чат | Да | |
| Потоковый ответ | Да | |
| Вызов инструментов | Да | Работает у моделей с поддержкой инструментов. |
Настройка
Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.
Клиенту нужен ключ. Задайте его в переменной окружения RELAY_API_KEY: примеры ниже читают ключ оттуда. Чтобы переменная сохранялась между сеансами, добавьте строку export в ~/ (bash: ~/, bash на macOS: ~/), в PowerShell вызовите [Environment]::SetEnvironmentVariable с областью User, в cmd выполните setx и откройте новое окно. Окно, открытое до setx, переменную не увидит.
Ключ в переменной окружения
macOS и Linux
read -rs RELAY_API_KEY && export RELAY_API_KEYWindows PowerShell
$env:RELAY_API_KEY = "YOUR_API_KEY"Windows cmd
set "RELAY_API_KEY=YOUR_API_KEY"- Установите пакет
openai-agentsи задайте ключ в переменнойRELAY_API_KEY. - Создайте клиент
AsyncOpenAIс адресомhttps://и передайте его вrelay-llm.ru/ v1 set_default_openai_client. - Переключите SDK на Chat Completions и укажите модель из каталога, в примере
gpt-5.6-luna.
Пример на Python
import os
from agents import (
Agent,
Runner,
set_default_openai_api,
set_default_openai_client,
set_tracing_disabled,
)
from openai import AsyncOpenAI
client = AsyncOpenAI(base_url="https://relay-llm.ru/v1", api_key=os.environ["RELAY_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="Answer briefly.", model="gpt-5.6-luna")
print(Runner.run_sync(agent, "ping").final_output)Проверка
Сначала проверьте ключ и адрес без клиента. В ответе должно быть is_active: true.
macOS и Linux
curl https://relay-llm.ru/v1/key \
-H "Authorization: Bearer $RELAY_API_KEY"Windows PowerShell
curl.exe https://relay-llm.ru/v1/key `
-H "Authorization: Bearer $env:RELAY_API_KEY"Windows cmd
curl https://relay-llm.ru/v1/key ^
-H "Authorization: Bearer %RELAY_API_KEY%"Затем проверьте сам клиент.
Запустите пример: он напечатает ответ модели. Запись видна в журнале запросов кабинета.
Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.
Ограничения протоколов
OpenAI Chat Completions
Работают чат-модели каталога по пути /. Не поддерживаются /, /, /, /, Assistants и Realtime: функции клиента, которым они нужны, не заработают.
OpenAI Responses
Путь / поддержан, в том числе со стримингом. Параметры previous_response_id со значением resp_... и background: true возвращают 400: историю передавайте целиком в input. Идентификаторы элементов ответа шлюз заменяет своими.
Ловушки
set_default_openai_clientпо умолчанию использует ключ клиента для выгрузки трасс в OpenAI. Ключ шлюза уйдёт на сервер OpenAI. Задайтеuse_for_tracing=и вызовитеFalse set_tracing_disabled(True), как в примере.- По умолчанию SDK использует Responses. Для Chat Completions вызовите
set_default_openai_api("chat_completions"). Режим Responses шлюз поддерживает с ограничениями:previous_response_idсо значениемresp_...вернёт 400. - Адрес читается и из переменной
OPENAI_BASE_URL. - Версия для JavaScript отдельно не сверялась: настройки там могут отличаться.
Ссылки
Официальная документация: OpenAI Agents SDK API: настройка и подключение
Подключение клиентов: общие сведения и все клиенты