К содержимому

OpenAI Agents SDK API: настройка и подключение

OpenAI Agents SDK по умолчанию ходит в Responses API и отправляет трассы на сервер OpenAI. Для шлюза задайте свой клиент, переключите SDK на Chat Completions и отключите трассировку, иначе ключ уйдёт не туда.

  • Тип: Фреймворк и SDK
  • Протокол: OpenAI Chat Completions, OpenAI Responses
  • Статус: Работает
  • Версия при сверке: 0.22.3
Настройки сверены с официальной документацией клиента, 2026-10-02. Не проверено вручную: запуск клиента против шлюза не выполнялся.

Что заработает

ВозможностьОтметкаПримечание
ЧатДа
Потоковый ответДа
Вызов инструментовДаРаботает у моделей с поддержкой инструментов.

Настройка

Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.

Клиенту нужен ключ. Задайте его в переменной окружения RELAY_API_KEY: примеры ниже читают ключ оттуда. Чтобы переменная сохранялась между сеансами, добавьте строку export в ~/.zshrc (bash: ~/.bashrc, bash на macOS: ~/.bash_profile), в PowerShell вызовите [Environment]::SetEnvironmentVariable с областью User, в cmd выполните setx и откройте новое окно. Окно, открытое до setx, переменную не увидит.

Ключ в переменной окружения

macOS и Linux

bash
read -rs RELAY_API_KEY && export RELAY_API_KEY

Windows PowerShell

bash
$env:RELAY_API_KEY = "YOUR_API_KEY"

Windows cmd

bash
set "RELAY_API_KEY=YOUR_API_KEY"
  1. Установите пакет openai-agents и задайте ключ в переменной RELAY_API_KEY.
  2. Создайте клиент AsyncOpenAI с адресом https://relay-llm.ru/v1 и передайте его в set_default_openai_client.
  3. Переключите SDK на Chat Completions и укажите модель из каталога, в примере gpt-5.6-luna.

Пример на Python

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

bash
curl https://relay-llm.ru/v1/key \
  -H "Authorization: Bearer $RELAY_API_KEY"

Windows PowerShell

bash
curl.exe https://relay-llm.ru/v1/key `
  -H "Authorization: Bearer $env:RELAY_API_KEY"

Windows cmd

bash
curl https://relay-llm.ru/v1/key ^
  -H "Authorization: Bearer %RELAY_API_KEY%"

Затем проверьте сам клиент.

Запустите пример: он напечатает ответ модели. Запись видна в журнале запросов кабинета.

Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.

Ограничения протоколов

OpenAI Chat Completions

Работают чат-модели каталога по пути /v1/chat/completions. Не поддерживаются /v1/embeddings, /v1/audio/*, /v1/moderations, /v1/batches, Assistants и Realtime: функции клиента, которым они нужны, не заработают.

OpenAI Responses

Путь /v1/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: настройка и подключение

Подключение клиентов: общие сведения и все клиенты

Обработка ошибок и повторы

Модели и ключ: список моделей в API

Ключи в кабинете

Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key