Google ADK Python 技能
您是 Google Agent Development Kit (ADK) Python 的專家指南——這是一個開源、程式碼優先的工具包,用於建構、評估和部署 AI 代理。
何時使用此技能
當使用者需要以下功能時,請使用此技能:
- 建構具備工具整合和編排能力的 AI 代理
- 建立具有階層式協調機制的多代理系統
- 實作用於可預測管線的工作流程代理(順序、平行、循環)
- 將 LLM 驅動的代理與 Google 搜尋、程式碼執行或自訂工具整合
- 將代理部署到 Vertex AI Agent Engine、Cloud Run 或自訂基礎架構
- 系統性地評估和測試代理效能
- 對工具執行實作人機協同的批准流程
核心概念
代理類型
LlmAgent:由 LLM 驅動的代理,能夠進行動態路由和適應性行為
- 使用名稱、模型、指令、描述和工具來定義
- 支援子代理以進行委派和協調
- 根據上下文進行智慧決策
工作流程代理:結構化、可預測的編排模式
- SequentialAgent:按定義順序執行代理
- ParallelAgent:同時執行多個代理
- LoopAgent:使用迭代邏輯重複執行
BaseAgent:自訂代理實作的基礎
關鍵元件
工具生態系:
- 預先建立好的工具(google_search、code_execution)
- 作為工具的自訂 Python 函數
- OpenAPI 規格整合
- 用於人工批准的工具確認流程
多代理架構:
- 階層式代理組合
- 針對特定領域的專業代理
- 用於委派的協調器代理
安裝
# 穩定版本(建議)
pip install google-adk
# 開發版本(最新功能)
pip install git+https://github.com/google/adk-python.git@main
實作模式
單一代理與工具
from google.adk.agents import LlmAgent
from google.adk.tools import google_search
agent = LlmAgent(
name="search_assistant",
model="gemini-2.5-flash",
instruction="您是一個樂於助人的助手,會在網路上搜尋資訊。",
description="用於網路查詢的搜尋助手",
tools=[google_search]
)
多代理系統
from google.adk.agents import LlmAgent
# 專業代理
researcher = LlmAgent(
name="Researcher",
model="gemini-2.5-flash",
instruction="使用網路搜尋徹底研究主題。",
tools=[google_search]
)
writer = LlmAgent(
name="Writer",
model="gemini-2.5-flash",
instruction="根據研究撰寫清晰、引人入勝的內容。",
)
# 協調器代理
coordinator = LlmAgent(
name="Coordinator",
model="gemini-2.5-flash",
instruction="將任務委派給研究員和寫手代理。",
sub_agents=[researcher, writer]
)
自訂工具建立
from google.adk.tools import Tool
def calculate_sum(a: int, b: int) -> int:
"""計算兩個數字的和。"""
return a + b
# 將函數轉換為工具
sum_tool = Tool.from_function(calculate_sum)
agent = LlmAgent(
name="calculator",
model="gemini-2.5-flash",
tools=[sum_tool]
)
順序工作流程
from google.adk.agents import SequentialAgent
workflow = SequentialAgent(
name="research_workflow",
agents=[researcher, summarizer, writer]
)
平行工作流程
from google.adk.agents import ParallelAgent
parallel_research = ParallelAgent(
name="parallel_research",
agents=[web_researcher, paper_researcher, expert_researcher]
)
人機協同
from google.adk.tools import google_search
# 需要確認的工具
agent = LlmAgent(
name="careful_searcher",
model="gemini-2.5-flash",
tools=[google_search],
tool_confirmation=True # 執行前需要批准
)
部署選項
Cloud Run 部署
# 容器化代理
docker build -t my-agent .
# 部署到 Cloud Run
gcloud run deploy my-agent --image my-agent
Vertex AI Agent Engine
# 部署到 Vertex AI 以實現可擴展的代理託管
# 與 Google Cloud 的託管基礎架構整合
自訂基礎架構
# 在本機或自訂伺服器上執行代理
# 完全控制部署環境
模型支援
針對 Gemini 最佳化:
- gemini-2.5-flash
- gemini-2.5-pro
- gemini-1.5-flash
- gemini-1.5-pro
模型無關:雖然針對 Gemini 最佳化,但 ADK 透過標準 API 支援其他 LLM 提供者。
最佳實踐
- 程式碼優先哲學:在 Python 中定義代理,以利版本控制、測試和靈活性
- 模組化設計:為特定領域建立專業代理,並組合成系統
- 工具整合:利用預先建立好的工具,並透過自訂函數擴展
- 評估:針對測試案例系統性地測試代理
- 安全性:為敏感操作實作確認流程
- 階層式結構:為複雜的多代理工作流程使用協調器代理
- 工作流程選擇:為可預測的管線選擇工作流程代理,為動態路由選擇 LLM 代理
常見使用案例
- 研究助手:網路搜尋 + 摘要 + 報告生成
- 程式碼助手:程式碼執行 + 文件 + 除錯
- 客戶支援:查詢路由 + 知識庫 + 升級
- 內容創作:研究 + 寫作 + 編輯管線
- 資料分析:資料擷取 + 處理 + 視覺化
- 任務自動化:具有條件邏輯的多步驟工作流程
開發者 UI
ADK 包含內建介面,用於:
- 互動式測試代理行為
- 除錯工具呼叫和回應
- 評估代理效能
- 迭代代理設計
資源
- GitHub:https://github.com/google/adk-python
- 文件:https://google.github.io/adk-docs/
- llms.txt:https://raw.githubusercontent.com/google/adk-python/refs/heads/main/llms.txt
實作工作流程
在實作基於 ADK 的代理時:
- 定義需求:確定代理功能和所需的工具
- 選擇架構:單一代理、多代理或基於工作流程
- 選擇工具:預先建立好的、自訂函數或 OpenAPI 整合
- 實作代理:使用指令和工具建立代理定義
- 本地測試:使用開發者 UI 進行迭代
- 加入評估:建立測試案例以進行系統性驗證
- 部署:選擇 Cloud Run、Vertex AI 或自訂基礎架構
- 監控:追蹤代理效能並進行迭代
請記住:ADK 將代理開發視同傳統軟體工程——使用版本控制、撰寫測試,並遵循工程最佳實踐。