创建并显示 AI 摘要标注

本教程将指导您创建一个标注，用于在网页应用程序中显示用户选择的信息的 AI 摘要。请检查本教程中介绍的以下操作序列：

1. 首先启动 Cloudy.com 网站。
2. 一旦出现 Windy 徽标，我们会显示包含用户说明的标注。
3. 当网站搜索栏出现时，另一个标注会提示您搜索所需的位置以查看天气。
4. 执行搜索请求后，网站上显示的天气结果将用作生成 AI 摘要的内容。

   本摘要会建议最适合远足的天气。

5. 标注将显示 30 秒，之后将关闭标注并停用所有触发器。

先决条件

此示例是使用以下活动包和版本创建的：

• UiPath.Callout.Activities 25.2.0
• UiPath.IntegrationService.Activities 25.2.1
• UiPath.System.Activities 25.2.1
• UiPath.UIAutomationActivities 25.2.1-preview

步骤

1. 打开 Studio 项目，然后转到“主要工作流”。
   1. 添加“使用应用程序/浏览器”活动，然后在“浏览器 URL”字段中输入https://www.windy.com/ 。
   2. 添加“运行本地触发器”活动。

      这将启用所有触发器工作流，并允许它们在触发事件发生时运行。

2. 为初始标注创建一个uiform文件，该文件会在出现 Windy 徽标后提示您按照进一步的说明进行操作。
   1. 在 Studio 项目中，从“新建”下拉菜单中选择“表单”以创建新表单。

      此处将表单文件用作标注。

   2. 将该标注命名为Basic callout 。
   3. 在“组件”面板中，展开“基本”部分，然后将三个“标签/标头”组件拖动到标注文件中。按如下方式编辑组件：
      1. 对于第一个组件，在“内容”字段中输入以下文本：“欢迎使用Windy.com！”。
      2. 对于第二个组件，在“内容”字段中输入以下消息：“请按照屏幕上的说明了解哪一天最适合慢步慢行。”
      3. 对于第三个组件，转到“字段键”选项卡，然后将“属性名称”更改为aiSummary 。

         将此组件的“内容”字段留空，因为该字段将在运行时动态填充 AI 生成的摘要。

   4. 保存标注文件。
3. 创建一个名为“显示基本标注”的新工作流，并添加一个“应用程序事件触发器”活动。

   此工作流显示欢迎您使用 Windy.com 的标注，以及我们将在其中显示 AI 摘要的标注。

   1. 选择“在屏幕上指定目标” ，然后指定要让自动化开始监控的用户界面元素。

      在此示例中，我们指出要监控的 Windows 徽标。

   2. 从“事件类型”下拉列表中，选择“出现” 。
   3. 添加“显示标注”活动。
      此活动允许您选择一个uiform文件，您可以使用“参数”字典将其显示给特定用户界面元素，以及将数据传递到uiform文件。
      1. 从“选择表单”下拉列表中，选择先前创建的标注文件。
         在此示例中，我们选择了Basic callout 。
      2. 对于“用户界面元素”字段，输入为“应用程序事件触发器”活动指定的用户界面元素，即我们要与标注绑定的“Windy 徽标”。
         要访问该目标元素，请使用TriggerEventArgs.TargetElement表达式。TriggerEventArgs是此处的参数，在将触发器活动添加到工作流时自动生成。在这种情况下， “应用程序事件触发器”活动会生成参数。
4. 为网站搜索栏可见时出现的标注创建uiform文件，并提示您搜索其所需位置。
   1. 在 Studio 项目中，从“新建”下拉菜单中选择“表单”以创建新表单。

      此处将表单文件用作标注。

   2. 将该标注命名为Please search for your desired location 。
   3. 在“组件”面板中，展开“基本”部分，然后将“标签/标头”组件展开到标注文件中。
   4. 保存组件和文件。
5. 创建名为“请搜索所需位置”的新工作流，并添加“应用程序事件触发器”活动。

   此工作流显示标注，要求您搜索用户想要查找天气信息的位置。

   1. 选择“在屏幕上指定目标” ，然后指定要让自动化开始监控的用户界面元素。

      在此示例中，我们指出了要监控的“Windy”搜索栏。

   2. 从“事件类型”下拉列表中，选择“出现” 。
   3. 添加一个“延迟”活动，并将其“持续时间”设置为三秒，以便您有足够的时间先阅读欢迎标注，然后查看搜索栏旁边显示的标注。
   4. 添加“显示标注”活动。
      此活动允许您选择一个uiform文件，您可以使用“参数”字典将其显示给特定用户界面元素，以及将数据传递到uiform文件。
      1. 从“选择表单”下拉列表中，选择先前创建的标注文件。
         在此示例中，我们选择了Basic callout 。
      2. 对于“用户界面元素”字段，输入为“应用程序事件触发器”活动指定的用户界面元素，即我们要与标注绑定的“Windy 徽标”。
         要访问该目标元素，请使用TriggerEventArgs.TargetElement表达式。TriggerEventArgs是此处的参数，在将触发器活动添加到工作流时自动生成。在这种情况下， “应用程序事件触发器”活动会生成参数。
      3. 打开“参数”字典，并在所生成键的“值”字段中输入要显示的文本。

         在此示例中，我们显示以下文本：“请搜索所需位置并从列表中选择”。

