创建并显示 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. 选择在屏幕上指定目标，然后指定要开始监控自动化的用户界面元素。在此示例中，我们指出了要监控的Windy徽标。
   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 摘要标注。