在 Studio Web 中构建智能体

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

探索智能体工作区

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

创建智能体

1. 转到Studio.uipath.com 。
2. 选择“新建”按钮，然后选择“智能体”。
3. 选择智能体类型：
   • 自主：创建一个能够独立运行以完成给定任务的智能体。
   • 对话（预览版）：创建通过实时对话与用户交互的助手。
4. 如果您想从头开始创建智能体，请选择“从头开始”。
5. 如果您想使用 Autopilot（预览）生成智能体，请在可用消息框中描述您希望创建的智能体，然后选择“生成智能体”。内容请尽可能具体，以便 Autopilot 高效地生成智能体。
6. 这会打开一个新解决方案，并显示智能体设计器画布。

7. 配置智能体时，您可以在两种设计模式之间进行选择：传统的“表单”视图和“流程”视图（预览）。两种模式共享相同的基础智能体定义并保持完全同步，因此您可以随时在这之间切换，而不会丢失数据。

   使用“表单”视图以获得结构化的分步配置体验，或者切换到“流程”视图以获得基于节点的可视布局，以便查看智能体组件的连接和交互方式。

配置智能体

配置智能体时，您可以在两种设计模式之间进行选择：传统的“表单”视图和“流程”视图（预览）。两种模式共享相同的基础智能体定义并保持完全同步，因此您可以随时在这之间切换，而不会丢失数据。

使用“表单”视图以获得结构化的分步配置体验，或者切换到“流程”视图以获得基于节点的可视布局，以便查看智能体组件的连接和交互方式。

使用表单视图构建智能体（默认）

1. 从左侧的项目资源管理器面板访问智能体定义、评估集以及评估程序。
   图 1. 解决方案中的智能体
   

   

   
   
   1. 在定义面板中，您可以设计和定义智能体的核心元素。定义包括以下部分：常规、工具、上下文和升级。
      • 使用常规部分为您的智能体定义提示词。
      • 使用“工具”部分连接 runtime 工具，例如 Integration Service 连接器或已发布的自动化。
      • 使用上下文部分，通过上下文锚定索引链接知识源，为您的智能体提供相关数据的访问权限。
      • 使用升级部分设置人机回圈备份，并启用智能体记忆，以保留交互，帮助校准未来的智能体升级。
   2. 在评估集面板中，您可以创建评估和存储结果。评估旨在客观衡量智能体的输出，并评估其是否符合您的目标。有关详细信息，请参阅评估。
   3. 在评估程序面板中，您可以创建和管理评估中使用的评估程序。
2. 第一步，在“项目资源管理器”下选择您的智能体。右键点击“重命名”，并为您的智能体提供唯一名称。智能体名称有助于在各个项目中识别智能体。
3. 接下来，从右侧菜单中访问属性面板，选择您想要用于智能体的大语言模型。
   1. 从下拉列表中选择型号。模型通过 UiPath AI Trust Layer 配置。有关详细信息，请参阅“配置 LLM”。
   2. 配置温度和最高温度每个响应字段的令牌数量。这些设置可能由 Automation Ops 监管策略控制。有关详细信息，请参阅Studio Web 策略设置。
   • 温度决定了 LLM 生成的创造力系数。可以设置 0（精确）和 1（创意）之间的值。
   • 每次响应的最大令牌数是指智能体做出响应时生成的最大令牌数。
   图 2.配置模型设置
   

   

   
   
4. 在智能体“定义”面板中，为您的智能体提供“系统提示”和“用户提示”。添加结构合理的提示，就智能体应执行的操作以及应遵守的约束条件给出指令。有关详细信息，请参阅“提示”。
5. 使用数据管理器面板定义提示词中使用的智能体输入和输出参数。
   图 3. “数据管理器”面板中的输入参数
   

   

   
   
6. 在“工具”部分中，选择“添加工具” ，添加智能体在执行过程中可以使用的任何工具。这些工具可以是一组 Integration Service 活动、现有智能体以及您有权访问的已发布自动化。每个工具都必须有详细描述，以告知智能体如何以及何时使用此工具。有关详细信息，请参阅工具。
7. （可选）在“上下文”部分中，选择“添加上下文”，授予智能体访问上下文锚定索引的权限。选择租户中可用的现有索引，或选择“新建”，直接在 Orchestrator 中创建新索引。有关详细信息，请参阅“上下文”。
8. （可选）在“升级”部分中，选择“添加升级”，以通过升级应用程序添加人机回圈，然后启用“智能体记忆”。添加升级后，您的智能体可以在运行时让人员审核、批准或更新输出。有关详细信息，请参阅“升级和智能体记忆”。

使用流程视图（预览版）构建智能体

1. 在 Studio Web 中打开您的智能体项目。
2. 在设计时画布右上角，从创作模式开关中选择“流程（预览）”选项。

   • 流程画布随即打开，并将智能体结构显示为节点。

   • 您可以随时切换回表单视图。所有更改都会在两种模式之间自动保存和转换。

3. 从LLM 节点开始。
   • 选择它以打开右侧的“属性”面板，然后选择并配置您的模型。
     • 从下拉列表中选择型号。模型通过 UiPath AI Trust Layer配置。要了解如何使用自定义模型，请参阅“配置 LLM” 。
     • 配置温度和最高温度每个响应字段的令牌数量。这些设置可能由 Automation Ops 监管策略控制。有关详细信息，请参阅Studio Web 策略设置。
       • 温度决定了 LLM 生成的创造力系数。可以设置 0（精确）和 1（创意）之间的值。
       • 每次响应的最大令牌数是指智能体做出响应时生成的最大令牌数。
   • 选择模型后，节点将更新为相应模型系列的图标，并且高亮显示将消失。
