Что это
OpenAI Agents SDK - библиотека для Python и TypeScript. Вы описываете агента и доступные инструменты, а SDK ведет цикл вызовов модели и возвращает результат. Это код внутри вашего приложения, не готовый чат и не отдельная модель.
Можно добавить handoffs между специалистами, сохранение истории, проверки и подтверждение действий человеком. Эти возможности нужно настроить: системная инструкция сама по себе не ограничивает права функции. Поиск по файлам и вебу тоже требует подходящих инструментов и провайдера.
SDK и модель размещаются независимо. Программа может работать на вашем сервере, а запросы идти в облако. Не путайте библиотеку с управляемым Agents API, где запуском занимается сервис OpenAI. Начните с одного агента и учебных данных, прежде чем подключать рабочие системы.
Ключевые параметры
- Категория: Платформы AI-агентов
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Да
- Данные: Не известно
- Чувствительные данные: Только с настройками
Доступные модели и версии
Сильные стороны
- Один цикл запуска связывает ответы модели и вызовы явно подключенных инструментов.
- Handoffs позволяют передать задачу выбранному специалисту без собственного механизма маршрутизации.
- Возобновляемое состояние помогает приостановить действие для одобрения человеком.
- Встроенная трассировка показывает вызовы модели, инструментов и передачу задачи.
Ограничения
- Нужны разработка, размещение приложения и отдельный доступ к модели.
- Guardrails не проверяют автоматически каждое действие: границы входа, выхода и функций различаются.
- Историю, сроки хранения и изоляцию пользователей нужно проектировать; session не является готовой корпоративной памятью.
- Трассы могут содержать входы и результаты инструментов; настройки и права нужно проверить до работы с закрытыми данными.
Как использовать
1. Подготовка. Выделите учебный проект Python и проверьте доступ к выбранному провайдеру. Для прямого OpenAI API нужна поддерживаемая страна и отдельная оплата. Используйте вымышленные данные.
2. Настройка. Установите pip install openai-agents. Для OpenAI задайте OPENAI_API_KEY в окружении, создайте Agent с явным доступным model и инструкцией отвечать только по переданному тексту. Инструменты пока не подключайте.
3. Первый результат. Вызовите Runner.run с агентом и строкой «Магазин открыт с 10 до 18. Доставка занимает 2 дня. Назови время работы и срок доставки». Прочитайте result.final_output; для Python используйте асинхронный пример Quickstart.
4. Проверка. Сверьте 10-18 и 2 дня, посмотрите вызов в Traces и usage. Спросите о неизвестной гарантии: агент должен указать отсутствие данных. Затем добавляйте одну функцию только чтения с проверкой аргументов; запись требует отдельного разрешения, а не обещания в промпте.
Доступ и оплата
- Модель оплаты: Open-source
- Бесплатный тариф: Да
- Работа в РФ: Ограниченно
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Библиотека доступна как открытый код; free_plan здесь относится к SDK, а не бесплатным запросам модели. Сверьте LICENSE выбранной версии пакета. Прямой OpenAI API не поддерживает Россию; другой провайдер требует отдельной настройки и проверки совместимости, оплаты и региональных условий.
Когда не подходит
- Получить готовый сервис без разработки
- Считать локальный SDK офлайн-моделью
- Давать агенту доступ ко всем функциям без проверок
Альтернативы
LangGraph удобен для явных переходов и состояния процесса. CrewAI ориентирован на роли и задачи команды агентов. Google ADK - другой фреймворк агентных приложений. Во всех случаях платная модель и инфраструктура не становятся бесплатными из-за открытой библиотеки.
