用途:将现有 Python recipe 改造为可容器化并以服务方式运行的形态:生成并配置容器所需文件,使 recipe 用统一标准布局对外提供 FastAPI 与 A2A 服务。标准定义在 .github/policy.yml 的 deployability 段(最低 google-adk 版本、依赖清单、必需文件清单、旧版 app_utils 文件清单)。该技能不构建镜像、不部署、不申请基础设施;镜像构建后续由 Cloud Build → Artifact Registry 完成。
主要能力:生成六个文件并编辑三个,合并缺失的 extras(如 google-adk → google-adk[gcp,otel-gcp],版本边界不变),报告 checks、todos、notes。可用 --data-dirs a,b 指定运行期数据目录,--overwrite 覆盖已有 fast_api_app.py,--region 设置部署区域(默认 us-east1),--verify-container 做容器验证。
使用方式:先 dry-run 并确认计划后再 --apply;必要的门禁(adk-locked-version、adk-version-floor、legacy-app-utils)返回 needs_input 时必须交人处理,不得绕过。应用后按报告 todos 运行 uv lock(如 uv lock --python 3.11 或 uv lock --upgrade-package google-adk --python 3.11),再执行 ruff 格式化与校验、pytest;随后用 TestClient 做启动检查,必要时在 docker 可用且用户同意时做容器验证。
限制:不部署、不推送镜像,不跨 ADK 主版本迁移代码,不合并旧版 app_utils 代际,不编写 terraform。未验证结果不得称为已证实;容器化结果不得称为可部署;生成 a2a.py 本身不证明支持 A2A,若 agent card 非 200 需如实说明。非白名单 recipe 只构建不运行。具体收费、价格与平台细节暂未提供。