Google перевела Gemini API на новый интерфейс: агентные функции доступны только через него

С декабря 2025 года Interactions API работал в публичной бета-версии. По данным Google, за это время он стал самым популярным способом сборки приложений на базе Gemini среди разработчиков. Теперь API получил стабильную схему и набор возможностей, которые разработчики просили в обратной связи: управляемых ИИ-агентов, фоновое выполнение задач, генерацию медиа и обновлённый Deep Research. Документация Google AI Studio по умолчанию переведена на Interactions API, а прежний generateContent API продолжит работать и получать новые модели Gemini, но без эксклюзивных агентных функций.

Что изменилось после бета-версии?

• Управляемые ИИ-агенты (Managed Agents). Один вызов Gemini API создаёт удалённую Linux-песочницу, где агент рассуждает, выполняет код, просматривает веб и управляет файлами. По умолчанию используется агент Antigravity, но можно создать собственного с инструкциями, навыками и источниками данных.
• Фоновое выполнение. Параметр background=True в любом вызове запускает задачу асинхронно (то есть сервер выполняет её в фоне, не заставляя ваш код ждать ответа). Для длинных агентных сценариев это критично.
• Инструменты можно смешивать. В одном запросе теперь совмещаются встроенные инструменты Google (поиск, карты) и пользовательские функции. Результат инструмента может возвращать не только текст, но и изображения.
• Deep Research стал глубже. Появились две версии агента (быстрая и углублённая), совместное планирование, встроенные графики и инфографика, а также мультимодальное (работающее с разными типами данных: текст, картинки, PDF, аудио) обоснование ответов.
• Генерация медиа. Картинки через Nano Banana 2, музыка через Lyria 3, выразительная речь с поддержкой нескольких говорящих.
• Шаги вместо ролей. Новая схема заменяет старую ролевую модель: каждое действие (ввод пользователя, размышление модели, вызов функции, ответ) теперь отдельный типизированный шаг. Миграция упрощена: Google опубликовала руководство, где каждое поле старого формата сопоставлено с новым.
• Экономия и отладка. Тариф Flex снижает стоимость на 50% по сравнению с Priority. Ошибки теперь указывают на конкретное поле. История взаимодействий хранится 55 дней на платном тарифе.

Как попробовать за четыре шага?

1. Получите gemini api key в Google AI Studio (бесплатно, потребуется аккаунт Google).
2. Установите Python SDK или JavaScript SDK через менеджер пакетов вашего проекта.
3. Следуйте документации Interactions API: минимальный вызов занимает несколько строк кода. Для модели передаёте model_id, для агента agent_id, для фоновых задач добавляете background=True.
4. Если переходите с generateContent, откройте руководство по миграции: там каждое поле старого формата сопоставлено с новым.

Для тех, кто работает через сторонние фреймворки: LiteLLM, Eigent и Agno уже поддерживают Interactions API. Это значит, что подключение к Gemini через эти библиотеки не потребует переписывания кода с нуля.

Есть ли аналоги в России?

Прямого аналога Managed Agents, когда один вызов API разворачивает полноценную песочницу с браузером и файловой системой, у российских провайдеров пока нет. Но для базовых задач (генерация текста, работа с промптами, простые цепочки вызовов) YandexGPT и GigaChat остаются рабочими вариантами без проблем с доступом.

Что делать с этим прямо сейчас, по ролям?

Автору на Дзене. Если вы используете нейросети для генерации черновиков или картинок, Interactions API пока избыточен: он заточен под код. Но если вы экспериментируете с ИИ-агентами для автоматизации рутины (сбор информации, подготовка фактуры), попробуйте Deep Research через Google AI Studio: он теперь работает с PDF и аудио.

Разработчику. Параметр background=True решает конкретную боль: длинные агентные цепочки больше не блокируют поток. Если вы работаете через LiteLLM или Agno, интеграция уже готова. Получите gemini api key и протестируйте Managed Agents в песочнице.

Предпринимателю в РФ. Доступ к Gemini API из России остаётся непрямым. Для продакшена, где важна стабильность и легальность, YandexGPT и GigaChat надёжнее. Для R&D и прототипов Interactions API даёт возможности, которых у российских аналогов пока нет.

Частые вопросы

Старый generateContent API перестанет работать?

Нет. Google прямо заявила, что generateContent остаётся полностью поддерживаемым и будет получать новые модели Gemini. Но эксклюзивные возможности для агентов и долгих задач будут появляться только в Interactions API.

Нужно ли переписывать весь код при переходе?

Не обязательно сразу. Google опубликовала руководство по миграции, где каждое поле старого формата сопоставлено с новым. В документации есть переключатель, который показывает примеры кода и в старом, и в новом формате. Переходить можно постепенно.

Можно ли использовать Interactions API из России?

Формально Gemini API требует зарубежного аккаунта Google. Для экспериментов и прототипов это решается, для коммерческих проектов с российскими пользователями стоит учитывать риски и рассмотреть YandexGPT или GigaChat как основной канал, а Gemini как дополнительный.