ADK Agent 构建器
使用 Google 的 Agent Development Kit (ADK) 构建可用于生产环境的 Agent:包括项目骨架生成、工具连接、编排模式、测试,以及可选的部署到 Vertex AI Agent Engine。
概述
- 创建一个最小化的、面向生产的 ADK 项目骨架(Agent 入口、工具注册表、配置和测试)。
- 支持单 Agent ReAct 风格工作流和多 Agent 编排(串行/并行/循环)。
- 生成适合 CI 的验证清单(lint/测试/冒烟提示),以及可选的 Agent Engine 部署验证。
前提条件
- 与您的项目兼容的 Python 运行时(通常需要 Python 3.10+)
- 已安装并可导入
google-adk - 如果需要部署:需要有一个启用了 Vertex AI 且有权限部署 Agent Engine 运行时的 Google Cloud 项目
- 通过环境变量或密钥管理器提供密钥(切勿硬编码)
说明
- 确定范围:仅本地 Agent 骨架还是需要部署到 Vertex AI Agent Engine。
- 选择架构:
- 单 Agent(ReAct):适用于自适应工具驱动的任务
- 多 Agent 系统(专家 + 编排器):适用于复杂、多步骤的工作流
- 定义工具接口(ADK 内置工具 + 您需要的任何自定义工具)和所需的凭证。
- 生成项目骨架:
src/agents/、src/tools/、tests/以及一个依赖文件(pyproject.toml或requirements.txt)
- 实现最小可行 Agent 和一个冒烟测试提示;添加针对工具失败的回归测试。
- 如果需要部署,请生成一个
adk deploy ...命令以及一个部署后验证清单(AgentCard/任务端点、权限、日志)。
输出
- 一个可直接用于仓库的 ADK 骨架(文件和目录)以及起始 Agent 代码
- 工具存根和连接点(安全添加新工具的位置)
- 测试 + 验证计划(单元测试和一个最小冒烟提示)
- 可选:部署命令和 Agent Engine 的验证步骤
错误处理
- 依赖/运行时问题:提供固定版本的安装命令并验证导入。
- 认证/权限失败:识别缺失的角色/API 并提出最小权限修复方案。
- 工具失败/频率限制:提供重试/退避指南并添加回归测试以防止再次发生。
示例
示例:搭建一个单 ReAct Agent
- 请求:“创建一个 ADK Agent,用于总结 PR 并提出测试更新建议。”
- 结果:Agent 入口 + 工具注册表 + 用于本地验证的冒烟测试命令。
示例:多 Agent 编排器
- 请求:“构建一个监督者 + 部署者 + 验证者团队,并部署到 Agent Engine。”
- 结果:编排器骨架、每个 Agent 的职责,以及
adk deploy ...+ 部署后的健康检查。
资源
- 完整详细指南(仅供参考):
${CLAUDE_SKILL_DIR}/references/SKILL.full.md - 仓库标准(唯一事实来源):
000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md000-docs/6767-b-SPEC-DR-STND-claude-skills-standard.md
- ADK / Agent Engine 文档:https://cloud.google.com/vertex-ai/docs/agent-engine