gemini-agents-api-google-skills

1. 基本信息

项目	内容
名称	gemini-agents-api-google-skills
作者/维护者	Google（google/skills 官方仓库）
来源链接	https://github.com/google/skills/tree/main/skills/cloud/gemini-agents-api
许可证	Apache-2.0（数据来自 GitHub API）
GitHub Stars	19,136（数据来自 GitHub API；为 google/skills 整个合集仓库的星数，不代表本技能自身热度）
Forks	1,543（数据来自 GitHub API，同为合集仓库整体数字）
最新版本	未发布正式版本号（仓库未使用 Git tag/Release，滚动更新，技能子目录最近一次提交 2026-07-13）
安装方式	`npx skills add google/skills`，安装时从清单中勾选本技能

2. 功能介绍与亮点

Gemini Agents API 教会 agent 用 REST 请求程序化管理 Gemini Enterprise Agent Platform 上的托管 Agent 资源（Managed Agents API，即该平台的控制平面）。核心能力包括：

Agent 资源全生命周期：创建（异步长时操作 LRO）、查询状态、获取详情、列出、更新、删除自定义 Agent 资源，每个请求都给出完整的 endpoint、方法与 JSON payload 示例。
环境挂载：创建 Agent 时可从 Cloud Storage 或平台自带的 Skill Registry 服务，把文件、目录或技能直接挂载进 Agent 沙箱容器的工作目录。
MCP Server 接入：支持在 Agent 定义中配置第三方 MCP 服务器（含鉴权 Header），平台负责安全路由工具调用请求。
沙箱化执行：每个 Agent 运行在隔离的 Linux 沙箱中，可推理、写代码、读写文件、联网搜索——由 Google 的 Antigravity harness 驱动。

主要亮点：Google 官方出品、Apache-2.0 完全开源；配套功能已在 Google Cloud 官方文档站独立成文（非仅本仓库自述），且 Google 官方博客多次撰文介绍该 API 的能力扩展（后台任务、远程 MCP、免费额度项目可用），说明这是一项持续迭代的正式产品能力而非实验性文档。

3. 适用场景

固定分类：DevOps 与基础设施。

适用于需要以代码方式批量管理 Agent 资源的开发者与平台团队，尤其是：

需要为多个客户/项目批量创建预配置 Agent（如统一挂载企业内部技能库）的平台运营团队；
希望把 Agent 的创建、更新、下线纳入 CI/CD 或基础设施即代码流程，而非在控制台手工操作的团队；
需要让某个 Agent 动态接入自建或第三方 MCP 服务器、实现工具能力扩展的开发者。

4. 跨 Agent 兼容性

Claude Code：原生支持——纯 REST API 参考文档，curl 与工具调用默认可用，无需额外配置。
Codex CLI：需适配——技能核心机制是运行时对 aiplatform.googleapis.com 发起公网 curl 请求，而 Codex CLI 默认沙箱（workspace-write 模式）关闭出站网络访问，需用户显式开启网络权限才能完整工作。
OpenClaw：需适配——同理，OpenClaw 默认沙箱同样默认禁用出站网络访问，需显式开启后才能调用该 REST API。
Hermes Agent：未验证——未查到该平台对 Agent Skills 格式或该 API 的公开兼容性说明。

5. 推荐理由

这份技能把管理 Agent 资源这件事从“翻官方 REST 文档现拼 JSON payload”变成了可直接复用的操作手册：认证方式、每个操作的 endpoint、请求体结构、异步操作轮询方式一次性写全，还额外覆盖了挂载 Skill Registry 资源、接入第三方 MCP 服务器这类进阶用法。对正在批量运维多个 Agent 实例、或需要把 Agent 配置纳入自动化流程的团队来说，能省下反复查阅多篇官方文档、手工拼接请求的时间；执行前的 LRO 轮询说明也降低了“以为创建失败其实还在异步进行中”这类误判。

6. 评分

