Gemini AI Studio 迁移至 Agent Platform
帮助应用从 Gemini API 的 AI Studio 环境迁移到 Google Cloud Agent Platform。
文档说明了IAM、预算告警和部分认证流程,也要求用户在启用服务和授权前操作;但建议使用默认服务账号、允许全量Cloud API访问、创建并复制长期服务账号密钥,并提示临时停用组织策略,最小权限、敏感凭据处理、数据流披露和回滚方案明显不足,因此大幅扣分。
主路径包含gcloud、环境变量、SDK、ADK和OpenClaw配置示例,且列出一个OpenClaw版本问题;但存在重复编号、项目号获取命令与变量语义不一致、版本和模型可用性依赖外部状态,异常输入和失败反馈覆盖有限。静态审查不能超过10分,故评为中低分。
触发场景、目标用户和迁移方向较明确,覆盖本地、GCE、ADK及OpenClaw;但未充分说明不适用边界、地区可用性、中文支持或中国大陆网络可达性,且依赖Google Cloud、OAuth和多个海外服务。
文档按触发条件、比较、迁移步骤和附加资源组织,仓库README提供Apache-2.0许可、安装方式、支持渠道和持续开发说明;但技能自身没有版本、变更记录、维护责任人、参数契约或系统化故障排查,且部分外部工具说明可能过时。
对于已具备Google Cloud权限并明确要迁移的用户,步骤和配置片段可能完成核心迁移;但支付、IAM、凭据、第三方CLI和OpenClaw版本等前置条件较重,若不适配环境仍需大量人工核验,且静态文件没有可验证的代表性结果,因此不超过7分。
包含若干官方文档链接和可审计命令,但关键产品、隐私、额度、模型和版本断言主要依赖链接内容,技能内没有测试套件、CI证据、固定依赖或独立复现记录;静态审查上限为5分,证据覆盖仍然薄弱。
- 不要按文档默认创建或复制长期服务账号密钥;优先使用短期凭据、工作负载身份或最小权限专用服务账号。
- 不要为排障直接停用组织策略或授予cloud-platform全量访问;应先由安全管理员评估并记录审批、范围和恢复步骤。
- 运行curl远程脚本、安装Antigravity/OpenClaw或执行重启命令前,应审查来源、版本、权限和变更影响。
- 计费、模型名称、隐私承诺、区域端点和OpenClaw兼容性需在实际部署前重新核验;大陆网络可达性未被该技能证明。
这个 Skill 能做什么,适合哪些场景?
此技能指导用户将使用 Gemini API 的应用从 Google AI Studio 迁移到 Gemini Enterprise Agent Platform(原 Vertex AI)。内容涵盖计费账户、云积分、API 启用、身份验证和 IAM 配置。它还提供 Google GenAI SDK、ADK、Antigravity CLI 和 OpenClaw 的接入示例。适合需要将推理与 Google Cloud 的权限、计费和基础设施统一管理的团队。
它比较 AI Studio 与 Agent Platform 的端点、计费、隐私、安全、吞吐量和 MLOps 特性;提供使用 gcloud 启用 API、配置预算提醒、设置 ADC 和 aiplatform.user IAM 角色的命令;给出环境变量、Python 初始化代码以及 ADK、Antigravity CLI 和 OpenClaw 配置示例;还说明如何重启并验证 OpenClaw 连接。
- 正在将 Gemini API 应用从 Google AI Studio 迁移到 Google Cloud 的开发者。
- 希望使用 Google Cloud Welcome Trial 或其他云积分支付 Gemini 推理费用的用户。
- 需要把 Gemini 推理与现有 IAM、计费、遥测和 Cloud SQL、BigQuery 等基础设施统一的团队。
- 在 Compute Engine 虚拟机上运行 ADK 或 OpenClaw,并希望使用服务账号访问 Agent Platform 的用户。
这个 Skill 有哪些优点和局限?
- 覆盖从计费和云积分到认证、IAM、SDK 和运行时验证的完整迁移路径。
- 提供可复制的 gcloud、环境变量、Python 和 OpenClaw 配置示例。
- 同时说明 Google GenAI SDK、ADK、Antigravity CLI 和 OpenClaw 的使用方式。
- 内容依赖 Google Cloud 项目、计费账户和命令行环境,不能替代具体项目的权限排查。
- OpenClaw 部分包含特定版本和模型限制,适用范围较窄。
- 源材料未提供测试套件、自动化迁移脚本或迁移结果验证矩阵。
如何安装这个 Skill?
运行 npx skills add google/skills,并在安装交互过程中选择 skills/cloud/agent-platform-migrate-from-ai-studio。源材料没有说明将该文件夹手动复制到其他客户端的步骤。
如何使用这个 Skill?
在已加载该技能的 Agent Skills 客户端中提出类似“帮助我把使用 Gemini API 的应用从 AI Studio 迁移到 Agent Platform,并配置 IAM 和计费”的请求。按指南创建 Google Cloud 计费账户和项目、启用 aiplatform.googleapis.com、配置 ADC 或服务账号及 roles/aiplatform.user,然后设置 GOOGLE_CLOUD_PROJECT、GOOGLE_CLOUD_LOCATION 和 GOOGLE_GENAI_USE_ENTERPRISE=TRUE。若使用 OpenClaw,还需配置 google-vertex/ 模型前缀并重启网关。
这个 Skill 与同类方案有什么区别?
该技能明确比较 Google AI Studio 的 Gemini Developer API 与 Agent Platform 的 Enterprise Gemini API,涉及 API 端点、云积分、数据隐私、IAM、安全、SLA、吞吐量、MLOps 和区域端点。它的核心建议是:需要企业级 Google Cloud 计费、权限和基础设施整合时,迁移到 Agent Platform;仅需开发者型 Gemini API 使用方式时,AI Studio 仍是对照选项。