Skip to content

智能体可视化构建器

Supported in ADKPython v1.18.0Experimental

ADK 可视化构建器是一个基于网页的工具，为创建和管理 ADK 智能体提供可视化工作流设计环境。它允许你在初学者友好的图形界面中设计、构建和测试智能体，并包含一个 AI 驱动的助手来帮助你构建智能体。

Visual Agent Builder

实验性

可视化构建器功能是实验性版本。我们欢迎你的反馈!

开始使用

可视化构建器界面是 ADK Web 工具用户界面的一部分。确保你已安装 ADK 库，然后运行 ADK Web 用户界面。

adk web --port 8000
提示：从代码开发目录运行

可视化构建器工具将项目文件写入位于运行 ADK Web 工具的目录中的新子目录。确保从具有写入权限的开发者目录位置运行此命令。

Visual Agent Builder start 图 1: 启动可视化构建器工具的 ADK Web 控件。

要使用可视化构建器创建智能体：

  1. 在页面左上角，选择 +(加号),如图 1 所示，开始创建智能体。
  2. 为你的智能体应用程序输入名称并选择 Create。
  3. 通过执行以下任一操作来编辑你的智能体：
    • 在左侧面板中，编辑智能体组件值。
    • 在中央面板中，添加新的智能体组件。
    • 在右侧面板中，使用提示修改智能体或获取帮助。
  4. 在左下角，选择 Save 以保存你的智能体。
  5. 与你的新智能体交互以测试它。
  6. 在页面左上角，选择铅笔图标，如图 1 所示，继续编辑你的智能体。

使用可视化构建器时需要注意以下几点：

  • 创建智能体并保存： 创建智能体时，请确保在退出编辑界面之前选择 Save,否则你的新智能体可能无法编辑。
  • 智能体编辑： 编辑 (铅笔图标)仅适用于使用可视化构建器创建的智能体
  • 添加工具： 将现有自定义工具添加到可视化构建器智能体时，请指定完全限定的 Python 函数名称。

工作流组件支持

可视化构建器工具提供了一个拖放用户界面来构建智能体，以及一个可以回答问题和编辑智能体工作流的 AI 驱动开发助手。该工具支持构建 ADK 智能体工作流的所有基本组件，包括：

  • 智能体
    • 根智能体: 工作流的主要控制智能体。ADK 智能体工作流中的所有其他智能体都被视为子智能体。
    • LLM 智能体：由生成式 AI 模型驱动的智能体。
    • 顺序智能体：按顺序执行一系列子智能体的工作流智能体。
    • 循环智能体：重复执行子智能体直到满足特定条件的工作流智能体。
    • 并行智能体：并发执行多个子智能体的工作流智能体。
  • 工具
  • 组件
    • 回调：一个流程控制组件，允许你在智能体工作流事件的开始和结束时修改智能体的行为。

由于智能体配置功能的限制，可视化构建器不支持某些高级 ADK 功能。有关更多信息，请参阅智能体配置已知限制。

项目代码输出

可视化构建器工具以智能体配置格式生成代码，使用 .yaml 配置文件用于智能体，使用 Python 代码用于自定义工具。这些文件在你运行 ADK Web 界面的目录的子文件夹中生成。以下列表显示了 DiceAgent 项目的示例布局：

DiceAgent/
    root_agent.yaml    # 主智能体代码
    sub_agent_1.yaml   # 子智能体(如果有)
    tools/             # 工具目录
        __init__.py
        dice_tool.py   # 工具代码

编辑生成的智能体

你可以在开发环境中编辑生成的文件。但是,某些更改可能与可视化构建器不兼容。

下一步

使用可视化构建器开发助手，尝试使用以下提示构建新智能体：

Help me add a dice roll tool to my current agent.
Use the default model if you need to configure that.

查看有关可视化构建器使用的智能体配置代码格式和可用选项的更多信息：