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 的標準工具，確保所有基於工具的身份驗證均根據定義的安全最佳實踐進行處理。