1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | Agent Platform Migrate From Ai Studio Google Skills | — |
| 项目自述名称 | Migrating from Gemini API in AI Studio to Agent Platform | 仓库 README |
| 作者/维护者 | Google(google/skills 仓库) |
GitHub API |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/agent-platform-migrate-from-ai-studio | — |
| 许可证 | Apache-2.0 | GitHub API |
| GitHub Stars | 19,788(合集仓库整体,不代表本技能自身热度) | GitHub API |
| Forks | 1,593(合集仓库整体) | GitHub API |
| 最新版本 | 无独立版本号,随仓库滚动更新;本技能目录最近一次提交 2026-06-24,仓库整体最近推送 2026-09-11 | GitHub API |
| 安装方式 | npx skills add google/skills 交互选择本技能,或手动复制该目录到自己的 skills 目录 |
仓库 README |
2. 功能介绍与亮点
本技能指导把已经用 Google AI Studio(generativelanguage.googleapis.com,开发者个人 API Key 模式)搭建的 Gemini 应用,迁移到企业级 Gemini Enterprise Agent Platform(原 Vertex AI,aiplatform.googleapis.com)。覆盖四个环节:
- 计费与信用额度:说明 AI Studio 不能使用 Google Cloud 免费试用信用额度,必须切到 Agent Platform 才能用;并提示设置预算告警防止超额自动扣费。
- 身份与权限:分别给出用户身份(Application Default Credentials)与服务账号(Compute Engine 默认服务账号)两种鉴权路径的具体
gcloud命令。 - 客户端迁移:Google GenAI 统一 SDK 只需切换环境变量即可从 AI Studio 切到 Agent Platform;另给出 Agent Development Kit(ADK)、Antigravity CLI、OpenClaw 三种客户端各自的完整配置步骤。
- 已知问题提示:明确指出 OpenClaw 2026.5.28 版本的
google-vertex提供方有 bug,建议锁定 2026.5.20;并提示新建组织默认会用组织策略禁止创建服务账号密钥,需要管理员先临时放开。
亮点:官方 Google 出品;同时覆盖 SDK / ADK / Antigravity CLI / OpenClaw 四种客户端而非只讲 API 本身;对涉及安全策略变更的步骤(禁用组织策略)会先要求暂停并征得用户确认,而不是直接执行。
3. 适用场景
所属分类:DevOps 与基础设施。
适用于已经用 AI Studio 免费或个人 API Key 搭建过 Gemini 原型、现在需要切换到公司 GCP 账号统一管理计费、IAM 权限与合规审计的开发者;也适用于企业团队把散落在各开发者个人账号下的 AI 应用收归到统一云基础设施管理体系的场景。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md 格式,可直接放入 .claude/skills/ 使用;正文步骤为通用 gcloud/Python SDK 操作,无 Claude Code 专有依赖 |
| Codex | 需适配 | Codex 默认沙箱无出站网络,而本技能核心步骤(gcloud 认证、API 调用、密钥文件生成)需要联网与写入本地凭据文件,需先放开网络权限 |
| OpenClaw | 原生支持 | 正文专设 OpenClaw 配置章节,给出 openclaw.json 示例与模型前缀写法,并标注已知版本兼容性问题(2026.5.28 需回退到 2026.5.20) |
| Hermes Agent | 未验证 | 正文未提及 Hermes Agent,也未找到该技能在 Hermes Agent 环境下的验证记录 |
5. 推荐理由
Google 官方出品,内容权威;专门解决“如何把 AI Studio 原型迁移到企业级 Agent Platform”这一具体场景,与常见的 agent-platform-* 系列技能(管理部署、推理、调优、Prompt 等,均假设你已经身处 Agent Platform)互补,补的是“从哪里进来”这一入口环节。四种客户端(SDK/ADK/Antigravity CLI/OpenClaw)配置步骤齐全,且带有真实踩坑经验(具体版本号的已知 bug 提示),比单纯转述官方文档更有落地价值。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 Google 是该产品(Google Cloud / Gemini)的第一方所有者;仓库整体 19,788 star 属合集共享,不代表本技能自身热度,也未检索到该子技能自身的独立第三方评价或报道 |
| 可用性 | 9 | 步骤具体到可直接复制的命令,四种客户端配置均给出完整示例并附官方文档链接;仓库整体最近一次推送为近日,维护活跃;无需额外付费依赖(使用者本就需要 GCP 账号) |
| 安全性 | 8 | 涉及真实命令执行(IAM 授权绑定、服务账号密钥创建),但每步权限用途均有说明、可审计;对触及组织安全策略的步骤要求先暂停并征得用户/管理员确认,而非静默执行;License 明确、无外联到未知第三方 |
安全检查清单:
① Shell/gcloud 命令权限范围明确(IAM 绑定、API 启用、密钥创建),均在文中逐条说明用途 → 通过
② 运行时联网对象为 Google Cloud 官方 API,无第三方外联 → 通过
③ 涉及服务账号密钥等凭据,存储路径(~/.config/gcloud/)与用途均写明 → 通过
④ 未发现可疑指令或隐蔽外发;涉及禁用组织安全策略处会显式要求暂停确认,属正向安全设计 → 通过
⑤ 作者为 Google 官方账号,信誉无疑 → 通过
⑥ License(Apache-2.0)明确 → 通过
⑦ 仓库整体近日仍在推送,维护活跃 → 通过
综合评分 = (7+9+8)/3 = 8.0
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| Agent Platform Deploy / Inference / Tuning 等(google/skills 同仓库) | 管理已经在 Agent Platform 上运行的模型部署、推理、调优 | 假设你已经身处 Agent Platform,不覆盖“如何从 AI Studio 切过来”这一前置迁移步骤 |
Firebase Basics(firebase/agent-skills) |
面向 Firebase Studio 与 Firebase 后端服务的入门配置 | 服务对象是 Firebase 生态,不涉及 AI Studio → Agent Platform 的 API 迁移路径 |
| Google Cloud 官方迁移文档(网页) | 纯文档说明迁移差异 | 不是可安装的 agent skill,也不含 ADK/Antigravity CLI/OpenClaw 等客户端的具体配置代码 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
正文为英文撰写;仓库其余技能同样使用英文文档,暂无多语言版本。
10. 安装使用方式
- 运行
npx skills add google/skills,在交互列表中选择 “Migrating from Gemini API in AI Studio to Agent Platform”;或手动将skills/cloud/agent-platform-migrate-from-ai-studio/目录复制进自己 agent 的 skills 目录。 - 确保已有 Google Cloud 项目与有效计费账号,执行
gcloud services enable aiplatform.googleapis.com --project=<project_id>开通 Agent Platform API。 - 按本机使用身份配置鉴权:本地调试用
gcloud auth application-default login,云端服务用对应服务账号并授予roles/aiplatform.user。 - 根据实际使用的客户端(Google GenAI SDK / ADK / Antigravity CLI / OpenClaw)分别设置对应的环境变量或配置文件。
11. 注意事项
- 需要真实 Google Cloud 账号与有效计费方式;AI Studio 的免费额度不能直接转移,只能通过 Agent Platform 使用云端信用额度。
- 创建服务账号密钥这一步,在 2024-05-04 之后新建的组织下默认被组织策略禁止,需要组织策略管理员临时放开。
- 使用 OpenClaw 时需注意已知的版本兼容性问题(2026.5.28 版本的
google-vertex提供方有 bug,建议使用 2026.5.20)。 - 仅给出 Google GenAI SDK、ADK、Antigravity CLI、OpenClaw 四种客户端的具体配置步骤,其他 agent 框架的接入方式需自行参照官方 API 文档。