Skip to content

智能体可视化构建器

ADK 已支持Python v1.18.0实验性

ADK 可视化构建器 (Visual Builder) 是一个基于网页的强大工具，为创建和管理 ADK 智能体提供直观的可视化工作流设计环境。它允许你通过对初学者友好的图形界面（指点即所得）来设计、构建和测试智能体，并内置了一个 AI 驱动的开发助手，通过对话即可辅助你完成构建。

可视化智能体构建器

实验性阶段说明

可视化构建器目前处于实验性版本。我们非常期待听到你的使用反馈！

开始使用

可视化构建器是 ADK Web 工具界面的一部分。 请先确保你已安装了 ADK 库，然后在你的终端运行 ADK Web 服务：

adk web --port 8000
提示：请在你的项目开发目录下运行

可视化构建器会将项目文件写入运行 adk web 命令所在的目录。请确保该目录具有写入权限。

启动可视化构建器 图 1: ADK Web 界面中的可视化构建器入口。

如何创建一个智能体：

  1. 点击页面左上角的 + (加号) 图标（如图 1 所示）开始创建。
  2. 输入你的智能体应用名称，并点击 Create。
  3. 通过以下三个面板编辑你的智能体：
    • 左侧面板：直接编辑智能体组件的详细属性值。
    • 中央面板：直观添加或调整智能体组件及其拓扑结构。
    • 右侧面板：通过 AI 助手，使用提示词来修改智能体或获取即时帮助。
  4. 点击左下角的 Save 按钮保存你的工作成果。
  5. 在界面中直接与你的新智能体交互进行实时测试。
  6. 点击左上角的“铅笔”图标（如图 1 所示）随时继续编辑。

注意事项：

  • 及时保存：在退出编辑界面前请务必点击 Save，否则新创建的智能体可能无法正确持久化。
  • 编辑范围：目前“铅笔”编辑图标仅适用于通过可视化构建器创建的智能体，暂不支持反向编辑现有的纯代码智能体。
  • 工具绑定：将自定义工具添加到可视化构建器时，请务必填写完整的 Python 函数路径。

工作流组件支持

可视化构建器提供了拖放式的 UI 体验和 AI 辅助开发能力。它支持构建 ADK 智能体工作流中的所有关键组件：

高级功能限制

受限于 Agent Config 的底层限制，部分 ADK 高级特性可能暂不支持。详情请参阅已知局限性。

项目代码输出

可视化构建器基于 Agent Config 格式生成代码。它会自动为智能体生成 .yaml 配置文件，并为自定义工具生成 .py 文件。

生成的代码结构示例如下（以 DiceAgent 项目为例）：

DiceAgent/
    root_agent.yaml    # 主智能体配置
    sub_agent_1.yaml   # 子智能体配置 (如果有)
    tools/             # 工具源代码目录
        __init__.py
        dice_tool.py   # 自定义工具实现代码

后续代码编辑

你可以在 IDE 中直接打开并编辑这些生成的 YAML 和 Python 文件。但请注意，如果修改了可视化构建器不识别的高级语法，可能会导致构建器无法再次加载该项目。

下一步

由于内置了开发助手，你可以尝试输入以下提示词来构建一个简单的骰子智能体：

请帮我给当前的智能体添加一个掷骰子 (dice roll) 工具。
如果需要的话，请使用默认模型。

了解关于可视化智能体配置的更多详细选项：