adk-python

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Python 环境（ADK 是 Python 工具包）
• 可用的 adk 命令行工具
• 一个包含智能体代码的 agent 文件夹
• Docker 环境（选 Docker 本地部署时需要）
• Google Cloud 项目与凭据（选 Cloud Run 部署时需要）

安装与启动步骤

1. 1准备 Python 环境

   ADK 是基于 Python 的代码优先框架，需先具备可运行的 Python 环境；README 的安装章节为空，具体安装步骤请以官方文档为准。

2. 2确认 adk 命令可用

   后续部署命令都通过 adk CLI 调用，需先完成 ADK 安装并保证终端能识别 adk 命令；README 未给出安装命令。

3. 3准备 agent 文件夹

   代码里用 Agent 定义指令、工具与行为，用 Workflow 编排多智能体流程；把相关 Python 文件放在一个文件夹内作为部署目标。

4. 4Docker 本地部署

   用 adk deploy docker 把 agent 打包进容器本地运行，加 --with_ui 会同时带上 ADK Web 界面，方便调试对话。

   adk deploy docker --with_ui my_agent

   复制

5. 5部署到 Google Cloud

   用 adk deploy cloud_run 把同一份 agent 直接发布到 Cloud Run，需事先配置好 Google Cloud 凭据与项目。

   adk deploy cloud_run --with_ui my_agent

   复制

6. 6传入环境变量

   环境变量既可以写在 adk 命令的 --env 参数里，也可以放到 .env 文件中，示例为启用企业版 Gemini。

   adk deploy cloud_run --with_ui --env GOOGLE_GENAI_USE_ENTERPRISE=1 my_agent

   复制

关键配置

如何确认成功

README 未给出明确成功标志；命令执行无报错后，可按官方文档访问 --with_ui 提供的 ADK Web 界面或部署输出中的服务地址确认。

常见问题

注意事项

• ADK 2.0 对 agent API、事件模型和会话 schema 有不兼容变更，从 1.x 升级需先做迁移评估。
• README 的 Installation 与 Quick Start 章节内容为空，安装与本地运行的完整步骤请查阅官方文档。
• 部署命令中的 agent 文件夹为占位位置，执行前必须替换成自己的真实目录。
• ADK 虽针对 Gemini 优化，但官方说明其模型无关、部署无关，也可与其他框架配合使用。