SDK adk-python 谷歌Python智能体开发工具包

一、项目介绍

谷歌下场做 Agent 开发工具后，开发者有了官方的一手支持，但也面临选择：到底是直接用底层 SDK 拼，还是用现成的编排框架？很多团队想要一个既能快速起 Agent、又能把多个 Agent 编排成工作流、还带本地调试与评估的官方工具包。
Google ADK（Agent Development Kit）for Python 就是谷歌推出的智能体开发 SDK：它用两个核心类——Agent（定义指令、工具与行为）和 Workflow（把多个 Agent / 任务编排成图）——让你用极少的代码搭出单 Agent 或多 Agent 流程，并自带本地 CLI、Web UI 与评估能力。对想用 Python 紧跟谷歌生态做 Agent 的团队，它是正统一站式选择。

二、项目基本信息

三、核心优势

• 官方出品：谷歌维护，和多模态 / Gemini 生态贴合
• 双核心抽象：Agent + Workflow 覆盖单 / 多 Agent
• 本地调试：自带 CLI 与 Web UI，便于测试评估
• 可编排：图式工作流，把任务串成可复用流程
• 易部署：支持本地 Docker 与云端部署

四、适用场景

适合用 Python 构建 Agent、尤其想接入谷歌模型与生态的团队。需要既有单 Agent 快速原型、又能编排多 Agent 工作流的开发者尤为合适。

五、安装教程

当前最新版本 latest。按下方命令安装：

pip install google-adk
# 需 Python 3.11+；可选装扩展：
# pip install "google-adk[extensions]"

常见报错：依赖缺失时先升级对应运行环境（Node、Python、.NET、Go、Java、Rust、Bun、JDK）；网络超时多为镜像或代理问题，可重试或换源；Docker 相关命令需已安装并启动 Docker 服务；涉及 API Key 的服务请提前在环境变量或配置文件中填好。

六、使用示例

下面是一段可直接参考的真实示例：

from google.adk import Agent, Workflow

generate_fruit_agent = Agent(
    name="generate_fruit_agent",
    instruction="随机返回一个水果的名字，只返回名字。",
)
generate_benefit_agent = Agent(
    name="generate_benefit_agent",
    instruction="讲一条该水果的健康好处。",
)

root_agent = Workflow(
    name="root_agent",
    edges=[("START", generate_fruit_agent, generate_benefit_agent)],
)
# 本地运行：adk run path/to/agent  或  adk web path/to/agents_dir

七、常见问题

问：Python 版本要求？答：需要 Python 3.11 及以上。问：只能在谷歌云上跑吗？答：不必，本地 adk run / adk web 即可开发，也支持 Docker 与云端部署。

八、总结

adk-python 用清晰的设计，把把智能体开发做成官方工具包这件事从重复劳动变成了可复用、可维护的工程能力。它不追求大而全，而是把核心痛点解决得足够扎实，这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。