agent-platform-migrate-from-ai-studio

Скилл agent-platform-migrate-from-ai-studio сопровождает перенос приложения с developer-centric Gemini API в Google AI Studio на enterprise Gemini API в Google Cloud Agent Platform, который ранее назывался Vertex AI. Он подходит, когда нужно направить инференс в Google Cloud, использовать доступные Cloud credits, объединить IAM, billing и telemetry с Compute Engine, Cloud SQL или BigQuery, а также запускать ADK или другой orchestration engine в едином облачном контуре. Главный переход — от endpoint generativelanguage.googleapis.com к aiplatform.googleapis.com. В описании скилла также сопоставлены модели авторизации, аудитория и эксплуатационная модель: AI Studio использует API key или OAuth и рассчитан на developer/startup-сценарии, Agent Platform — на enterprise production и MLOps с Google Cloud IAM, service accounts, OAuth 2.0 и VPC Service Controls. Для миграции сначала создаётся или выбирается billing account и проверяется Welcome credit, затем в проекте явно включается Agent Platform API командой gcloud services enable aiplatform.googleapis.com. Для локальных запусков описан Application Default Credentials; для облачной VM — attached service account с ролью roles/aiplatform.user. Одних IAM bindings может быть недостаточно: для Compute Engine нужно проверить access scope, потому что старые scopes могут ограничить доступ даже при правильной роли. В качестве операционной защиты предлагается создать budget alert, чтобы после исчерпания кредитов не получить неожиданный расход со стандартного способа оплаты. Эти действия относятся к настройке проекта и биллинга, поэтому конкретный project_id, identity и location должны быть подставлены владельцем среды, а не угадываться из карточки. Для кода не требуется переписывать основную инициализацию, если используется единый Google GenAI SDK: в источнике показано, что он работает с обоими backend, а переключение выполняется переменными GOOGLE_CLOUD_PROJECT, GOOGLE_CLOUD_LOCATION и GOOGLE_GENAI_USE_ENTERPRISE=TRUE. Для Agent Platform можно выбрать global или строгий regional endpoint; для примера с Gemini 3 Flash Preview источник отдельно указывает location global. ADK-агент использует тот же model string и получает доступ через Google Cloud credentials, поэтому скилл полезен и для обычного приложения, и для agent runtime. Наряду с этим перечислены MLOps-возможности Agent Platform — Model Registry, Model Monitoring и Pipeline Evaluation — и варианты throughput: pay-as-you-go либо Provisioned Throughput. Ограничения и проверки перед запуском обязательны. В карточке прямо разделены поддержка кредитами, политика использования prompt/response, SLA и compliance; эти свойства нужно сверять с актуальными условиями конкретного проекта и продукта, а не переносить на любой Gemini endpoint. Для OpenClaw описаны отдельные требования: service account с aiplatform.user, префикс google-vertex/ в конфигурации, проверка статуса моделей и тестовый запрос после настройки. Источник предупреждает о несовместимости определённых новых моделей с google-vertex provider и о необходимости использовать поддерживаемую версию OpenClaw. Поэтому skill даёт воспроизводимый маршрут миграции — endpoint, API, IAM, credentials, env flags, SDK/ADK и smoke-проверку — но не обещает автоматический перенос секретов, billing account или production deployment.