Agent Platform 端点管理
管理 Agent Platform 在线预测服务端点及其常见故障。
文档明确区分只读、可逆变更和删除,并要求对创建、更新和删除进行确认,且删除确认先于预检;但认证命令权限范围较宽,未说明最小 IAM 权限、凭据和数据流处理、删除后的恢复方案或审计验证,因此扣分。
核心 list、describe、create、update、delete 命令路径基本一致,并包含区域要求和部分错误类型;但流量拆分章节未提供实际更新命令,转而引用其他技能,认证、资源状态、参数错误和失败后的诊断反馈覆盖不足,因此静态评分受限。
名称、用途、支持的 CRUD 操作、排除的模型部署和评估场景较清楚,也明确要求区域输入;但触发条件、非适用边界、中文支持及中国大陆网络可达性没有说明,且流量拆分能力描述不完整,因此扣分。
文档有元数据、概览、安全分层、操作章节、故障排查和示例,仓库提供 Apache-2.0、安装方式、支持渠道及活跃开发说明;但缺少技能级版本、变更记录、明确维护负责人、依赖说明、参数契约和更完整的限制/FAQ,因此未满分。
对按区域执行端点列出、查看、创建、更新和删除提供了可直接参考的 gcloud 命令,能覆盖主要管理任务;但没有可验证的代表性输出、回滚流程、完整流量拆分操作或充分的结果校验,用户仍可能需要补充判断和手工排错,因此扣分。
技能文件和仓库文档提供了可审计的命令、范围和治理信息,但未提供覆盖关键路径的测试套件、CI 执行证据、第三方复核或可复现实例;结论主要基于静态文本,因此仅给有限分数。
- 删除操作不可逆,且文档未提供恢复或备份流程;确认前也不会执行端点状态预检。
- 认证步骤涉及 gcloud 登录和 ADC,使用前应由用户确认凭据来源、IAM 权限和项目范围。
- 流量拆分章节不完整,并依赖未包含在本评估范围内的其他技能。
- 未提供中文说明或中国大陆网络可达性信息。
这个 Skill 能做什么,适合哪些场景?
该技能为 Google Agent Platform 端点提供创建、列出、查看、更新和删除流程。它将端点视为承载在线预测并提供稳定 URL 的逻辑服务主机。技能要求先完成 Google Cloud 身份验证、配置项目,并在每条命令中指定区域。它不用于部署模型或运行模型评估。
通过 gcloud CLI 登录 Google Cloud 并配置应用默认凭据,设置活动项目;在指定区域列出和描述端点;在确认后创建或更新端点;在明确确认后删除端点;说明流量拆分相关操作应通过模型部署流程处理;针对权限不足、配额超限和资源忙错误提供排查建议。
- Google Cloud 用户需要查看某个区域已有 Agent Platform 端点及其 ID。
- 平台工程师需要在部署模型前创建一个新的在线预测端点。
- 管理员需要修改端点显示名称或标签,并希望在执行变更前进行确认。
- 运维人员删除端点失败,需要检查模型是否仍在取消部署,或排查权限和区域配额问题。
这个 Skill 有哪些优点和局限?
- 覆盖端点生命周期中的列出、查看、创建、更新和删除操作。
- 明确区分只读、可逆变更和破坏性删除的确认等级。
- 包含权限、区域配额和资源忙错误的具体排查方向。
- 依赖 gcloud CLI、Google Cloud 身份验证、活动项目和明确区域。
- 不负责模型部署、取消部署或模型评估。
- 来源未提供测试套件、版本兼容矩阵或自动化脚本。
如何安装这个 Skill?
运行 npx skills add google/skills,并在安装过程中选择 Agent Platform Endpoint Management。该技能位于 skills/cloud/agent-platform-endpoint-management/SKILL.md。
如何使用这个 Skill?
先完成 gcloud auth login 和 gcloud auth application-default login,再运行 gcloud config set project $PROJECT_ID。使用时明确提供区域,例如请求“列出 us-central1 中的 Agent Platform 端点”或“描述端点 ENDPOINT_ID”。列出、描述和获取操作无需确认;创建、更新需要展示包含完整参数的命令并等待 Yes/No;删除需要立即等待用户输入明确的文字确认。