1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | agent-platform-inference-google-skills（SKILL.md 自述名称：“Agent Platform GenAI Inference Skill”） | GitHub 仓库 + SKILL.md |
| 作者/维护者 | Google（官方 google/skills 仓库） |
GitHub API |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/agent-platform-inference | — |
| 许可证 | Apache License 2.0 | GitHub API 实测 |
| GitHub Stars / Forks | 所属仓库 15,243 / 1,192（整仓库口径——google/skills 是 Google 官方发布的多技能合集，星数不代表单个技能自身热度） |
GitHub API 实测（2026-07-26） |
| 最新版本 | 无独立版本号，子目录最近一次提交 2026-06-24 | GitHub commits API 实测 |
| 安装方式 | npx skills add google/skills --skill agent-platform-inference，或手动复制子目录到对应 agent 的 skills 目录 |
官方 README 实测 |
2. 功能介绍与亮点
该技能教 Agent 如何在 Google Cloud Agent Platform（原 Vertex AI，现称 Gemini Enterprise Agent Platform）上，用正确的 SDK、认证方式与终端点调用生成式 AI 模型完成推理：
- 双模型族、三条 SDK 路径全覆盖：First-Party 的 Gemini 系列与 Third-Party 的 OpenMaaS 系列（Llama、DeepSeek、Qwen、Kimi、MiniMax、GLM 等）均可调用，每个族群都提供 GenAI SDK（推荐）、OpenAI 兼容 SDK、Legacy Agent Platform SDK 三条路径的完整可运行示例代码，共 6 个脚本
- 认证与终端点配置讲透：区分 Global/Regional 终端点适用场景（Preview 模型通常仅在 Global 可用）、OpenAI SDK 下用 GCP OAuth Token 冒充 API Key 的认证写法、以及长时运行服务的 Token 刷新机制，这些是初次接入该平台最容易踩坑的环节
- 常见报错的排查手册：针对 429（Dynamic Shared Quota 耗尽，区别于常规配额问题）、400（请求格式或 Model ID 错误）、404（模型未在该区域启用，需在 Model Garden 手动 Enable）三类高频报错给出成因判断与处理步骤，而非只贴文档链接
- 模型可用性一览表：列出 Llama 4/3.3、DeepSeek、Qwen 3、Kimi、MiniMax、GLM 等主流开源模型的 Model ID 与可用区域，并提醒该列表非最终权威、需以官方 Model Garden 页面为准
- 成本安全阀：把模型推理这类会产生真实计费的操作单独划为需二次确认的层级，要求确认提示中明确列出模型 ID、SDK、输入内容等具体参数，禁止用模糊的自然语言代替确认
- 一键环境自检：
scripts/verify_all.sh会新建临时虚拟环境、安装依赖、依次跑通全部 6 个示例脚本并给出通过/失败清单，出错时自动打印完整报错，用完自动清理环境
3. 适用场景
所属分类：元技能与 Agent 增强
适合已经或计划在 Google Cloud Agent Platform 上接入 Gemini 或第三方开源模型（Llama、DeepSeek、Qwen 等）做推理调用的开发者：不确定该用哪条 SDK、终端点该配置成 Global 还是 Regional、或是被 429/400/404 报错卡住的用户，都可以让 Agent 直接读这份技能生成可运行的调用代码并按步骤排障，不必逐页翻官方文档。
4. 跨 Agent 兼容性
google/skills 仓库通过 npx skills 通用安装器（vercel-labs/skills）分发，该安装器 README 的 Supported Agents 表格逐一列出各 agent 的安装路径：
| Agent | 项目路径 | 全局路径 |
|---|---|---|
| Claude Code | .claude/skills/ |
~/.claude/skills/ |
| Codex | .agents/skills/ |
~/.codex/skills/ |
| OpenClaw | skills/ |
~/.openclaw/skills/ |
| Hermes Agent | .hermes/skills/ |
~/.hermes/skills/ |
四个生态均为原生支持——技能本身是标准 SKILL.md + Python 示例脚本，不依赖 Claude Code 专属机制，配合上表安装路径即可在任一生态中使用。另据 Agent Skills 规范官网（agentskills.io）的客户端列表，Claude Code 与 OpenAI Codex 均被明确列为该规范的官方支持客户端。
5. 推荐理由
把“在 Google Cloud Agent Platform 上正确调用 Gemini 或某个开源模型”这件横跨认证、SDK 选型、终端点配置、报错排查的琐碎工作，浓缩成一份可直接复制运行的对话式指南，尤其是把 429/400/404 三类高频报错的真实成因（而非泛泛的文档链接）讲清楚，能省下开发者试错踩坑的时间。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方 Google 出品，隶属仓库整体 15,243 stars 的官方技能合集；该数字属整个合集，不代表本技能自身热度——本子目录目前仅有官方内部提交记录，尚无外部社区 issue 或 PR 参与 |
| 可用性 | 8 | 6 个可运行示例脚本 + 环境自检脚本 + 详细报错排查手册，文档与示例完整；但需要用户自备 Google Cloud 项目、完成 gcloud 认证并安装多个 SDK 依赖，且模型推理会产生真实计费，属于“步骤清晰但需一定配置”档 |
| 安全性 | 9 | 见下方检查清单 |
| 综合 | 8.0 | 三项均值 |
安全检查清单：
① Shell 命令及权限范围：仅涉及本地虚拟环境创建、pip install 依赖安装、gcloud auth 标准认证流程，操作范围限定且有说明，无越权动作。
② 联网外发：仅与用户自己 Google Cloud 项目下的 Agent Platform / Vertex AI 推理终端点通信，目标单一透明，无隐蔽外发。
③ 凭据处理：使用标准 gcloud Application Default Credentials 及 OAuth Token，SKILL.md 明确给出 Token 获取与刷新代码，脚本本身不额外存储或外传密钥。
④ 可疑指令：通读 SKILL.md 全文与全部示例脚本，未发现隐藏指令、混淆代码或异常外发；对推理调用（会产生计费）设置强制二次确认，是主动的风险控制设计。
⑤ 作者信誉：Google 官方仓库出品，无造假迹象。
⑥ License：Apache License 2.0，明确清晰。
⑦ 最近维护：子目录最近一次代码提交 2026-06-24，仓库整体持续保持推送更新（2026-07-24 仍有提交）。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| LiteLLM | 开源 Python 库，用统一的 OpenAI 格式调用 100+ 家 LLM 供应商的 API，是模型供应商抽象层里应用最广的开源方案之一 | 是一个需要引入到代码里的通用抽象库，覆盖全行业供应商但对 Agent Platform 平台特有的终端点、配额（DSQ）、Model Garden 启用流程等细节不做专门讲解；本技能只聚焦 Agent Platform 一个平台，但把该平台的报错与配置陷阱讲得更细 |
| OpenRouter | 托管型统一 API 网关，一个 Endpoint 即可访问数百个模型，按量计费且自带排队与限流保护 | 是独立于云厂商的第三方托管服务，需另开账号并把流量转发到其平台；本技能直接在用户已有的 Google Cloud 项目内完成调用，不引入额外的第三方中间层 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价，GitHub 仓库层面该子目录也暂无外部开发者提交的 issue 或 PR 讨论。
9. 其他补充
该技能是 google/skills 仓库“Agent Platform”系列的一员，同系列还包含模型部署、模型调优、RAG 引擎管理、技能注册表管理等技能，均围绕 Google Cloud 上的 Agent 全生命周期管理展开，可按需组合安装。
10. 安装使用方式
- 通过安装器：
npx skills add google/skills --skill agent-platform-inference，安装器会将技能放入当前 Agent 对应的 skills 目录（见第 4 章路径表） - 手动安装：克隆或下载
google/skills仓库后，将skills/cloud/agent-platform-inference/整个目录复制到目标 agent 的 skills 目录下 - 安装后：需先执行
gcloud auth login与gcloud auth application-default login完成认证，并pip install -r scripts/requirements.txt装好依赖；可选执行./scripts/verify_all.sh验证环境是否打通；之后无需重启 Agent，即可在对话中触发本技能（如“帮我写一段调用 DeepSeek 的代码”）
11. 注意事项
- 仅适用于 Google Cloud Agent Platform 上的模型推理调用，不涉及模型部署到终端点或模型评估（仓库内另有专门技能覆盖这两块）
- 模型推理会产生真实的 Google Cloud 计费，技能会在执行前提示但具体费用取决于模型选择与调用量，需用户自行评估
- 文中列出的 Model ID 与可用区域仅为示例且可能过期，技能本身也提醒需以 Model Garden 官方页面为准
- 技能强绑定 Google Agent Platform 的认证体系与终端点格式，若团队使用其他云厂商的模型推理服务，需要额外适配后才能复用