ADK速查表

使用本技能前，请先激活

/google-agents-cli-workflow

——它包含所需的开发阶段和脚手架步骤。

前置条件

1. 运行

   agents-cli info

   ——如果显示项目配置，直接跳至下方速查表
2. 若无项目存在：运行

   agents-cli scaffold create <name>

3. 若用户已有代码：运行

   agents-cli scaffold enhance .

目前仅支持Python。本速查表当前覆盖Python ADK SDK。 其他语言的支持即将推出。

快速参考——最常用模式

Agent创建

from google.adk.agents import Agent

root_agent = Agent(
    name="my_agent",
    model="gemini-flash-latest",
    instruction="You are a helpful assistant that ...",
    tools=[my_tool],
)

除非用户明确要求，否则绝不要修改现有Agent的

model=

值。如果Gemini模型返回404错误，几乎都是

GOOGLE_CLOUD_LOCATION

问题——在修改任何内容前，先运行列表命令验证可用性。如需模型文档，请获取

https://adk.dev/agents/models/google-gemini/index.md

。

bash

uv run --with google-genai python -c "
from google import genai
client = genai.Client(vertexai=True, location='global')
for m in client.models.list(): print(m.name)
"

基础工具

from google.adk.tools import FunctionTool

def get_weather(city: str) -> dict:
    """Get current weather for a city."""
    return {"city": city, "temp": "22°C", "condition": "sunny"}

weather_tool = FunctionTool(func=get_weather)

ADK内置工具导入方式：导入工具实例，而非模块。

python

from google.adk.tools.load_web_page import load_web_page  # 正确
from google.adk.tools import load_web_page                 # 错误

简单回调

from google.adk.agents.callback_context import CallbackContext

async def initialize_state(callback_context: CallbackContext) -> None:
    state = callback_context.state
    if "history" not in state:
        state["history"] = []

root_agent = Agent(
    name="my_agent",
    model="gemini-flash-latest",
    instruction="...",
    before_agent_callback=initialize_state,
)

参考文件

references/adk-python.md

references/adk-2.0.md

ADK 2.0工作流——需手动启用

Workflow API为实验性预GA版本（ADK 2.0）。默认不推荐使用。

在推荐工作流模式前，请向用户解释以下内容并询问是否要继续：

1. 是什么：ADK 2.0引入基于图的Workflow API——节点（函数、LLM agents、工具）通过带有条件路由、扇出/扇入并行处理和人机交互中断的边连接。
2. 适用场景：需要确定性控制流、列表项并行处理、结构化审批 gate 或重试逻辑的复杂多步骤流水线——即SequentialAgent/ParallelAgent/LoopAgent无法满足需求的场景。
3. 风险：预GA版本——API在正式发布前可能会变更。需要

   google-adk >= 2.0.0

   和Python >= 3.11。与Live Streaming不兼容。脚手架项目升级前需要修改

   pyproject.toml

   ——请查看参考文件获取分步说明。

仅在用户明确同意后，才可查阅

references/adk-2.0.md

。若用户拒绝或不确定，请使用

references/adk-python.md

中的标准ADK 1.x编排模式（SequentialAgent、ParallelAgent、LoopAgent、BaseAgent）。

ADK文档

curl https://adk.dev/llms.txt

相关技能

• /google-agents-cli-workflow

  ——开发工作流、编码指南和操作规则

• /google-agents-cli-scaffold

  ——使用

  agents-cli scaffold create

  /

  scaffold enhance

  创建和优化项目

• /google-agents-cli-eval

  ——评估方法、评估集 schema 和 eval-fix循环

• /google-agents-cli-deploy

  ——部署目标、CI/CD流水线和生产工作流