Gemini 企业代理技能注册中心
帮助代理搜索、管理并生成 Gemini Enterprise Agent Platform 技能。
证据显示使用 Google Cloud 默认凭据并通过 Bearer token 调用云端 API,且明确区分只读查询与生命周期变更;但上传、更新和永久删除均无用户确认、最小权限要求、敏感数据流说明或回滚方案,因此扣分。
脚本覆盖文档列出的主要命令,并检查项目和区域环境变量;但未提供超时、重试、响应结构校验、部分失败恢复或测试,且强制验证脚本只在文档中要求执行而未由主脚本自动执行,因此扣分。
目标用户和场景较明确,包含搜索、获取、修订查询、生命周期管理及技能脚手架生成;但主技能缺少完整的 Use when/Don't use when、输入输出边界和触发条件,未说明中文支持,且依赖 Google Cloud 海外服务的可达性,因此扣分。
文档按核心能力、先决条件、快速开始和引用资料分层,命令示例较完整,仓库提供 Apache-2.0 许可、安装方式和问题反馈路径;但没有技能版本、变更日志、明确维护责任,且“安装最新库”缺乏版本锁定,因此扣分。
提供了可直接复制的搜索、列出、获取、上传、更新、删除、修订和操作监控命令,能够覆盖注册表管理核心任务;但返回结果仍需用户自行解释,生成技能仅是初稿,缺乏代表性结果或执行证据,且异常场景处理有限,因此扣分。
提交了与文档相对应的 Python 实现和环境验证脚本,关键 API 路径可静态审计;但未提供测试套件、CI 覆盖、第三方执行记录或交叉来源验证,静态审查无法确认 API 行为,因此扣分。
- 删除操作被描述为永久删除,但没有确认提示、备份或恢复流程;执行前应人工核对项目、区域和 skill ID。
- 脚本直接读取本地文件、打包目录并上传到 Google Cloud;上传前应审查压缩包内容,避免提交凭据或敏感数据。
- 依赖和 Google Cloud API 行为未锁定或静态验证,建议在隔离环境中先进行只读操作并核对实际 API 文档。
- 未说明中国大陆网络可达性,相关服务访问可能需要额外网络配置。
这个 Skill 能做什么,适合哪些场景?
该技能用于与 Gemini Enterprise Agent Platform Skill Registry 交互。它支持搜索和发现技能、查看具体技能及修订历史,并管理技能的上传、更新和永久删除。它还可检查长时间运行操作的状态,并在本地生成新技能的初始脚手架。使用前需要完成环境验证、Google Cloud 认证,并设置项目和区域信息。
在执行注册中心操作前运行 python3 scripts/validate_env.py;使用 scripts/skill_registry_ops.py 搜索技能;按照技能说明查询、列出、获取技能并检查修订历史;上传、更新或永久删除技能;检查长时间运行操作的完成状态;在本地生成新技能的初始脚手架。
- 需要在 Gemini Enterprise Agent Platform 中查找现有能力的代理开发者,可用它搜索和查看注册技能。
- 需要发布新技能的团队,可用它上传技能并监控相关长时间运行操作。
- 需要维护已注册技能的管理员,可用它更新或永久删除技能。
- 准备开发新代理技能的工程师,可用它生成本地初始脚手架。
这个 Skill 有哪些优点和局限?
- 覆盖技能发现、生命周期管理、长时间运行操作监控和脚手架生成。
- 提供明确的环境验证和 Google Cloud 认证前置要求。
- 可通过仓库安装流程单独选择该技能。
- 依赖 Google Cloud 项目、区域和应用默认凭据。
- 上传、更新、删除及生成脚手架的完整命令未在源材料中列出。
- 源材料没有提供测试套件、平台验证结果或费用信息。
- 永久删除属于不可逆的生命周期操作,使用时需要谨慎。
如何安装这个 Skill?
运行 npx skills add google/skills,并在安装过程中选择 agent-platform-skill-registry 技能。源材料没有说明选择后该文件夹的具体安装位置。使用前安装依赖:pip install google-auth requests;然后运行 gcloud auth application-default login。
如何使用这个 Skill?
先运行 python3 scripts/validate_env.py。设置 GCP_PROJECT_ID 和 GCP_LOCATION 环境变量,并确保 Google Cloud 凭据可用。搜索示例:python3 scripts/skill_registry_ops.py search --query "test skill" --top-k 5。其他查询、生命周期管理、操作监控和脚手架生成命令应参考该技能目录中的对应文档;源材料未提供这些命令的完整语法。