Vertex AI SDK устарел: дедлайн миграции — 24 июня 2026 г. — что нужно знать routing-командам

21 мая 2026 года Vertex AI исчез из консоли Google Cloud. Если ваша команда пропустила эту новость, вот деталь, которую нельзя игнорировать: генеративные модули Vertex AI SDK запланированы к удалению 24 июня 2026 года — то есть через 28 дней. Любой production-код, который импортирует vertexai.generative_models, vertexai.language_models, vertexai.vision_models, vertexai.tuning или vertexai.caching, перестанет работать в этот день. Ребрендинг в Gemini Enterprise Agent Platform — это изменение UI. Удаление SDK — нет.

Что произошло

В мае 2026 года Google завершила два отдельных, но связанных изменения.

Миграция консоли (21 мая). Vertex AI больше не является продуктом верхнего уровня в консоли Google Cloud. При поиске «Vertex AI» происходит редирект на новый продукт — Gemini Enterprise Agent Platform. Обучение моделей, AutoML, Model Registry и Endpoints теперь являются подфункциями в иерархии с agent-first подходом. API-endpoint остался прежним — aiplatform.googleapis.com, менять URL у существующих HTTP-клиентов не нужно. Однако бренд и навигация в консоли полностью заменены.

Дедлайн по SDK (удаление 24 июня). Следующие модули в google-cloud-aiplatform были объявлены устаревшими 24 июня 2025 года и будут окончательно удалены 24 июня 2026 года:

• vertexai.generative_models
• vertexai.language_models
• vertexai.vision_models
• vertexai.tuning
• vertexai.caching

Замена — Google Gen AI SDK (пакет google-genai). Новый SDK использует унифицированный интерфейс vertexai.Client (или google.genai.Client) и поддерживает оба бэкенда — Gemini API и Vertex AI — через одну библиотеку.

Дополнительно Google опубликовала официальное руководство по миграции с OpenAI SDK на Gen AI SDK — специально для команд, которые сейчас обращаются к Gemini через OpenAI-compatible proxy.

Почему это важно для AI engineering команд

Ребрендинг консоли неудобен, но безвреден. Удаление SDK — breaking change с фиксированной датой в календаре.

Если в вашей кодовой базе есть прямые импорты vertexai.generative_models, с 24 июня они начнут выбрасывать ImportError или AttributeError. Под удар попадают:

• Внутренние обёртки, вызывающие Gemini-модели через старый Vertex AI SDK
• Pipeline-ы дообучения на vertexai.tuning
• Визуальные и мультимодальные pipeline-ы на vertexai.vision_models
• Кэширующие слои на vertexai.caching

Если ваша команда вызывает Gemini через OpenAI-compatible proxy (включая routing gateway, транслирующие /v1/chat/completions в Gemini), это удаление SDK вас не касается — HTTP API-endpoint не изменился. Тем не менее руководство по миграции от Google активно продвигает переход на нативный интерфейс Gen AI SDK, что стоит оценить для рабочих нагрузок, где важны Gemini-специфические возможности (thinking budget, grounding, нативные схемы tool calling).

Если в requirements.txt или pyproject.toml у вас зафиксированы версии SDK, проверьте, по-прежнему ли выбранная версия google-cloud-aiplatform экспортирует устаревшие модули. Фиксация версии сама по себе не защитит вас после 24 июня, если upstream-пакет удалит модуль. Проверьте фактические пути импорта.

Новая Gemini Enterprise Agent Platform также представила два новшества, влияющих на routing и governance:

• MCP Server Registry (General Availability): В Agent Platform появился управляемый реестр MCP-серверов — инструменты к агентам можно подключать без кастомного scaffolding. Актуально для команд, выбирающих между self-hosted диспетчеризацией MCP-инструментов и managed-вариантом от Google.
• Agent Identity: Каждый agent получает криптографический идентификатор для аудируемого журнала действий. Если compliance-процессы вашей компании требуют атрибуции на уровне операций, это теперь нативная функция Google Cloud.

Взгляд router/operator

Ребрендинг Vertex AI создаёт скрытый риск для routing-команд: строки «Vertex AI» разбросаны по коду, runbook-ам и конфигам SDK, хотя сервис теперь официально называется иначе.

Конкретные векторы поломок:

1. Пути импорта в Python-обёртках. from vertexai.generative_models import GenerativeModel — самый распространённый сценарий поломки. Замените на import vertexai; client = vertexai.Client(project=..., location=...) и используйте client.models.generate_content(...) из нового SDK.

2. Версии пакетов в CI/CD. Если ваши Docker-образы или CI-задачи фиксируют google-cloud-aiplatform==1.x, удаление 24 июня затронет пакет на уровне источника. Проверьте, есть ли новая версия google-cloud-aiplatform, уже удалившая эти модули, или мигрируйте на google-genai до дедлайна.

3. Model ID в routing gateway. Идентификаторы Gemini-моделей (например, gemini-3.5-flash-preview-05-20) не изменились — меняется только SDK-обёртка. Если ваш gateway маршрутизирует запросы к Gemini через OpenAI-compatible интерфейс, model ID и endpoint (https://generativelanguage.googleapis.com/v1beta/openai/) остаются стабильными.

4. Метки в мониторинге и телеметрии. Дашборды, теги аллокации затрат и фильтры логов, классифицирующие трафик как «Vertex AI», возможно, нужно обновить на «Gemini Enterprise Agent Platform» или имя базового сервиса, чтобы они соответствовали биллинговым и IAM-поверхностям Google.

Матрица решений по миграции:

Рекомендации для пользователей TheRouter

Если вы маршрутизируете запросы к Gemini через TheRouter с помощью OpenAI-compatible интерфейса, удаление SDK 24 июня не влияет на ваш gateway routing path. HTTP API-endpoint Gemini не изменился.

На что обратить внимание:

• Проаудируйте внутренний Python-код, использующий старый vertexai.generative_models SDK для обёртки вызовов Gemini. Даже если production routing path построен на gateway, тестовые окружения, eval-скрипты и пайплайны дообучения могут всё ещё использовать старый SDK.

• Сверьте model ID для Gemini с release notes Agent Platform. После исчезновения консоли Vertex AI основным источником каталога моделей теперь является документация Gemini Enterprise Agent Platform. Названия моделей, ранее фигурировавшие в Vertex AI Model Garden, могут иметь обновлённый раздел документации.

• Изучите руководство по миграции на Gen AI SDK, если разрабатываете новые интеграции. Унифицированный клиент (vertexai.Client) открывает доступ к Gemini-специфическим возможностям — управление thinking budget, нативный grounding, tool calling, — которые OpenAI-compatible proxy не транслирует. Для нагрузок, где эти возможности принципиальны, стоит рассмотреть гибридный подход: gateway берёт на себя multi-provider routing и fallback, нативный SDK — Gemini-специфические функции.

• Проверьте биллинговые метки. Если вы отслеживаете стоимость Gemini отдельно от других provider-ов в вашем биллинге, убедитесь, что после миграции консоли Google Cloud по-прежнему использует те же имена сервисов и SKU. Ребрендинги продуктов иногда меняют метки SKU.