4. 配置“代理”（“代理” 节点）节点。
   • 默认情况下，“代理”节点与 LLM 节点一起创建。
   • 打开右侧的“提示”部分，定义系统和用户提示。对于对话智能体，本部分得到了简化，仅显示系统提示。
   • 打开左侧的“架构”部分，在“数据管理器”面板中定义输入和输出参数。
5. 添加上下文、工具和升级。完成 LLM 和智能体节点后，将提供三种新的节点类型：
   • 上下文：选择一个上下文基础索引并调整其搜索参数。
   • “工具” ：打开命令面板，搜索已部署的工具，然后将其添加到画布中。添加后，您可以进一步配置每个工具。
   • 升级 （可选） ：添加一个可连接到现有升级配置体验的人机回圈节点。
6. 通过选择工具节点上的 ⋮（更多操作）菜单，访问其他选项。可用的操作如下：
   • 添加断点– 在工具节点插入断点。调试智能体时，系统会在此工具运行之前暂停执行，以便您检查其输入、输出和追踪数据。断点对于在设计时测试期间验证工具逻辑和调试错误非常有用。
   • 添加护栏– 打开“护栏”配置窗口，您可以在其中定义规则，以限制或监控在运行时使用工具的方式。
   • “禁用” – 暂时禁用所选工具节点的代理执行权限。禁用的工具将保留在画布上，但在运行时和调试期间会被跳过，从而使您可以测试或优化智能体的行为，而无需永久删除工具。
     
     

     

     
     
7. 调试智能体。
   • 选择调试以在设计时运行智能体。
   • 当智能体执行时，节点会按顺序变亮，以显示执行流程。
   • 如果运行模拟，节点以不同的颜色显示，以表示模拟的数据或工具调用。
   • 对于对话智能体，您可以通过持久聊天窗口来测试交换；每条消息都会触发调试运行，该运行将高亮显示已连接的节点。
   • 您还可以在特定节点上设置断点，以暂停执行并检查输入、输出和跟踪数据。
8. 保存并发布您的更改。
   • “流程”视图中的所有更新都会自动存储，并与“表单”视图保持同步。
   • 准备就绪后，发布智能体，使其可用于测试和部署。

测试智能体

现在应该对您的智能体进行测试，了解如何改进。

1. 导航至 Studio Web 设计器上方的工具栏。
2. 选择调试环境旁边的箭头，然后选择“调试配置” 。
3. 在“调试配置”窗口中，确认解决方案中使用的资源和示例输入。
4. 选择“ 保存并运行”。
5. 使用测试输出来优化智能体设计。

评估智能体

接下来，转到评估集和评估程序面板，查看和衡量您的智能体。

1. 在评估集面板中，重命名默认评估集，并添加具有预期结果的测试用例。
2. 在评估程序面板中，添加评估程序以验证智能体输出。

每个评估都会将已知输入与对应的输出断言关联起来。

有关详细信息，请参阅评估和在评估中配置模拟。

计算智能体分数 [预览]

从右侧面板中选择打开健康状况分数，以计算智能体分数。请参阅智能体分数，了解其计算方式。

使用 Autopilot 改进您的智能体 [预览]

从右侧面板中选择打开 Autopilot，以接收有关改进提示词、工具和其他组件的建议。此类改进有助于提高智能体分数，并帮助您的智能体做好部署准备。

发布和部署智能体

在测试、评估和优化智能体后，您即可将其发布。此步骤是让智能体在运行作业活动中可用的必要步骤。

1. 选择发布，可将智能体作为流程发布到 Orchestrator。选择发布位置：
   1. Orchestrator 个人工作区订阅源 - 该流程会发布到您的个人工作区，只有您可以使用。这是默认选择。
   2. Orchestrator 租户流程订阅源 - 流程会发布到全局租户订阅源，可供符合条件的文件夹中的所有用户使用。
2. 选择版本。系统会在首次发布时从 1.0.0 开始自动生成一个版本，然后版本号会在每次重新发布时自动递增。
3. 您可以选择提交为模板，在您的组织中将智能体作为模板提供，或者选择共享，与您组织中的用户共享智能体。

运行智能体

将智能体作为活动意味着您可以将其纳入工作流，处理较大的确定性流程的各个部分，让多个智能体按顺序运行，并根据触发器开始执行智能体。

要将智能体集成至工作流中，请执行以下步骤：

1. 将智能体发布到 Orchestrator。
2. 在 Studio 中，使用运行作业活动将智能体集成到工作流中。

3. 无论何时更改智能体，都请将更新后的智能体重新发布到 Orchestrator，并在 Orchestrator 中升级相应流程。

   运行作业活动始终执行 Orchestrator 中当前配置的智能体版本。这能够确保您的工作流始终使用最新版本的智能体。

请参阅系统活动指南，学习如何在 Studio 工作流中配置和使用作业活动。

注意：从 UiPath.System.Activities 25.4.2 版本开始，智能体和其他 Orchestrator 作业的执行已在运行作业活动下得到整合和改进。使用运行智能体活动的现有工作流将继续运行，不进行任何更改，确保平稳过渡。向工作流添加新的智能体运行功能时，即使您搜索运行智能体，系统也会自动建议并实施运行作业活动。