维度	分数	说明
受欢迎程度	7	Google 为该平台的官方所有者，属第一方出品；技能自身仅 5 次提交（2026-06~07），未查到独立第三方讨论，但对应功能有多篇 Google 官方博客持续跟踪介绍
可用性	8	步骤清晰（认证→请求→轮询），文档含完整请求/响应示例；对应的 Managed Agents API 已独立成文进官方文档站，且已开放给免费额度项目使用，无强制付费门槛；需自行配置 GCP 项目与 ADC 认证
安全性	9	Google 官方出品、Apache-2.0 完全开源可审计；技能本身不索取也不存储任何凭据，复用用户已有的 gcloud ADC 认证；未发现可疑指令或与任务无关的夹带内容

安全检查清单：

检查项	结果
① Shell 命令与权限范围	仅涉及 `gcloud auth print-access-token` 取令牌与标准 `curl` 请求，权限范围限定在用户自己 GCP 项目下的 Agent 资源
② 运行时联网外发	仅与 Google 官方 API 端点（`aiplatform.googleapis.com`）通信，无第三方外发
③ API Key/凭据	复用用户本机已有的 `gcloud` ADC 认证会话，技能本身不索取、不存储任何凭据
④ 可疑指令	未发现 prompt injection 或与任务无关的夹带指令
⑤ 作者/组织信誉	Google 官方仓库，信誉可查证
⑥ License	Apache-2.0，明确
⑦ 最近维护	仓库整体持续活跃（最近推送 2026-09-01），技能子目录最近一次内容更新 2026-07-13

综合评分：8.0（(7+8+9)/3）

7. 跟同类 Skills 相比的优势

技能	定位	与本技能的差异
Agent Platform Deploy	把已开发好的 Agent 部署到 Agent Runtime/Cloud Run/GKE 等目标环境	关注部署目标环境的选型与流程，不涉及创建/更新 Agent 资源本身的 API 细节
Agent Platform Model Registry	管理底层模型（Model）资源的注册与版本	管理对象是模型而非 Agent 实例，二者是平台上不同层级的资源
Google Agents CLI Onboarding	引导安装 `agents-cli` 命令行工具及其配套的 7 个开发阶段技能	走的是本地 CLI 全生命周期工作流（脚手架/构建/评测/部署），而非直接对 Agent 资源发起 REST 调用；两者可搭配使用但操作层不同

本技能的差异化在于：直接面向 Managed Agents API 这个控制平面本身，覆盖创建、查询、更新、删除 Agent 资源的完整 CRUD，并额外讲清 Skill Registry 挂载与 MCP Server 接入这两类进阶配置，而不是聚焦部署目标选型或本地 CLI 工作流。

8. 用户评价

该技能目前在第三方平台（GitHub Issues/PR、Reddit、Hacker News）尚无具名用户评价；其对应的 Managed Agents API 功能本身有多篇 Google 官方博客介绍，但均为官方渠道而非独立第三方评价。

9. 其他补充

Google 已在 Google Cloud Next 2026 官方宣布 google/skills 仓库，作为面向 Antigravity、Gemini CLI 及第三方 agent 的官方技能库；本技能对应的 Managed Agents API 已独立收录进 Google Cloud 官方文档站（docs.cloud.google.com/gemini-enterprise-agent-platform），并持续通过官方博客发布能力更新（后台任务执行、远程 MCP 接入等）。

10. 安装使用方式

安装：npx skills add google/skills，在交互式清单中勾选 gemini-agents-api；也可手动下载 SKILL.md 放入对应 agent 的技能目录。
使用前确保本机已安装并登录 gcloud（gcloud auth login），并已在目标 GCP 项目中启用 Gemini Enterprise Agent Platform 相关 API。
触发：向 agent 描述“创建一个 Agent 资源”“列出我的 Agent”“给这个 Agent 挂一个 MCP 服务器”等意图即可自动加载本技能；创建类操作为异步长时操作，需按说明轮询确认完成。

11. 注意事项

API 版本号为 v1beta1，仍处 Beta 阶段，接口字段可能随平台迭代调整。
Codex CLI 与 OpenClaw 默认沙箱均关闭出站网络访问，首次使用需手动开启网络权限，否则请求会直接失败而非得到有意义的错误提示。
技能子目录自身提交记录集中在 2026 年 6-7 月，建议结合官方文档站核对字段是否有平台侧变更。