ADK Developer

ADK Developer 技能为工程师和 AI 开发人员提供了一个结构化框架，用于使用基于 Python 的 Google Agent Development Kit (ADK) 设计、实现和维护智能代理。此技能涵盖了代理开发的完整生命周期，从 LlmAgent 和 BaseAgent 等基础原语到复杂的多代理编排和部署策略。它专为需要将大型语言模型（特别是使用 Vertex AI）集成到具有清晰可观测性、状态管理和调试功能的强大且可扩展工作流程中的开发人员而设计。用户将学习如何构建项目、定义自定义工具、管理会话记忆以及确保代理之间的安全通信。

• 全面支持 ADK 原语，包括用于建立状态化对话系统的会话、状态、记忆和事件管理。

• 全面的工作流程编排指南，涵盖简单的 LlmAgent 模式和复杂的多代理系统架构。

• 与 Vertex AI 深度集成，使用 gemini-2.5-flash 等高性能模型进行安全模型执行。

• 标准化的项目布局建议，以支持原生 CLI 发现并保持代码库的可维护性。

• 通过事件日志记录和追踪工具实现流处理、性能优化和可观测性的高级功能。

• 务必通过提供的内部脚本检查存储库更新来初始化会话，以确保与当前的 API 参考同步。

• 强制性的配置协议要求用户明确定义 GOOGLE_CLOUD_PROJECT 和 GOOGLE_CLOUD_LOCATION；基于安全原因，严格禁止使用隐含默认值。

• 在升级到多代理或 WorkflowAgent 架构之前，应优先考虑从简单的 LlmAgent 设计开始以保持简洁。

• 强制执行结构边界：所有代理代码必须位于专用的子目录中，而不是根目录，以支持 ADK 的发现机制。

• 设计构件应在生成任何实现代码之前提交验证，以确保架构一致性。

• 使用包含 FunctionTool 和 OpenAPIToolset 的标准工具，确保所有基于工具的身份验证均根据定义的安全最佳实践进行处理。