语义活动

语义活动专为处理表单而设计，为数据提取和数据输入提供了直接而有效的方法。

这些活动使您可以使用灵活的方法，而复杂的细节将由我们的 AI 和高级内部组件处理，例如：

• AI 驱动的 DOM 提取引擎：该引擎会提取表单中所有可用的用户界面元素。
• 语义匹配引擎- 通过对文本标签进行语义匹配来增强自动化的弹性，确保针对用户界面更改的稳定性。
• 语义定位和执行引擎：消除了基于选取器的传统挑战，从而实现无缝定位和执行，而不会出现与使用选取器相关的常见复杂性和弹性问题。

本节包括以下活动：

• 关闭弹出窗口
• 提取表单数据
• 填写表单
• 更新用户界面元素（先前为“设置值”）

语言支持

目前仅支持英语。当我们将支持范围扩大到更多语言时，我们将列出其他语言的可用性。

AI Unit 消耗量

Each Semantic activity consumes 0.5 AI units per request.

Each request made to Extract Form Data, Fill Form, and Set Value consumes 0.5 AI units by default.

The Close Popup activity consumes 0.5 AI units per request only when the AI-Enhanced mode toggle button is enabled. In this case, each close action via AI consumes 0.5 AI units. When the toggle button is disabled, the activity does not consume any AI units.

可以使用 Insights 中的“租户级别 AI Unit 使用量”仪表板监控 AI Unit 使用量。在 2025.4 版本之前，“语义活动”指标显示为“语义活动（促销）”，并涵盖您使用但无需付费的 AI Unit 数量。您可以在 2025.4 版本之后监控此仪表板，以预测语义活动中的 AI Unit 消耗量。

从版本 2024.10.6 开始直至 2025.4，Community 版和 Enterprise 版客户都可以免费使用语义活动，包括没有购买 AI Unit 的客户。此促销期旨在鼓励客户采用语义活动并让客户建立对此功能质量的信任。从 2025.4 版本开始，AI Unit 的使用情况如上所述，确保所有用户都能顺畅地以连续和公开透明的方式使用。

关闭弹出窗口

UiPath.UIAutomationNext.Activities.NClosePopup

描述

使用配置的关闭按钮关闭应用程序顶部的所有弹出窗口并阻止目标。

该活动可在“使用应用程序/浏览器”活动内部和外部使用。

项目兼容性

Windows |跨平台

配置

• 弹出窗口关闭按钮- 用于关闭弹出窗口的按钮标签。 在 Studio Desktop 中，默认情况下会填充“关闭”和“取消” 按钮标签。
• AI 增强模式 - 如果切换按钮设置为“开启”，则利用 AI 关闭弹出窗口。每个通过 AI 执行的关闭操作都会消耗一个 AI Unit。默认选项为“关闭”。

其他选项

计时

• 弹出窗口出现超时- 等待弹出窗口出现的时间（以秒为单位）。 默认值为 30 秒。

输入

• 检测到弹出窗口异常- 检测到弹出窗口时引发的异常。

输出

• 已处理弹出窗口 - 指明是否已处理弹出窗口。

提取表单数据

UiPath.Semantic.Activities.NExtractFormDataGeneric

描述

使用 AI 无缝提取表单数据。

它可以轻松地与数据实体集成。

此活动必须添加到“使用应用程序/浏览器”活动中。

项目兼容性

Windows |跨平台

配置

• “从屏幕中发现字段” - DOM 分析，用于查找可操作元素及其关联的标签。
• “表单数据”- 保存提取的表单数据的位置。 输出结果为结构化数据自定义类型。

其他选项

计时

• “在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟（以秒为单位）。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。

• “延迟 时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间（以秒为单位）。 默认值为 0.3 秒。 在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。

• “超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。 默认值为 30 秒。

• “出错时继续” - 指定在活动引发错误时是否应继续自动化操作。 此字段仅支持 Boolean 值（True、 False）。 默认值为 False。 因此，如果该字段为空且活动引发错误，系统将停止执行项目。 如果该值设置为 True，则无论出现何种错误，系统都将继续执行项目。

填写表单

UiPath.Semantic.Activities.NFillForm

描述

借助 AI，利用提取自所提供数据源的信息无缝填充指定的表单。

此活动必须添加到“使用应用程序/浏览器”活动中。

项目兼容性

Windows |跨平台

配置

• 数据源 - 选择以下支持的类型中的数据源：DocumentData、Dictionary、DataEntity、DataRow、DataTable、JSON 文件、非结构化文本文件或甚至是自定义类型，例如通过“提取表单数据”活动作为输出而生成的文件。
  备注：

  对于DataTable ，仅使用第一行中的数据填充表单。

  要将“ IEnumerable ”用作数据源，您需要在“遍历循环” 活动中添加活动。
• 启用验证 - 如果切换按钮设置为“开启”，则为运行时值启用执行验证。如果内部验证机制在执行后检测到无效值，则会引发异常。默认选项为“关闭”。

其他选项

计时

• “在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟（以秒为单位）。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。

• “延迟 时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间（以秒为单位）。 默认值为 0.3 秒。 在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。

• “超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。 默认值为 30 秒。

