Agent Platform 调优任务管理
用 Python SDK 查看、查询并取消 Agent Platform 调优任务。
技能明确区分只读操作与取消操作,并要求取消前进行明确的文字确认,也要求缺少项目或区域时先询问、错误后停止,体现了基本的最小化和外部影响控制。扣分原因是需要执行 gcloud 登录和 ADC 配置,未说明凭据、项目数据或网络数据流,也未固定依赖版本;取消操作虽有确认但没有恢复或撤销机制。
Python SDK 示例覆盖列出、获取和取消三条核心路径,且规定部分错误应停止执行。静态证据未包含测试、CI、版本锁定或可复现结果;19 位 Job ID 的硬编码假设也可能排除合法输入,错误分类还把权限错误与资源不存在混为一谈,因此不超过静态上限并扣分。
描述清楚覆盖调优任务的列出、查看和取消,并明确排除微调、部署和端点管理,项目 ID、区域和任务 ID 等输入也有说明。扣分原因是没有非适用边界之外的环境说明、中文支持或替代路径;核心功能依赖 Google Cloud 与海外服务,面向中国大陆用户的可达性未被说明。
SKILL.md 结构清晰,包含元数据、安全分级、环境设置、决策树、示例和错误处理;README 提供安装方式、许可证、贡献和问题反馈入口。扣分原因是缺少技能版本、变更记录、明确维护负责人、依赖版本、FAQ 和已知限制。
示例理论上可直接完成列出、查询和取消调优任务,且任务类型边界明确。扣分原因是代码仍需替换占位符、手动认证和安装依赖,未提供已验证输出或更高层次的用户友好结果;静态审查无法确认 API 与当前 SDK 的实际兼容性。
源文件提供了可审计的流程、代码和安全要求,README 与 LICENSE 也支持来源和授权核查。扣分原因是没有提交测试、CI 覆盖、执行日志或第三方复现证据,因此只能给予有限的静态可验证性。
- 取消调优任务会丢失进度;执行前必须获得明确的逐字确认,并确认项目、区域和任务 ID。
- 示例使用未固定版本的 google-cloud-aiplatform,运行前应核对 SDK 与 API 兼容性。
- gcloud 登录和 ADC 会影响本地凭据环境;技能未说明凭据处理、权限范围或数据流。
- Google Cloud 服务的网络可达性和合规性未针对中国大陆环境说明。
这个 Skill 能做什么,适合哪些场景?
该技能用于管理 Agent Platform 中正在进行的 GenAI 调优任务。它支持列出调优任务、查看指定任务详情,以及在获得明确确认后取消运行中的任务。使用前需要准备 Python 虚拟环境、Google Cloud 身份认证和 Agent Platform SDK。执行前还必须提供有效的项目 ID 和区域;资源访问失败时应停止执行并要求用户提供有效信息。
指导用户创建并激活 Python 虚拟环境,登录 Google Cloud、配置 ADC,并安装 google-cloud-aiplatform。通过 GenAiTuningServiceClient 调用 list_tuning_jobs 列出任务,输出任务名称、基础模型和状态;调用 get_tuning_job 查询指定任务,并输出名称、基础模型、状态和调优模型显示名称;取消操作调用 cancel_tuning_job,但必须先取得用户输入的“I confirm”或“Yes, cancel it”等明确确认。
- 需要查看某个 Google Cloud 项目和区域中有哪些调优任务正在运行的用户。
- 需要根据 19 位调优任务 ID 检查任务状态和调优模型名称的用户。
- 某个调优任务运行时间过长、希望中止且愿意确认进度会丢失的用户。
- 需要通过 Agent Platform Python SDK 管理 GenAI 调优任务,而不是进行模型微调、部署或端点管理的开发者。
这个 Skill 有哪些优点和局限?
- 明确区分只读操作与取消操作,并为取消设置 typed confirmation 安全门槛。
- 覆盖列出任务、查询详情和取消任务三种具体 SDK 操作。
- 对缺失项目、区域、任务或权限错误规定了停止执行和重新收集信息的处理方式。
- 要求本地具备 Python 3、Google Cloud CLI、网络访问和 Agent Platform SDK,但未提供平台或版本兼容性测试证据。
- 必须预先知道项目 ID 和区域,不会自动搜索随机区域。
- 取消任务会丢失进度,且技能未提供恢复或撤销取消的方法。
- 源材料未提供测试套件、自动化脚本或错误重试机制。
如何安装这个 Skill?
运行:
npx skills add google/skills
安装过程中选择 Agent Platform Tuning Management 技能。README 未说明该命令最终将技能文件放置到哪个本地目录。
如何使用这个 Skill?
先执行:
python3 -m venv ~/tuning_mgr_venv
source ~/tuning_mgr_venv/bin/activate
gcloud auth login
gcloud auth application-default login
pip install google-cloud-aiplatform
之后使用示例请求:“列出项目 PROJECT_ID、区域 REGION 中的调优任务”或“查询调优任务 JOB_ID 的状态”。执行 Python 代码前,必须确保虚拟环境已激活。取消任务时,先明确说明停止过程会导致进度丢失,并要求用户输入“I confirm”或“Yes, cancel it”;未获得新一轮明确确认前不得提供或执行取消代码。
这个 Skill 与同类方案有什么区别?
该技能专注于调优任务的查询和取消;模型微调应使用 Agent Platform Tuning,模型部署应使用 Agent Platform Deploy,服务端点管理应使用 Agent Platform Endpoint Management。