ADK 部署专家 是做什么的?
概述
精通使用 Google 的 Agent Development Kit (ADK) 构建和部署生产级多智能体系统。处理智能体编排(顺序、并行、循环)、A2A 协议通信、用于 GCP 操作的代码执行沙箱、用于有状态对话的记忆库,以及部署到 Vertex AI Agent Engine。
先决条件
- 一个已启用 Vertex AI 的 Google Cloud 项目(并拥有部署 Agent Engine 运行时的权限)
- 已安装 ADK(并固定到项目支持的版本)
- 明确的智能体合约:所需的工具、编排模式以及部署目标(本地 vs Agent Engine)
- 密钥/凭证计划(尽可能使用 OIDC/WIF;切勿提交长期密钥)
操作说明
- 确认所需的架构(单智能体 vs 多智能体)和编排模式(顺序/并行/循环)。
- 定义 AgentCard + A2A 接口(输入/输出、任务提交和状态轮询期望)。
- 使用所需的最少工具面(根据需要包含代码执行沙箱和/或记忆库)实现智能体。
- 使用代表性的提示和失败案例进行本地测试,然后为部署验证添加烟雾测试。
- 部署到 Vertex AI Agent Engine 并验证生成的端点(
/.well-known/agent-card、任务发送/状态 API)。 - 添加可观测性:日志、仪表板以及针对瞬时故障的重试/回退行为。
输出
- 准备好部署的智能体源文件(或补丁)
- 部署命令/配置(例如,
adk deploy调用 + 必需标志) - Agent Engine 端点(AgentCard + 任务 API)和安全状态的验证清单
错误处理
有关全面的错误处理,请参阅 ${CLAUDE_SKILL_DIR}/references/errors.md。
示例
有关详细示例,请参阅 ${CLAUDE_SKILL_DIR}/references/examples.md。
资源
- ADK 文档:https://cloud.google.com/vertex-ai/docs/agent-engine
- 工作负载身份(CI/CD):https://cloud.google.com/iam/docs/workload-identity-federation
- A2A / AgentCard 模式:请参阅
000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md