Новость · TNWS AI

Что нового в Gemini API: почему Interactions API стал основным в 2026 году

WebGemini#Gemini API #Interactions API #новости AI

11 сентября 2026 2 мин—

Изменения Gemini API на 11 сентября 2026 года: GA Interactions API, состояние диалога, background, steps и статус generateContent.

Главное изменение для разработчика: с июня 2026 года Interactions API имеет статус GA и рекомендован Google для новых проектов. generateContent не выключен — он остаётся полностью поддерживаемым legacy API. Новая архитектура объединяет обычные модели, специализированных агентов, инструменты, мультимодальность и длительные задачи в ресурсе Interaction.

Рабочий пример

const job = await ai.interactions.create({
  model: "gemini-3.8-flash",
  input: "Проанализируй приложенный набор документов",
  background: true
});

console.log(job.id);
// Затем получить состояние через interactions.get(job.id)
// и обрабатывать только документированные финальные статусы.

Что означает каждая важная часть

previous_interaction_id позволяет продолжить серверное состояние без ручной пересылки всей беседы.
steps показывают последовательность model output, вызовов инструментов и их результатов — это полезно для отладки и интерфейса агента.
background:true предназначен для долгих операций, которые не нужно держать в одном HTTP-соединении.
store:false оставляет stateless-вариант для приложений, которые управляют историей самостоятельно.
Google указывает Interactions API как место появления новых возможностей; это аргумент для новых проектов, но не приказ немедленно мигрировать стабильные системы.

Порядок внедрения

Для нового сервиса начните с Interactions API и зафиксируйте версию SDK.
Для существующего составьте таблицу используемых функций generateContent и их аналогов.
Отдельно решите, допустимо ли серверное хранение состояния; при необходимости включите store:false.
Для background-задач храните ID, статус, время создания и дедлайн; опрос выполняйте с паузой.
Перед production проверьте release notes и страницу Models на дату релиза.

Как проверить результат

Пилот должен включать простой текст, продолжение диалога, вызов инструмента и фоновую операцию. Для каждого сценария сохраните ожидаемые статусы и обязательные поля. Успешный HTTP-ответ при создании background-задачи ещё не означает успешный финальный результат — дождитесь терминального статуса.

Ограничения

Статья фиксирует состояние официальной документации на 11 сентября 2026 года. Preview-модели и отдельные инструменты могут иметь собственные условия. generateContent поддерживается, поэтому выгоду миграции оценивайте по нужным возможностям и стоимости изменений.

Чего не делать

Не называйте generateContent закрытым или удалённым.
Не выдавайте создание background-job за завершение анализа.
Не переносите production без теста хранения, ошибок и tool steps.

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

Можно ли использовать пример в production?

Как основу — да, но добавьте авторизацию, таймауты, обработку ошибок, лимиты и тесты из статьи.

Где проверять актуальное имя модели?

В официальном каталоге Gemini API и Google AI Studio непосредственно перед развёртыванием.

Нужно ли доверять ответу без проверки?

Нет. Формат проверяется кодом, а важные факты — источником или вашей базой данных.

Что делать при изменении API?

Зафиксировать версию SDK, прочитать release notes и прогнать сохранённый набор интеграционных тестов.

Официальный источник

Документация Google, проверена 11 сентября 2026 года: https://ai.google.dev/gemini-api/docs/interactions-overview