Gemini 企业托管 Agent 管理
通过 API 创建和管理有状态的 Gemini 企业 Agent。
文档说明使用 ADC Bearer token，并提示 update_mask 和 MCP 头部发送范围；但示例允许任意网络域名（"*"）、包含文件系统和外部 MCP 工具，且涉及创建、更新、删除资源。没有最小权限 IAM 指南、逐次用户确认、敏感数据处理、删除前确认、回滚或恢复流程，因此扣除较多分数。
CRUD、长运行操作轮询和数据平面引用关系基本自洽，主路径可理解；但没有错误响应、重试/超时、分页、并发更新、权限失败或异常输入处理，也没有验证示例中的 API 版本、字段和模型可用性。静态校准下不超过 10 分，因此扣分。
目标用户和核心场景（以 REST 管理有状态 Agent）较明确，也说明应转向 interactions 技能；但未定义不适用范围、所需 IAM/API 启用条件、区域限制和触发边界。内容完全依赖 Google Cloud 海外服务，未提供中国大陆网络可达性或替代路径说明，因此扣分。
章节结构清晰，包含安装入口、配置、示例、许可证和仓库支持/贡献路径；但该技能没有版本、变更日志、维护责任人、依赖清单、FAQ、限制说明或故障排查，并且只在仓库层面声明 Apache-2.0，故未满分。
提供了创建、轮询、获取、列出、更新和删除的直接 curl 示例，并给出与数据平面衔接的 Python/JSON 片段，能覆盖核心任务；但示例是模板化的，缺少可验证的完整端到端输出、失败处理和权限/资源准备步骤，用户仍需较多核验和补充，因此静态上限内扣分。
证据主要是目标 SKILL.md、仓库 README 和 LICENSE；内容包含具体端点与请求样例，但没有提交测试、CI 覆盖、官方文档引用或第三方执行证据，无法独立复现关键路径。静态校准下仅给有限分数。
- 不要直接复用 network allowlist 为 "*" 或将真实密钥写入示例；应先限定域名、审查 MCP 服务并采用 Secret Manager 等安全注入方式。
- 删除和更新属于外部状态变更；执行前应确认资源、备份配置，并自行建立回滚或恢复方案。
- 在生产使用前，应核对 v1beta1 端点、字段、区域支持、IAM 权限和模型标识；文档没有提供错误处理或可执行测试。
- 中国大陆用户可能无法稳定访问核心 Google Cloud 服务，需先验证网络可达性和合规性。
这个 Skill 能做什么，适合哪些场景？
该技能指导开发者通过 Gemini Enterprise Agent Platform Managed Agents API 管理自定义、有状态的 Agent 资源。它涵盖创建、查询、列出、更新和删除，以及长时运行操作的轮询。Agent 可配置系统指令、工具、沙盒文件、技能注册表和远程环境，并可挂载 Cloud Storage 或 Skill Registry 资源。对话执行属于 Data Plane，应参考单独的 gemini-interactions-api 技能。
设置项目、区域和 ADC 访问令牌；调用生产环境 REST Control Plane 端点创建、获取、列出、更新和删除 Agent；轮询创建操作的状态；在请求中配置代码执行、文件系统、Google Search、URL Context 和 MCP 工具；将 Cloud Storage 或 Skill Registry 资源挂载到 Agent 工作区；使用 update_mask 精确更新配置。
- Google Cloud 开发者需要创建带系统指令和工具的自定义 Agent 时。
- 平台工程师需要列出或读取项目中已配置的 Agent 时。
- 团队需要通过 PATCH 修改 Agent 指令、工具或挂载配置时。
- 开发者需要把 Cloud Storage 中的文件、文件夹或技能挂载到 Agent 容器时。
- 需要配置第三方 MCP 服务并通过专用端点路由工具请求时。
这个 Skill 有哪些优点和局限？
- 覆盖完整的 Managed Agents Control Plane CRUD 流程。
- 提供可复制的 curl 请求、端点和 JSON 载荷示例。
- 支持 Cloud Storage、Skill Registry、工具和第三方 MCP 配置。
- 说明长时运行创建操作、MCP 请求路由和 update_mask 要求。
- 内容针对 Gemini Enterprise Agent Platform 和 Google Cloud，不能证明适用于其他 Agent 平台。
- 依赖 Google Cloud 项目、ADC 令牌和 gcloud CLI；源材料未说明权限角色。
- 源材料未提供测试套件、版本兼容矩阵、费用说明或失败重试策略。
- 对话和流式交互不在本技能范围内，需另行参考 gemini-interactions-api。
如何安装这个 Skill？
从集合安装：npx skills add google/skills。安装命令支持选择该仓库中的具体技能；源材料未说明选择该技能后的本地目录或客户端加载步骤。
如何使用这个 Skill？
在支持 Agent Skills 的客户端中请求管理 Gemini Enterprise Agent，例如“创建一个名为 my-custom-agent 的 Agent，配置系统指令并挂载 Cloud Storage 技能目录”。实际 REST 调用需要设置 PROJECT_ID、LOCATION 和 ACCESS_TOKEN=$(gcloud auth print-access-token)，并使用文档中的 Agents Control Plane 端点。若要开始对话或配置流式交互，应参考 gemini-interactions-api 技能。
这个 Skill 与同类方案有什么区别？
该技能负责 Agent 资源的 Control Plane 管理；gemini-interactions-api 技能负责已创建 Agent 的对话、工具执行和流式交互。