agents-cli scaffold enhance 实战给已有项目「外挂」部署和 CI/CD 能力【免费下载链接】agents-cliThe CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-cli本文介绍如何用agents-cli的scaffold enhance命令一条命令给已有的 AI Agent 项目「外挂」上 Google Cloud 部署配置和 CI/CD 管道。无需手写 Terraform 和 GitHub Actionssmart-merge 机制还会自动保护你改过的每一行代码——从原型到生产全程几分钟搞定。一、enhance 解决什么问题不动业务代码只加「基础设施」如果你已经有一个能跑起来的 Agent 项目比如用 ADK 写的 Python 原型现在想部署上线通常要手动补齐一堆东西Dockerfile、deployment/下的 Terraform 配置、CI/CD 工作流、Makefile、环境变量文件……这些文件不仅多还容易写得和官方推荐结构不一致。scaffold enhance的设计哲学是把项目模板「就地应用」到你的现有目录只添加基础设施文件不碰你的 Agent 逻辑。它的几个关键特性Smart-merge 三方对比生成「原始模板」与「增强后模板」做对比只覆盖你没有修改过的文件你自定义的代码原样保留自动备份写盘前会先在~/.agents-cli/backups/创建项目备份配置持久化所有参数记录在agents-cli-manifest.yaml中后续升级、再次 enhance 时自动复用并锁定当时的 agents-cli 版本。下图展示了 agents-cli 所处的整体平台架构可以看到 DeploymentAgent Runtime / Cloud Run与 CI/CD、IaC 是它重点覆盖的环节二、三步上手给已有项目添加部署能力第 1 步安装 agents-cli确保环境有 Python 3.11 和uv然后一条命令完成安装与技能注入uvx google-agents-cli setup第 2 步在项目目录内执行 enhance进入你的项目目录用.指向当前目录即可。按需组合两个最核心的参数# 添加部署目标agent_runtime / cloud_run / gke agents-cli scaffold enhance . --deployment-target cloud_run # 添加 CI/CD 管道github_actions / google_cloud_build agents-cli scaffold enhance . --cicd-runner github_actions命令执行后会显示确认信息新增哪些模板文件、备份位置等确认后开始写盘。如果你希望用交互式菜单逐项选择部署目标、会话存储、CI/CD Runner可以加上--interactive。第 3 步建议先用 --dry-run 预览在不确定的情况下先预览变更、零风险agents-cli scaffold enhance . --deployment-target gke --dry-run确认变更列表符合预期后去掉--dry-run正式执行。三、部署目标怎么选agent_runtime、cloud_run 还是 gkeenhance 支持四大部署目标后续可以随时用同一条命令切换目标目标说明适合场景agent_runtime全托管运行时官方自动构建你的 Dockerfile会话由其内部管理想少操心运维首选 ✅cloud_run容器化部署到 Cloud Run构建和部署过程可控需要自定义资源、端口、镜像gke基于 GKE Autopilot 的 Kubernetes 部署需要完整 Kubernetes 能力none不生成部署脚手架仍含 Dockerfile暂不部署只要代码结构 小提示切到agent_runtime后enhance 会自动清理 manifest 里无意义的session_type配置——因为 Agent Runtime 会内部管理会话。四、CI/CD 管道拉取请求测试 → 合并上 Staging → 手动批准上生产执行--cicd-runner后项目会获得一套「原型到生产」的标准流水线整个流程分三段对应生成的工作流文件CI 管道Pull Request 触发跑单元测试 集成测试Staging CD 管道合并到main触发构建并推送容器镜像 → 部署 Staging → 自动负载测试生产部署Staging 成功后需要手动批准部署的是与 Staging 完全相同的镜像。脚手架生成的是「模板文件」真正开通双环境staging/prod基础设施只需再执行一条命令Terraform 会自动完成资源配置和仓库连接agents-cli infra cicd \ --staging-project my-staging-project \ --prod-project my-prod-projectRunner 的选型GitHub Actions 使用 Workload Identity Federation 免密钥认证Cloud Build 则自动创建 GitHub 连接会自动从项目配置中检测。五、实战技巧与常见坑 ️场景建议做法Agent 代码不在app/目录传--agent-directory 你的目录避免 enhance 找不到或错放文件想强制全量覆盖模板加--force跳过 smart-merge 对比冲突时偏向新模板可加--prefer-new想只「抄」几个文件不改造当前项目用 scaffold as reference在/tmp建一个临时项目挑好文件复制过来再删掉版本不一致报错无需处理——manifest 锁定了项目创建时的 agents-cli 版本CLI 会通过uvx google-agents-cli版本自动用对应版本执行另外本地开发和验证完全不依赖 Google Cloudagents-cli run test prompt做冒烟测试agents-cli eval run做系统化评估确认没问题再上线。六、延伸阅读源码与文档导航想深入某个环节可以直接阅读项目内的这些资料脚手架技能完整指南含所有约束与最佳实践skills/google-agents-cli-scaffold/SKILL.mdcreate/enhance全部参数速查表skills/google-agents-cli-scaffold/references/flags.mdenhance 命令核心实现smart-merge 调用入口src/google/agents/cli/scaffold/commands/enhance.py部署目标详解Agent Runtime / Cloud Run / GKEdocs/src/guide/deployment.mdCI/CD 与生产环境完整文档docs/src/guide/cicd.md项目配置清单模板enhance 会更新这个文件src/google/agents/cli/scaffold/base_templates/_shared/agents-cli-manifest.yaml总结原型阶段专注写 Agent 逻辑等它稳定了一句agents-cli scaffold enhance就能把部署和 CI/CD「外挂」上去——这正是官方推荐的 Prototype First 工作流。【免费下载链接】agents-cliThe CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 agents-cli scaffold enhance 实战：给已有项目「外挂」部署和 CI/CD 能力
agents-cli scaffold enhance 实战给已有项目「外挂」部署和 CI/CD 能力【免费下载链接】agents-cliThe CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-cli本文介绍如何用agents-cli的scaffold enhance命令一条命令给已有的 AI Agent 项目「外挂」上 Google Cloud 部署配置和 CI/CD 管道。无需手写 Terraform 和 GitHub Actionssmart-merge 机制还会自动保护你改过的每一行代码——从原型到生产全程几分钟搞定。一、enhance 解决什么问题不动业务代码只加「基础设施」如果你已经有一个能跑起来的 Agent 项目比如用 ADK 写的 Python 原型现在想部署上线通常要手动补齐一堆东西Dockerfile、deployment/下的 Terraform 配置、CI/CD 工作流、Makefile、环境变量文件……这些文件不仅多还容易写得和官方推荐结构不一致。scaffold enhance的设计哲学是把项目模板「就地应用」到你的现有目录只添加基础设施文件不碰你的 Agent 逻辑。它的几个关键特性Smart-merge 三方对比生成「原始模板」与「增强后模板」做对比只覆盖你没有修改过的文件你自定义的代码原样保留自动备份写盘前会先在~/.agents-cli/backups/创建项目备份配置持久化所有参数记录在agents-cli-manifest.yaml中后续升级、再次 enhance 时自动复用并锁定当时的 agents-cli 版本。下图展示了 agents-cli 所处的整体平台架构可以看到 DeploymentAgent Runtime / Cloud Run与 CI/CD、IaC 是它重点覆盖的环节二、三步上手给已有项目添加部署能力第 1 步安装 agents-cli确保环境有 Python 3.11 和uv然后一条命令完成安装与技能注入uvx google-agents-cli setup第 2 步在项目目录内执行 enhance进入你的项目目录用.指向当前目录即可。按需组合两个最核心的参数# 添加部署目标agent_runtime / cloud_run / gke agents-cli scaffold enhance . --deployment-target cloud_run # 添加 CI/CD 管道github_actions / google_cloud_build agents-cli scaffold enhance . --cicd-runner github_actions命令执行后会显示确认信息新增哪些模板文件、备份位置等确认后开始写盘。如果你希望用交互式菜单逐项选择部署目标、会话存储、CI/CD Runner可以加上--interactive。第 3 步建议先用 --dry-run 预览在不确定的情况下先预览变更、零风险agents-cli scaffold enhance . --deployment-target gke --dry-run确认变更列表符合预期后去掉--dry-run正式执行。三、部署目标怎么选agent_runtime、cloud_run 还是 gkeenhance 支持四大部署目标后续可以随时用同一条命令切换目标目标说明适合场景agent_runtime全托管运行时官方自动构建你的 Dockerfile会话由其内部管理想少操心运维首选 ✅cloud_run容器化部署到 Cloud Run构建和部署过程可控需要自定义资源、端口、镜像gke基于 GKE Autopilot 的 Kubernetes 部署需要完整 Kubernetes 能力none不生成部署脚手架仍含 Dockerfile暂不部署只要代码结构 小提示切到agent_runtime后enhance 会自动清理 manifest 里无意义的session_type配置——因为 Agent Runtime 会内部管理会话。四、CI/CD 管道拉取请求测试 → 合并上 Staging → 手动批准上生产执行--cicd-runner后项目会获得一套「原型到生产」的标准流水线整个流程分三段对应生成的工作流文件CI 管道Pull Request 触发跑单元测试 集成测试Staging CD 管道合并到main触发构建并推送容器镜像 → 部署 Staging → 自动负载测试生产部署Staging 成功后需要手动批准部署的是与 Staging 完全相同的镜像。脚手架生成的是「模板文件」真正开通双环境staging/prod基础设施只需再执行一条命令Terraform 会自动完成资源配置和仓库连接agents-cli infra cicd \ --staging-project my-staging-project \ --prod-project my-prod-projectRunner 的选型GitHub Actions 使用 Workload Identity Federation 免密钥认证Cloud Build 则自动创建 GitHub 连接会自动从项目配置中检测。五、实战技巧与常见坑 ️场景建议做法Agent 代码不在app/目录传--agent-directory 你的目录避免 enhance 找不到或错放文件想强制全量覆盖模板加--force跳过 smart-merge 对比冲突时偏向新模板可加--prefer-new想只「抄」几个文件不改造当前项目用 scaffold as reference在/tmp建一个临时项目挑好文件复制过来再删掉版本不一致报错无需处理——manifest 锁定了项目创建时的 agents-cli 版本CLI 会通过uvx google-agents-cli版本自动用对应版本执行另外本地开发和验证完全不依赖 Google Cloudagents-cli run test prompt做冒烟测试agents-cli eval run做系统化评估确认没问题再上线。六、延伸阅读源码与文档导航想深入某个环节可以直接阅读项目内的这些资料脚手架技能完整指南含所有约束与最佳实践skills/google-agents-cli-scaffold/SKILL.mdcreate/enhance全部参数速查表skills/google-agents-cli-scaffold/references/flags.mdenhance 命令核心实现smart-merge 调用入口src/google/agents/cli/scaffold/commands/enhance.py部署目标详解Agent Runtime / Cloud Run / GKEdocs/src/guide/deployment.mdCI/CD 与生产环境完整文档docs/src/guide/cicd.md项目配置清单模板enhance 会更新这个文件src/google/agents/cli/scaffold/base_templates/_shared/agents-cli-manifest.yaml总结原型阶段专注写 Agent 逻辑等它稳定了一句agents-cli scaffold enhance就能把部署和 CI/CD「外挂」上去——这正是官方推荐的 Prototype First 工作流。【免费下载链接】agents-cliThe CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.项目地址: https://gitcode.com/GitHub_Trending/ag/agents-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考