- 入门指南
- Studio Web 中的 UiPath 智能体
- Agent Builder 中的 UiPath 智能体
- UiPath 编码智能体
智能体用户指南
本节将为您逐步介绍如何在 Studio Web 中构建智能体。请您在熟悉基础知识后，查看最佳实践。
使用 Studio Web 设计器主画布设计智能体，并使用左右面板探索智能体的结构与资源。
左侧面板会为您显示智能体的结构，包括：
- 项目资源管理器 – 组织和构建智能体。定义提示词、工具、上下文、升级等。
- 数据管理器 – 定义输入和输出参数。
- 错误面板 – 查看设计时问题、配置中断或失败的试运行。
- 部署配置面板 – 设置发布和运行智能体的环境特定配置。
右侧面板包括：
-
属性面板，分为以下几种：
- 属性选项卡 – 配置智能体级别和组件级别的设置。
- 开发选项卡 - 运行测试输入、调试并检查设计时追踪。
- 智能体评分（预览）– 根据评估结果和测试覆盖范围查看智能体的就绪状况。
- 运行输出面板 – 查看最近的试运行结果。
- Autopilot（预览）– 获取由 AI 驱动的建议，用于优化提示、工具和智能体设置。
底部面板将历史记录、结果和实时追踪记录保存在一个位置，使评估成为设计体验的核心部分。可用选项卡取决于您正在构建的智能体类型：
-
对于自主智能体，底部面板包含：
-
执行追踪记录 – 显示当前运行的追踪细节。 执行智能体时，此选项卡会自动打开，以便您同步监测实时追踪。
-
历史记录 – 显示所有智能体运行以及执行追踪记录和详细信息。 在这里，您可以直接将运行添加到评估集中。
-
评估 – 列出所有评估集，显示最近的分数。 展开评估集即可了解评估结果、查看详细信息，或单独或完整运行测试。
-
-
对于对话智能体，底部面板包含：
-
聊天 – 替换“执行追踪”选项卡。 提供交互式聊天窗口，以测试与智能体的对话，同时还显示每次交换的执行记录。
-
历史记录 – 显示所有对话运行以及执行追踪记录和详细信息。 在这里，您可以直接将运行添加到评估集中。
-
评估 – 列出所有评估集，显示最近的分数。 展开评估集即可了解评估结果、查看详细信息，或单独或完整运行测试。
-
- 转到Studio.uipath.com 。
- 选择“新建”按钮，然后选择“智能体”。
- 这会打开一个新解决方案，并显示智能体设计器画布。
[预览] 此时将显示“智能体 Autopilot”消息框，您可以在其中用自然语言描述您想要创建的智能体。内容请尽可能具体，以便 Autopilot 高效地生成智能体。
- 从左侧的
项目资源管理器面板访问智能体定义、评估集以及评估程序。
图 2. 解决方案中的智能体- 在定义面板中，您可以设计和定义智能体的核心元素。定义包括以下部分：常规、工具、上下文和升级。
- 使用常规部分为您的智能体定义提示词。
- 使用工具部分连接运行时工具，例如 Integration Service 连接器或已发布的自动化。
- 使用上下文部分，通过上下文基础索引链接知识源，为您的智能体提供相关数据的访问权限。
- 使用升级部分设置人机回圈备份，并启用智能体记忆，以保留交互，帮助校准未来的智能体升级。
- 在评估集面板中，您可以创建评估和存储结果。评估旨在客观衡量智能体的输出，并评估其是否符合您的目标。有关详细信息，请参阅评估。
- 在评估程序面板中，您可以创建和管理评估中使用的评估程序。
- 在定义面板中，您可以设计和定义智能体的核心元素。定义包括以下部分：常规、工具、上下文和升级。
- 第一步，在“项目资源管理器”下选择您的智能体。右键点击“重命名”，并为您的智能体提供唯一名称。智能体名称有助于在各个项目中识别智能体。
- 接下来，从右侧菜单中访问属性面板，选择您想要用于智能体的大语言模型。
- 从下拉列表中选择型号。模型通过 UiPath AI Trust Layer 配置。选择“使用自定义模型”，以使用您自己的模型或订阅。有关详细信息，请参阅“配置 LLM”。
- 配置温度和每次响应的最大令牌数字段：
- 温度决定了 LLM 生成的创造力系数。可以设置 0（精确）和 1（创意）之间的值。
- 每次响应的最大令牌数是指智能体做出响应时生成的最大令牌数。
图 3. 配置模型设置 - 在智能体“定义”面板中，为您的智能体提供“系统提示”和“用户提示”。添加结构合理的提示，就智能体应执行的操作以及应遵守的约束条件给出指令。有关详细信息，请参阅“提示”。
- 使用数据管理器面板定义提示词中使用的智能体输入和输出参数。
图 4. “数据管理器”面板中的输入参数
- 在“工具”部分中，选择“添加工具” ，添加智能体在执行过程中可以使用的任何工具。这些工具可以是一组 Integration Service 活动、现有智能体以及您有权访问的已发布自动化。每个工具都必须有详细描述，以告知智能体如何以及何时使用此工具。有关详细信息，请参阅工具。
- （可选）在“上下文”部分中，选择“添加上下文”，授予智能体访问上下文基础索引的权限。选择租户中可用的现有索引，或选择“新建”，直接在 Orchestrator 中创建新索引。有关详细信息，请参阅“上下文”。
- （可选）在“升级”部分中，选择“添加升级”，以通过升级应用程序添加人机回圈，然后启用“智能体记忆”。添加升级后，您的智能体可以在运行时让人员审核、批准或更新输出。有关详细信息，请参阅“升级和智能体记忆”。
现在应该对您的智能体进行测试，了解如何改进。
- 导航至 Studio Web 设计器上方的工具栏。
- 选择
调试环境旁边的箭头。
- 选择“调试配置” 。
- 在“调试配置”窗口中，确认解决方案中使用的资源和示例输入。
- 选择“ 保存并运行”。
然后，您可以使用测试输出来优化智能体设计。
评估智能体
接下来，转到评估集和评估程序面板，查看和衡量您的智能体。
- 在评估集面板中：
- 重命名默认评估集，然后添加包含预期结果的测试用例。
- 在评估程序面板中，添加评估程序以验证智能体输出。
有关详细信息，请参阅评估。
计算智能体分数 [预览]
从右侧面板中选择打开健康状况分数，以计算智能体分数。请参阅智能体分数，了解其计算方式。
使用 Autopilot 改进您的智能体 [预览]
从右侧面板中选择打开 Autopilot，以接收有关改进提示词、工具和其他组件的建议。此类改进有助于提高智能体分数，并帮助您的智能体做好部署准备。
在测试、评估和优化智能体后，您即可将其发布。此步骤是让智能体在运行作业活动中可用的必要步骤。
- 选择发布，可将智能体作为流程发布到 Orchestrator。选择发布位置：
- Orchestrator 个人工作区订阅源 - 该流程会发布到您的个人工作区，只有您可以使用。这是默认选择。
- Orchestrator 租户流程订阅源 - 流程会发布到全局租户订阅源，可供符合条件的文件夹中的所有用户使用。
- 选择版本。系统会在首次发布时从 1.0.0 开始自动生成一个版本，然后版本号会在每次重新发布时自动递增。
- 您可以选择提交为模板，在您的组织中将智能体作为模板提供，或者选择共享，与您组织中的用户共享智能体。
您可以使用一组智能体模版开始您的智能体之旅，智能体模版可以在 Automation CloudTM 中的“智能体”页面和 UiPath™ Marketplace 中找到。
智能体模板是针对特定任务预先配置的。它需要最低配置才能在 Studio 中运行，您可以对其进行修改并根据自己的特定需求进行定制。智能体模板拥有：
- 预定义组件 – 系统提示、带描述的活动工具、入门者评估集。
- 组件是通用的，不针对特定公司或组织。
- 智能体定义中的组件随时可用。某些组件（例如作为工具的活动）可能需要额外配置，例如在 Integration Service 中创建必要的连接。
- 需要额外配置的组件 – 上下文基础索引、自动化和作为工具的流程、自定义升级以及所有相关描述（为智能体提供的指令）。
- 这些组件是针对特定组织和租户的。
要开始使用来自 UiPath Marketplace 的智能体模版，请执行以下步骤：
- 在 Automation Cloud 中的“智能体”页面中，转到“模板”选项卡，然后选择任意模板。
您将重定向到 Marketplace 中的模板。
- 选择“ 下载”。
- 在“下载智能体模板”窗口中，选择“下载解决方案”。
此时包含智能体定义的
.uis文件会下载到您的计算机。 - 智能体模板还包含 Extras，这是包含智能体资产（自动化、自定义升级）的单独包。选择“下载 Extras”。
此时
.zip文件会下载到您的计算机。 - 在 Studio Web 中，按照“导入从 Studio Web 下载的项目”中的说明，导入智能体定义文件
.uis。 - 接下来，转到“解决方案”。有关详细信息，请参阅“访问解决方案用户界面”。
- 上传
.zip文件，如“传输解决方案包”所述，然后部署解决方案。有关详细信息，请参阅“部署解决方案”。 - 您现在可以从 Studio Web 访问您的智能体模板，并添加部署到您的租户的任何工具。
