Google ADK 可视化代理构建器教程与演示项目：旅行规划器

Google 的 ADK 可视化代理构建器是一个上手型工具包，可用于设计、连接并运行多代理工作流，无需您亲自搭建整条管线。它将基于提示的代理构建器与 ADK CLI、Gemini 模型和内置工具配套，让您把自然语言需求快速变成可运行的代理。

在本教程中，我将带您使用 Google 的 Agent Development Kit（ADK）可视化代理构建器，搭建一个可用的旅行规划器。您将学会：

• 启动可视化构建器并连接各代理
• 用自然语言指令自动生成子代理和工具
• 添加网页搜索、简单打分和追踪能力
• 测试并调试您的代理

完成后，您将得到一个代理：它会询问您的城市/日期/预算，并并行运行三个工人代理（机票、住宿、活动），最后返回一到两个清晰的行程选项。

如果您刚接触代理式 AI，建议先学习AI Agent Fundamentals 技能路径。您也可以查看《使用 Google ADK 构建 AI 代理》课程。

什么是 Google ADK 可视化代理构建器？

Google 的 ADK 可视化代理构建器是一个用于设计由Gemini 驱动的多代理工作流的画布。您向一个 AI 助理描述意图，它会提出并实体化完整的代理架构，将其呈现在可视化画布上，并允许您立即在聊天中测试。

之后，您可以检查追踪记录，准备就绪时还能导出可用于生产的YAML 文件。

以下是该代理构建器的一些关键要点：

• LLM 代理：每个节点将提示与模型配对，并可选接入工具。例如，您可以同时使用一个推理代理（Gemini 2.5 Pro 或 Gemini 3 Pro）和一个快速搜索代理（Gemini 2.5 Flash）。
• 编排代理：循环、并行或顺序节点用于在根代理的指令下协调子 LLM 代理的运行方式。
• 工具：内置工具如 google_search，以及函数工具和文件/上下文工具（如 url_context 和 FilesRetrieval），让代理能够轻松组合多种实用组件。
• 回调与追踪：实时的事件与追踪视图展示了运行的代理及其输入/输出，便于您逐步调试推理过程与工具调用。

ADK 负责处理模型调用、工具集成和状态传递，让您专注于行为设计。

ADK 可视化代理构建器演示：构建旅行规划器代理工作流

本节我们将使用 Google 的 ADK 可视化代理构建器搭建旅行规划器。该工作流使用一个根 LLM 代理和一个并行代理，分别调用机票、住宿和活动三位代理，然后将结果整合为清晰可执行的行程选项。

其工作方式如下：

• 出行意图：输入预期行程，包括城市、日期、预算及必须/避开偏好。
• 并行调研：并行代理进行以下调研：
• 机票代理提出可行航段，包括时间、经停、总时长和费用。
• 住宿代理为每个城市给出 1–2 个住宿选项。
• 活动代理为每个城市草拟 2–3 个活动建议。
• 整合与排序：根代理比较成本、总行程时间、偏好契合度等权衡因素，返回最多两个选项，附优劣分析，并对推荐方案给出逐日安排。
• 追踪与迭代：您可在追踪视图中查看各子代理的触发过程，并通过追问进一步完善。

最终，您将拥有一个多代理工作流，把一段普通英语的旅行想法转化为具体且关注预算的行程，并给出透明的推理。

步骤 1：安装 Google ADK

在设计代理之前，我们需要 ADK CLI。它是启动可视化代理构建器并运行本地网页界面的命令行工具。

pip install --upgrade google-adk
adk --version技术支持

上述代码应返回 adk, version 1.18.0。它首先获取最新的 ADK 包及其依赖项。--upgrade 标志可确保您不会停留在缺少本教程所用可视化代理构建器功能的旧版 CLI 上。

最后，我们验证安装是否成功以及 shell 是否能找到 adk 可执行文件。

安装并验证 ADK 后，我们就可以启动可视化代理构建器并创建旅行规划器工作流。下一步，我们将设置您的 API 密钥并打开本地界面，开始以可视方式组装代理。

步骤 2：设置 Google API 密钥

首先打开 Google AI Studio，在左下角点击 Get API Key。然后选择 Create API Key 并为您的密钥命名。请注意，您需要创建一个新的 Google Cloud 项目，或使用已启用计费的现有项目。完成后，返回 Google AI Studio，复制 API Key，并在您的工作目录中将其设置为环境变量。

export GOOGLE_API_KEY=YOUR_API_KEY —-> for macOS/Linux
setx GOOGLE_API_KEY "YOUR_KEY" —-> for Windows (PowerShell)技术支持

重启终端以使更改生效。

您也可以选择克隆一个入门仓库，其中包含现成项目可供试用，并已为您配置好所有依赖：

git clone https://github.com/thomas-chong/google-adk-visual-agent-builder-demo.git
cd google-adk-visual-agent-builder-demo技术支持

上述命令会克隆一个包含入门研究代理演示的仓库。现在我们已经安装了 ADK，接下来启动网页界面。

步骤 3：启动网页界面

设置好 API 密钥并安装 ADK 后，您就可以打开可视化代理构建器了。运行以下命令启动本地开发 UI 服务器。

adk web技术支持

默认情况下，它会在 http://127.0.0.1:8000 启动。请在浏览器中打开。

初始界面如下：

点击 + 按钮创建新代理，将其命名为 Travel_Agent，您将进入三栏构建界面：配置（左）、画布（中）和 助理/聊天（右）。

首先，我在聊天中向 Gemini 发送了一个提示以自动构建代理，类似您使用OpenAI 的 AgentKit 来构建工作流的方式。

Create a Travel Ops planner agent. Given user input (ordered cities, dates, budget, must/avoid prefs), run three workers in parallel—Flights, Stays, Activities—(use google_search where helpful). 
Recommend up to 2 options. Prioritize stated preferences; if options are close, prefer lower cost and less total travel time. 
Clearly explain the trade-offs. If options are nearly identical, return one best option and say why. 
For each option, return text-only bullets: Cost (USD), Total travel time (h), Preference-fit (0–1), Pros/Cons (cost, time, experience), and a brief day-by-day (give the full day-by-day only for the recommended option). 
Defaults: prices in USD, time in hours, max 2 options. Ask at most 2 clarifying questions; if data is thin, return a degraded single option with a warning. 
Avoid fake booking links; provide sensible estimates and caveats.技术支持

出乎意料的是，Google ADK 在为特定任务分配模型或子代理时相当高效。Gemini 完成代码草拟并写入各个代理文件后，会将指令注入您的代理，自动添加合适的子代理和工具。

以下是它根据我的提示生成的端到端管线。

这是 Gemini 处理提示后，应用了指令、接好工具、添加了子代理并填写了代理描述的构建器界面。

最后，点击保存，您的代理就绪。这会带您进入聊天界面，我在这里向代理提出了几个旅行问题。

一开始，我这样询问代理：

I want to travel from New York to Dubai for New Year’s for a week long vacation. Help me plan my trip within a budget of $1000技术支持

在下方视频中，您可以看到代理的响应：