• “出错时继续” - 指定在活动引发错误时是否应继续自动化操作。 此字段仅支持 Boolean 值（True、 False）。 默认值为 False。 因此，如果该字段为空且活动引发错误，系统将停止执行项目。 如果该值设置为 True，则无论出现何种错误，系统都将继续执行项目。

更新用户界面元素（先前为“设置值”）

UiPath.Semantic.Activities.NSetValue

描述

使用 AI 无缝在任何输入字段中设置值：输入框、下拉列表、复选框、单选按钮、日期选取器。

它只能在 Chrome Edge、Firefox 和 Safari 中使用。

使用与 “填充表单”相同的功能，但在元素级别使用。

您可以使用单个通用的“更新用户界面元素” 活动，而不是对特定输入字段使用其他活动（例如，为输入框 使用“键入” ，为复选框提供“选中/取消选中” 等）。它还可以处理日期选取器和单选按钮组。

此活动必须添加到“使用应用程序/浏览器”活动中。

此活动可与对象存储库兼容。

项目兼容性

Windows |跨平台

配置

• 在屏幕上指定目标 - 指定要用作目标的用户界面元素。

  指定目标后，选择加号按钮以访问以下选项：

  • “在屏幕上指定目标”- 再次指定目标。
  • 编辑目标 - 打开选择模式以配置目标。
• 值- 字段中设置的值。 此字段仅接受String变量。
  如果指定的目标是复选框，则接受的值为以下值：

  • True："true"、"yes"、"checked"、"x"
  • False："false"、"no"、"unchecked"
• 启用验证 - 如果切换按钮设置为“开启”，则为运行时值启用执行验证。如果内部验证机制在执行后检测到无效值，则会引发异常。默认选项为“关闭”。

选项

• Healing Agent 模式- 根据流程或作业级别的监管或 Orchestrator 设置，配置此活动的 Healing Agent 行为。
  • 已禁用- 关闭此活动的 Healing Agent。
  • 继承作业设置- 在流程或作业级别应用在监管或 Orchestrator 中定义的设置。
  • “仅建议” - 允许 Healing Agent 提供有关如何修复正在运行的作业中的用户界面自动化问题的建议，但前提是监管或 Orchestrator 设置允许。
  • 与应用程序/浏览器相同- 从父级“使用应用程序/浏览器”活动继承配置。

• “出错时继续” - 指定在活动引发错误时是否应继续自动化操作。 此字段仅支持 Boolean 值（True、 False）。 默认值为 False。 因此，如果该字段为空且活动引发错误，系统将停止执行项目。 如果该值设置为 True，则无论出现何种错误，系统都将继续执行项目。

目标

• Expand target properties - Display target and anchor properties. This will hide the other activity properties and display only those related to the target.

• Collapse target properties - Hide target and anchor properties. This will hide target related properties and display the activity properties.

• 定位方法 - 要用于标识元素的选取器类型。 可以将此属性设置为下拉菜单中的任意组合：
  • 无
  • Strict selector - The strict selector generated for the target UI element.
  • Fuzzy selector - The fuzzy selector parameters.

  • Computer Vision - 要将 Computer Vision 用作定位方法，您需要转到“项目设置”>“Computer Vision”，并确保设置正确的服务器端点。您可以原样保留此字段，并使用 UiPath Cloud（默认情况下已填写），也可以通过选择特定于服务器区域的任何其他公共端点或您自己的本地部署服务器来输入其他值。

    Another way of using Computer Vision as a targeting method is to set Use Local Server to True. This implies that the UiPath.ComputerVision.LocalServer package is installed in your project. When Local Server is enabled, the server value is over-written. However, the Local Server is not available in cross-platform projects.

    • CV 控件类型 - 指示使用 Computer Vision 识别的控件类型。
    • 计算机视觉文本 - 表示使用 Computer Vision 识别的文本。
    • CV Text occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
    • CV Text accuracy - Indicates the accuracy level for OCR text matching.
  • Semantic selector - Leverages large language models (LLMs) to generate functional, human-like descriptions of UI elements. These descriptions are highly reliable making them adaptable to UI changes and significantly improving automation resilience when traditional selectors fail.
  • Image (Windows only)
    • Image accuracy - Indicates the accuracy level for image matching.
    • Image occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
  • Native text (Windows only)
    • Native text - The text to find to identify the UI element.
    • Native text occurrence - Indicates a specific occurrence to be used, when multiple matches are found.
• Window selector (Application instance) - Selector for the application window. Only applicable when window attach mode is set to application instance.
• Wait for page load - Before performing the action, wait for the application to becaome ready to accept input. The options are:
  • 无- 不等待目标变为就绪状态。
  • “交互式”– 等待直到加载了应用程序的一部分。
  • “完整”– 等待整个应用程序被加载。
• Visibility check - When enabled, the activity also checks whether the UI element is visible or not. You can choose one of three options from the drop-down menu:
  • “无 ”- 不检查可见性。
  • 交互式（用于模糊选取器） - 默认选项。 检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或应用程序已最小化。 当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
  • 完全可见 - 检查用户界面元素是否可见。
• 响应式网站 - 启用响应式网站布局。

计时

• “在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟（以秒为单位）。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。

• “延迟 时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间（以秒为单位）。 默认值为 0.3 秒。 在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。

• “超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。 默认值为 30 秒。