Google agents-cli 套件里的部署技能(SKILL.md 署名 Google):指导代理用 agents-cli 把 ADK 等框架写的智能体部署到 Agent Runtime、Cloud Run 或 GKE,并配置密钥、服务账号、CI/CD 流水线、回滚和排障。
skills.sh 安装量 525087(+4817 / 24h)
安全审计:有风险提示
- 会安装或运行第三方包(npx / pip 等),属于执行命令
- 让代理执行 shell / 脚本命令
- 会发起网络请求或调用外部 API / 远程 MCP
- 会上报使用数据(遥测)
- 读取环境变量或需要 API Key / Token
- 审计范围:GitHub google/agents-cli/skills/google-agents-cli-deploy/SKILL.md(只扫描 SKILL.md 文本)
理由
- 先给三种目标的对比表(伸缩、网络、会话状态、计费方式、上手难度),要求代理问用户选哪种;需要 OAuth 用户授权的智能体建议用 Agent Runtime,实时语音建议 Cloud Run 加 --timeout 3600 和 --min-instances 1
- 部署前要把评估分数和测试结果贴给用户,问“Ready to deploy to dev?”,得到明确同意才运行 agents-cli deploy;SKILL.md 写明没有人工批准绝不部署
- 密钥走 Secret Manager,用 --secrets 在部署时注入;自定义基础设施(Cloud SQL、Pub/Sub 等)要求写进 Terraform,不手动 gcloud 创建
- 回滚:主要靠 git 修复后重走流水线;Cloud Run 可切流量到旧版本,GKE 用 kubectl rollout undo,Agent Runtime 只能修好重部署
- 前两天收录的 publish、adk-code 是同一套件;skills.sh 24 小时安装 4817,累计 525087,每周安装从高点 132542 回落到 11134(只代表关注度)
用法
- 安装命令待审计通过后显示(本期有风险提示);CLI 用 uv tool install google-agents-cli 安装
- 需要 Google Cloud 项目和对应权限;项目没搭好先用 /google-agents-cli-scaffold,最好整套技能一起装
- 说 “deploy my ADK agent”“set up CI/CD”“configure secrets” 等时触发;自动解析项目时非交互环境要加 --no-confirm-project
风险
- 审计提示的安装、shell、网络请求、读取密钥与用途相符:要装 agents-cli,部署本身就是调 GCP、处理 Secret Manager 里的密钥
- 审计提示的“遥测”对应可选的可观测性配置(Cloud Trace、提示词与回复日志写进你自己项目的 BigQuery),不是向第三方上报;开启后提示词内容会落库
- 部署、IAM 授权、Terraform apply 都会改动真实云资源并产生费用;references/ 下的详细文档没有扫描