google-agents-cli-adk-code
熱門此技能應在使用者想要「撰寫代理程式碼」、「使用 ADK 建構代理程式」、「新增工具」、「建立回呼」、「定義代理程式」、「使用狀態管理」，或需要 ADK（Agent Development Kit）Python API 模式與程式碼範例時使用。屬於 Google ADK 技能套件的一部分。提供代理程式類型、工具定義、編排模式、回呼與狀態管理的快速參考。請勿用於建立新專案（請使用 google-agents-cli-scaffold）或部署（請使用 google-agents-cli-deploy）。
This skill should be used when the user wants to "write agent code", "build an agent with ADK", "add a tool", "create a callback", "define an agent", "use state management", or needs ADK (Agent Development Kit) Python API patterns and code examples. Part of the Google ADK skills suite. It provides a quick reference for agent types, tool definitions, orchestration patterns, callbacks, and state management. Do NOT use for creating new projects (use google-agents-cli-scaffold) or deployment (use google-agents-cli-deploy).
ADK 程式碼參考
使用此技能前，請先啟用
/google-agents-cli-workflow— 其中包含必要的開發階段與 scaffolding 步驟。
前置需求
- 執行
agents-cli info— 若顯示專案設定，請直接跳到下方參考 - 若無專案存在：執行
agents-cli scaffold create <name> - 若使用者已有現有程式碼：執行
agents-cli scaffold enhance .
在專案 scaffolding 完成之前，請勿撰寫代理程式碼。
目前僅支援 Python。 此參考目前涵蓋 Python ADK SDK。
其他語言的支援即將推出。
快速參考 — 最常見模式
from google.adk.agents import Agent
def get_weather(city: str) -> dict:
"""取得指定城市的天氣。"""
return {"city": city, "temp": "22°C", "condition": "sunny"}
root_agent = Agent(
name="my_agent",
model="gemini-flash-latest",
instruction="你是一個樂於助人的助手，負責...",
tools=[get_weather],
)
參考資料
前兩項是常見模式的速查表；如需廣泛或深入的知識，請參閱原始來源（文件索引或已安裝套件）。
| 參考資料 | 何時閱讀 |
|---|---|
references/adk-python.md |
核心 ADK API：Agent、工具、回呼、外掛、狀態、成品、多代理系統、SequentialAgent / ParallelAgent / LoopAgent、自訂 BaseAgent。大多數代理程式的預設參考。 |
references/adk-workflows.md |
基於圖形的工作流程 API（ADK 2.0）：節點、邊、扇出/扇入、HITL、平行處理。當需要明確的圖形拓撲時使用。 |
curl https://adk.dev/llms.txt |
文件索引（每個頁面標題 + URL）。先擷取該檔案，再使用 WebFetch 取得特定頁面以取得速查表以外的內容。 |
| 已安裝的 ADK 套件 | 確切的簽章與符號 — 檢查原始碼（請參閱 references/adk-python.md 中的「檢查 ADK 原始碼」）。 |
相關技能
/google-agents-cli-workflow— 開發工作流程、編碼準則與操作規則/google-agents-cli-scaffold— 使用agents-cli scaffold create/scaffold enhance建立與增強專案/google-agents-cli-eval— 評估方法、資料集結構與評估修正循環/google-agents-cli-deploy— 部署目標、CI/CD 管線與生產工作流程
