使用可视化构建器¶
ADK 可视化构建器是 ADK Web 界面的一项功能，提供了一个用于创建和管理智能体的可视化工作流设计环境。可视化构建器允许你在初学者友好的图形界面中设计、构建和测试智能体，并包含一个 AI 驱动的助手来帮助你构建智能体。
实验性
可视化构建器功能是一个实验性版本。我们欢迎你的反馈！
创建智能体¶
要使用可视化构建器，请启动 ADK Web 界面：
然后按照以下步骤创建智能体。
提示：从代码开发目录运行
可视化构建器工具将项目文件写入运行 ADK Web 的目录下的新子目录中。确保你从具有写入权限的开发人员目录位置运行此命令。
如何创建一个智能体：¶
- 点击页面左上角的 + (加号) 图标（如图 1 所示）开始创建。
- 输入你的智能体应用名称，并点击 Create。
- 通过以下三个面板编辑你的智能体：
- 左侧面板：直接编辑智能体组件的详细属性值。
- 中央面板：直观添加或调整智能体组件及其拓扑结构。
- 右侧面板：通过 AI 助手，使用提示词来修改智能体或获取即时帮助。
- 点击左下角的 Save 按钮保存你的工作成果。
- 在界面中直接与你的新智能体交互进行实时测试。
-
点击左上角的“铅笔”图标（如图 1 所示）随时继续编辑。
-
In top left of the page, select the + (plus sign), as shown in Figure 1, to start creating an agent.
- Type a name for your agent application and select Create.
- Edit your agent by doing any of the following:
- In the left panel, edit agent component values.
- In the central panel, add new agent components.
- In the right panel, use prompts to modify the agent or get help.
- In bottom left corner, select Save to save your agent.
- Interact with your new agent to test it.
- In top left of the page, select the pencil icon, as shown in Figure 1, to continue editing your agent.
使用可视化构建器时需要注意以下几点：
尝试在可视化构建器助手中使用以下提示
支持的组件¶
可视化构建器工具提供了一个拖放式用户界面来构建智能体，以及一个 AI 驱动的开发助手，可以回答问题并编辑你的智能体工作流。该工具支持构建 ADK 智能体工作流所需的所有基本组件，包括：
- 智能体
- 根智能体 (Root Agent): 工作流的主要控制智能体。ADK 智能体工作流中的所有其他智能体都被视为子智能体。
- LLM 智能体： 由生成式 AI 模型驱动的智能体。
- 顺序智能体(Sequential Agent)： 按顺序执行一系列子智能体的工作流智能体。
- 循环智能体(Loop Agent)： 重复执行子智能体直到满足某个条件的工作流智能体。
- 并行智能体(Parallel Agent)： 同时执行多个子智能体的工作流智能体。
- 工具
- 组件
- 回调 一个流程控制组件，允许你在智能体工作流事件的开始和结束时修改智能体的行为。
由于 Agent Config 功能的限制，可视化构建器不支持某些高级 ADK 功能。有关更多信息，请参阅 Agent Config 已知限制。
生成的项目结构¶
可视化构建器工具以 Agent Config 格式生成代码，使用 .yaml 配置文件用于智能体，使用 Python 代码用于自定义工具。这些文件生成在你运行 ADK Web 界面的目录的子文件夹中。以下列表显示了 DiceAgent 项目的示例布局：
DiceAgent/
root_agent.yaml # 主智能体配置
sub_agent_1.yaml # 子智能体配置 (如果有)
tools/ # 工具源代码目录
__init__.py
dice_tool.py # 自定义工具实现代码
后续代码编辑
你可以在 IDE 中直接打开并编辑这些生成的 YAML 和 Python 文件。但请注意，如果修改了可视化构建器不识别的高级语法，可能会导致构建器无法再次加载该项目。
下一步¶
有关可视化构建器使用的 Agent Config 代码格式的更多信息，请参阅 Agent Config 和 Agent Config YAML 模式。