adk-python

Agent Development Kit (ADK) 是一个开源的、代码优先的 Python 框架，用于构建、评估和部署 AI 智能体。它将软件开发原则应用于智能体创建，旨在简化从简单任务到复杂系统的智能体工作流的构建、部署和编排。它针对 Gemini 进行了优化，但被描述为模型无关、部署无关，并与其他框架兼容。 README 中描述的关键能力： - 工作流运行时：一个基于图的执行引擎，用于组合确定性执行流，支持路由、扇出/扇入、循环、重试、状态管理、动态节点、人工参与和嵌套工作流。 - 任务 API：结构化的智能体间委派，支持多轮任务模式、单轮受控输出、混合委派模式以及作为工作流节点的任务智能体。 - 模块化多智能体系统：将专业智能体组合成层次结构。 - 工具生态：预构建工具、自定义函数、OpenAPI 规范、MCP 工具以及与现有工具的集成。 - 代码优先开发：用 Python 定义智能体逻辑、工具和编排。 - 智能体配置：无需代码即可构建智能体。 - 工具确认 (HITL)：通过显式确认和自定义输入来保护工具执行。 - 部署：容器化并部署到 Cloud Run 或 Vertex AI Agent Engine。 通过 pip (google-adk) 安装，需要 Python 3.10+。可选集成可通过 extensions extra 获得。可以从主分支安装开发版本。README 指出大约每两周发布一次。 快速入门示例展示了具有名称、模型和指令的 Agent 类，以及通过边连接智能体的 Workflow 类。支持通过交互式 CLI (adk run) 和 Web UI (adk web) 进行本地运行。提供了一个捆绑的开发 UI，用于测试、评估、调试和展示智能体。可以使用 adk eval 命令针对 evalset 和配置文件运行评估。部署命令包括 adk deploy docker 和 adk deploy cloud_run，环境变量可通过命令行或 .env 文件配置。 文档、指南和可运行示例已链接，还有贡献指南和用于社区贡献的工具、集成和部署脚本的社区仓库。该项目还提供 llms.txt 和 llms-full.txt 文件，旨在作为 LLM 辅助开发的上下文。ADK 已有 Java、Kotlin、Go 和 TypeScript 版本。该项目采用 Apache 2.0 许可证。