6. 创建名为“获取并交付 AI 天气摘要”的新工作流。

   此工作流将根据您先前搜索的位置显示的天气结果，开始生成最适合外出步道的日期的 AI 摘要。

   1. 添加“应用程序事件触发器”活动。
      1. 选择“在屏幕上指定目标” ，然后指定要让自动化开始监控的用户界面元素。

         在此示例中，我们指出要监控的“有风”天气结果。

      2. 从“事件类型”下拉列表中，选择“出现” 。
   2. 添加“关闭表单”活动，以关闭要求您搜索所需位置的标注。
   3. 从“选择表单”下拉列表中，选择“请搜索所需位置”标注。
   4. 添加“设置表单值”活动，以使用有关生成 AI 摘要流程的信息更新原始的“基本标注” 。
   5. 添加一个“使用应用程序/浏览器”活动，以附加到 Windy 浏览器窗口并提取天气信息。在浏览器 URL字段中，输入https://www.windy.com 。
   6. 在“执行”块中，执行以下操作：
      1. 添加“提取表格数据”活动。
         1. 选择在屏幕上指定目标，然后选择天气结果。
         2. 为“提取目标位置” 字段创建输出变量。
            在此示例中，我们将其命名为extractedWeatherDetails 。
      2. 添加“输出数据表”活动。
         1. 在“数据表”字段中输入先前创建的用于保存天气数据的变量（ extractedWeatherDetails ）。
         2. 为“文本”字段创建输出变量。在此示例中，我们将其命名为weatherData 。
      3. 添加“设置表单值”活动，以显示有关分析流程状态的最新信息。
         1. 从“选择表单”下拉列表中，选择Basic callout表单
         2. 在“参数”字典中，为aiSummary参数输入以下值：“...正在分析天气数据...”。
      4. 添加“内容生成”活动以生成 AI 摘要。
         1. 在活动主体中，选择“添加新连接”以创建与 UiPath GenAI Activities 的连接，该连接允许执行活动。
         2. 从“模型名称”下拉列表中，选择所需的 AI 模型。
         3. 在“提示”字段中，输入“输出数据表”活动中的结果变量。在此示例中，输入weatherData 。
         4. 在“系统提示词” 字段中，输入 AI 模型的说明，以用于根据提供的天气数据生成摘要。在此示例中，我们使用了以下提示：

            “系统将为您提供以下格式的一组数据：日、小时、缺少的天气图标、温度、降水量、有没有云、有没有云、突如其来的大云，最后一个可以忽略不计。请告知哪一天的天气最适合外出旅行。在输出中，请坚持使用简短的建议和原因，而不要提供任何特定分析的详细信息”。

         5. 为“生成的次数最多的文本”字段创建一个输出变量。在此示例中，我们将其命名为topGeneratedText 。
      5. 添加另一个“设置表单值”活动，以显示 AI 生成的摘要。
         1. 从“选择表单”下拉列表中，选择Basic callout表单。
         2. 在“参数”字典中，输入以下表达式，其中包含“内容生成”活动的输出以及有关标注状态的信息： "topGeneratedText + Environment.NewLine + "This callout will close in 30 seconds." 。
      6. 添加一个“延迟”活动，并将其设置为 30 秒。
      7. 添加“关闭表单”活动，然后从“选择表单”下拉列表中选择Basic callout 。
      8. 添加“停止本地触发器”活动，以停止所有触发器工作流的执行。

         如果您的项目仅包含触发器工作流，则此活动尤其重要。如果不合并此活动，触发器将在连续循环中持久运行，不会停止。

结果

自动化将打开 Windy 网站，并在徽标出现后触发“显示基本标注”工作流。显示搜索栏时， “请搜索您的位置”工作流将开始运行，要求您搜索所需位置，从中查找天气相关信息。显示天气结果时，“获取并交付 AI 天气摘要”工作流将开始运行，它会检索天气结果，并将其作为提示的一部分发送给 AI 模型，这些结果稍后将显示回同一表单中。显示 AI 摘要后，表单将在 30 秒后关闭。以下动画图像直观地显示了运行时流程的描述：

图 1.显示 AI 生成的摘要的标注

工作流示例

要查看如何实施本教程中的步骤，请下载以下示例项目：显示 Windy 的 AI 摘要标注。