在 Studio Web 中构建智能体

本节将为您逐步介绍如何在 Studio Web 中构建智能体。为了构建可靠的生产级智能体，我们强烈建议您查看最佳实践。

探索智能体工作区

使用 Studio Web 设计器主画布设计智能体，并使用左右面板探索智能体的结构与资源。

选择画布类型

您可以使用两种不同视图设计智能体：表单和流。

• 流是一个可视化画布。它的特点是基于节点的拖放可视化，其中每个组件（模型、提示词、上下文、工具或升级）都以画布上的节点表示。此视图非常适合更喜欢以图形化探索性方法设计智能体的用户，使他们能够通过直接操纵可视化元素来构建、调试和优化逻辑。
• 表单是 Studio Web 基于表单的标准体验。它提供基于表单的结构化创作体验，智能体的每个组件都通过专用面板和输入字段配置。此视图非常适合更喜欢表格或配置驱动智能体设计的用户，可以分步进行设置、验证和测试，无需依赖可视化图表。

在表单和流模式之间切换，两种体验之间可无损同步。在表单中编辑的任何属性都会立即反映在流视图中，反之亦然。

流视图

流画布围绕四个主要区域构建：

• 中央画布 – 智能体逻辑表示为已连接节点的主要设计表面。此画布支持复杂智能体的缩放、平移和迷你地图导航。
• 左侧面板 – 提供对“项目资源管理器”、“数据管理器”、“错误”和“部署配置”面板的访问权限，与基于表单的界面一致。
• 右侧面板 – 显示“属性”和“开发”选项卡，使用户可以编辑节点属性或运行快速调试测试。
• 底部面板 – 显示“执行追踪”、“历史记录”和“评估”，并在设计时调试期间集成实时追踪数据。

流画布上的节点类型

画布上的每个节点都表示智能体定义中的逻辑组件：

• Agent node – Define the system and user prompts and expose the schema (input/output arguments) in the Data Manager. Configure the model, temperature, and token settings.
• 上下文节点 – 链接上下文基础索引，允许配置查询策略、阈值和检索限制。
• 工具节点 – 将已连接的自动化、活动或其他智能体可视化。每个工具节点都可以展开，以显示输入/输出架构、护栏和模拟选项。
• 升级节点 – 表示人机回圈机制和记忆链接。选择它们会打开“升级配置”面板，其中包含任务接收人和结果。
  
  

  

  
  

在“流”视图中调试

在调试期间，流画布提供实时可视化反馈：

• 追踪流：当智能体在设计阶段运行时，追踪范围会直接显示在画布上，节点在智能体循环中被激活时会亮起。

• 对话智能体：在调试对话智能体时，会通过一个持久的聊天窗口让用户与智能体交换消息。每条消息都会触发调试运行。
• 断点：您可以通过设置断点，暂停智能体在特定节点上的执行。到达断点时，智能体会在执行该节点之前停止，以便您检查其输入、输出和追踪数据。

表单视图

“表单”视图提供了一个基于面板的结构化工作区，用于通过引导输入构建和配置智能体。它提供了清晰的分步布局，适用于智能体组件的精确配置和验证。

布局概述

• Agent definition form: Displays the agent definition and its core components, Prompts, Tools, Contexts, and Escalations, organized in a linear, form-based structure.
• 左侧面板：包括“项目资源管理器”、“数据管理器”、“错误”和“部署配置”面板，用于导航和管理项目资源。
• 右侧面板：包含“属性”和“开发”选项卡，用于编辑组件设置、运行快速测试以及查看设计时追踪记录。
• 底部面板：显示“执行追踪”、“历史记录”和“评估”，实时显示调试结果和评估指标。

智能体配置

表单的每个部分都与一个主要的智能体组件对应：

• 提示词：定义指导智能体行为的系统和用户指令。

• 工具：添加和配置自动化、Integration Service 活动或智能体在执行期间可以调用的其他智能体。

• 上下文：连接上下文基础索引，为推理提供相关数据。

• 升级：设置人机回圈操作，并在必要时启用“智能体记忆”。

  Figure 1. The form view
  

  

  
  

在“表单”视图中调试

在“表单”视图中测试智能体时，您可以直接从工具栏运行调试会话，以验证逻辑和输出。设计时追踪记录将显示在“执行追踪”面板中，显示每次运行的输入、输出和任何错误。对于对话智能体，您可以通过集成的聊天窗口交换消息并实时观察响应。

使用 Studio Web 面板

左侧面板会为您显示智能体的结构，包括：

• 项目资源管理器 – 组织和构建智能体。定义提示词、工具、上下文、升级等。
• 数据管理器 – 定义输入和输出参数。
• 错误面板 – 查看设计时问题、配置中断或失败的试运行。
• 部署配置面板 – 设置发布和运行智能体的环境特定配置。

右侧面板包括：

• 属性面板，分为以下几种：
  • 属性选项卡 – 配置智能体级别和组件级别的设置。
  • 开发选项卡 - 运行测试输入、调试并检查设计时追踪。
• 智能体评分（预览）– 根据评估结果和测试覆盖范围查看智能体的就绪状况。
• 运行输出面板 – 查看最近的试运行结果。
• Autopilot（预览）– 获取由 AI 驱动的建议，用于优化提示、工具和智能体设置。

图 2. Agents 工作区

底部面板将历史记录、结果和实时追踪记录保存在一个位置，使评估成为设计体验的核心部分。可用选项卡取决于您正在构建的智能体类型：

• 对于自主智能体，底部面板包含：
  • 执行追踪记录 – 显示当前运行的追踪细节。 执行智能体时，此选项卡会自动打开，以便您同步监测实时追踪。
  • 历史记录 – 显示所有智能体运行以及执行追踪记录和详细信息。 在这里，您可以直接将运行添加到评估集中。
  • 评估 – 列出所有评估集，显示最近的分数。 展开评估集即可了解评估结果、查看详细信息，或单独或完整运行测试。
• 对于对话智能体，底部面板包含：
  • 聊天 – 替换“执行追踪”选项卡。 提供交互式聊天窗口，以测试与智能体的对话，同时还显示每次交换的执行记录。
  • 历史记录 – 显示所有对话运行以及执行追踪记录和详细信息。 在这里，您可以直接将运行添加到评估集中。
  • 评估 – 列出所有评估集，显示最近的分数。 展开评估集即可了解评估结果、查看详细信息，或单独或完整运行测试。