在 Studio Web 中构建智能体

本节将为您逐步介绍如何在 Studio Web 中构建智能体。请您在熟悉基础知识后，查看最佳实践。

探索智能体工作区

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

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

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

右侧面板包括：

• 属性面板，分为以下几种：

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

创建智能体

1. 转到Studio.uipath.com 。
2. 选择“新建”按钮，然后选择“智能体”。
3. 这会打开一个新解决方案，并显示智能体设计器画布。

   [预览] 此时将显示“智能体 Autopilot”消息框，您可以在其中用自然语言描述您想要创建的智能体。内容请尽可能具体，以便 Autopilot 高效地生成智能体。

配置智能体

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

   

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

   

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

   

   
   
6. 在“工具”部分中，选择“添加工具” ，添加智能体在执行过程中可以使用的任何工具。这些工具可以是一组 Integration Service 活动、现有智能体以及您有权访问的已发布自动化。每个工具都必须有详细描述，以告知智能体如何以及何时使用此工具。有关详细信息，请参阅工具。
7. （可选）在“上下文”部分中，选择“添加上下文”，授予智能体访问上下文基础索引的权限。选择租户中可用的现有索引，或选择“新建”，直接在 Orchestrator 中创建新索引。有关详细信息，请参阅“上下文”。
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 作业的执行已在运行作业活动下得到整合和改进。使用运行智能体活动的现有工作流将继续运行，不进行任何更改，确保平稳过渡。向工作流添加新的智能体运行功能时，即使您搜索运行智能体，系统也会自动建议并实施运行作业活动。