Agent Development Kit (ADK)

项目简介

Agent Development Kit (ADK) 是一个开源、代码优先的 Python 框架，用于构建、评估和部署复杂的 AI 智能体。它将软件开发原则应用于 AI 智能体创建，旨在简化从简单任务到复杂系统的智能体工作流构建、部署与编排。ADK 针对 Gemini 优化，但模型无关、部署无关，并与其他框架兼容。

核心功能

• 工作流运行时：基于图的执行引擎，用于为智能体应用组合确定性执行流，支持路由、扇出/扇入、循环、重试、状态管理、动态节点、人在回路和嵌套工作流。任务 API：结构化的智能体到智能体委派，支持多轮任务模式、单轮受控输出、混合委派模式、人在回路，以及将任务智能体作为工作流节点。模块化多智能体系统：通过将多个专用智能体组合为灵活层次结构来设计可扩展应用。丰富工具生态：使用预构建工具、自定义函数、OpenAPI 规范、MCP 工具或集成现有工具，为智能体提供多样化能力。代码优先开发：直接在 Python

适用场景

• 以灵活性和控制力构建、评估和部署复杂的 AI 智能体。通过将专用智能体组合为灵活层次结构来创建模块化多智能体系统。使用路由、循环、重试、状态和人在回路来编排从简单任务到复杂系统的智能体工作流。通过交互式 CLI、Web UI 和附带的评估示例进行本地开发与评估。

快速开始

• 使用 pip install google-adk 安装最新稳定版；需要 Python 3.10+。为防范传递依赖问题，建议使用适用于 Python 3.10 至 3.14 的配套约束文件进行安装。定义包含名称、模型和指令的 Agent，并定义包含边以编排智能体的 Workflow。使用 adk run path/to/my_agent 在本地运行，或使用 adk web path/to/agents_dir 运行 Web UI。可选集成可通过 pip install google-adk[extensions] 安装。

部署与要求

• 需要 Python 3.10+。可通过 adk deploy docker --with_ui 将智能体部署到本地 Docker 容器。可通过 adk deploy cloud_run --with_ui 将智能体部署到 Google Cloud 的 Cloud Run。可在 adk 命令或 .env 文件中设置环境变量，例如 GOOGLE_GENAI_USE_ENTERPRISE=1。Vertex AI Agent Engine 被提及为扩展选项。

采用前须知

• 许可证：Apache-2.0。在使用、修改或分发项目前，请确认其具体条款。