Document Understanding 新式项目用户指南

适用平台：

上次更新日期 2025年10月15日

在不同环境中使用模型

使用 Document Understanding^TM 新式项目时，您需要配置外部应用程序，以访问多个租户和组织的模型。

本流程全面介绍了如何通过外部应用程序访问部署在不同环境中的模型。内容包括分步指导：配置外部应用程序访问权限、设置 Studio 工作流以调用这些模型，以及建立生产工作流。

此功能还支持在混合部署环境中使用模型。在本例中，Document Understanding 项目配置在 Automation Cloud^TM 上，而 Orchestrator 和机器人部署在本地。

配置外部应用
配置 UiPath Studio 工作流
将模型版本配置为参数
Document Understanding 流程模板

配置外部应用

导航到您的 Automation Cloud 租户。
转到“管理”页面，然后选择您的组织。
转到外部应用页面。
在外部应用页面中选择添加应用。

提示：有关添加外部应用程序的更多信息，请查看《Automation Cloud 管理员指南》中的“管理外部 OAuth 应用程序”页面。
在“应用名称”字段中键入应用程序的唯一名称。
从“应用类型”部分选择应用类型：
- 机密应用：适用于安全存储应用程序密码。将其用于安全要求较高的场景。
- 非机密应用：仅在不需要对应用程序密码进行安全存储时使用此选项。
界定外部应用的访问作用域。
1. 从资源部分选择添加作用域。
2. 从“资源”下拉列表中选择“Document Understanding”。
3. 配置用户作用域，授予在用户环境中的权限。
  
  在用户作用域选项卡中，根据要求勾选与您想要授予的逻辑 API 权限相对应的复选框。如果您在用户作用域下授予权限，则意味着外部应用程序可以访问这些位于用户环境中的资源。因此，具有相应权限的用户必须登录。
4. 配置应用程序作用域，提供应用程序级访问权限，以满足更广泛的自动化需求。
  
  如果您正在使用机密应用程序，请导航到“应用程序作用域”选项卡，视需要为选定资源分配应用程序级权限。在应用程序作用域下授予权限后，外部应用程序无需任何用户交互，即可跨选定作用域访问数据。
  
  非机密应用程序无法访问应用程序的作用域。
5. 选择“保存”。
  
  注意：如果您已使用用户作用域注册外部应用程序，请添加一个重定向 URL。此 URL 将接收授权响应信息。但是，如果您仅选择了应用程序作用域，提供重定向 URL 是可选项。
选择“添加”以创建注册。

此时将显示确认消息。对于机密应用，此消息包含应用程序密码。注册的外部应用程序可以使用此密码请求授权。请务必将应用程序密码保存在安全位置，因为您将无法再次查看此密码。

配置 UiPath Studio 工作流

开始之前，请确保满足以下先决条件：

使用兼容的 Windows 项目版本。
确保安装了 IntelligentOCR 活动包。从 v6.22.1 版本开始，IntelligentOCR.Activities 包支持使用 Document Understanding 新式项目。

提示：

要更详细地理解 DocumentUnderstanding.Activities 和 IntelligentOCR.Activities 包之间的差异，以及每个包的使用场景指南，请查看“Document Understanding 自动化”页面。

打开您的 UiPath Studio 项目。
对分类进行界定。
1. 打开分类管理器，为您的自动化定义相关的文档类型和字段。
  
  您的项目分类应涵盖每个文档类型和必要字段。您在 Studio 中创建的分类可以包含 Document Understanding 新式项目中没有的额外文档类型和字段。如果您希望将其他提取程序（例如表单提取程序或 Regex 提取程序）用于各种文档类型，则需执行此步骤。
安装 IntelligentOCR.Activities 包，即可使用 Document Understanding 项目提取程序和 Document Understanding 项目分类器等活动。
1. 添加“数据提取作用域”活动，配置提取模型，并包含“Document Understanding 项目提取程序”活动。
2. 添加“分类文档作用域”活动，以配置分类模型，并包含“Document Understanding 项目分类器”活动。
配置设计时凭据。
1. 从活动作用域打开“获取功能”向导。
  当您将“Document Understanding 项目”活动包含在该作用域中时，该向导即会出现。用户可使用该向导配置映射新式项目分类字段所需的设计时凭据。
2. 填写以下信息：
  - 外部应用程序中的应用程序 ID 和应用程序密码。
  - 目标环境的租户 URL。
3. 选择“获取项目”，然后选择所需的项目和版本。
4. 关闭向导。
映射分类。
1. 在“数据提取范围”活动中选择“配置提取程序”。
2. 为每个文档类型创建项目分类到模型分类的映射。
  要执行此步骤，请从分类中选择一个文档类型，并将此文档类型中的每个字段与为 Document Understanding 项目设计的模型中的相应字段对齐。
将运行时凭据保存为 Orchestrator 资产。
1. 导航到您的 Automation Cloud 租户。
2. 转到 Orchestrator。
3. 选择您的自动化文件夹。
4. 转到“资产”选项卡。
5. 选择“添加资产”，然后从下拉列表中选择“新建资产”。
6. 在“资产名称”字段中键入名称。
7. 从“类型”下拉列表中选择“凭据”。
8. 使用之前创建的应用程序 ID 和应用程序密码作为用户名和密码。
在 Studio 中配置运行时凭据。
1. 导航到您的 Studio 项目。
2. 转到数据提取作用域活动。
3. 配置运行时凭据资产属性。
  当机器人连接到本地 Orchestrator 或来自其他租户时，使用此字段访问“Document Understanding”新式项目资源。您可以选择通过以下方式之一输入凭据资产，以进行身份验证：
  - 从下拉列表中选择机器人连接到 Orchestrator 所需的凭据资产。
  - 输入您用于存储访问项目所需外部应用凭据的 Orchestrator 凭据资产的路径。路径必须采用如下格式：<OrchestratorFolderName>/<AssetName>。
4. 配置Runtime 租户 URL 属性。
  将此字段与“Runtime 凭据资产”属性配合使用。输入用于连接机器人，执行数据提取的租户 URL。该 URL 必须使用以下格式：https://<baseURL>/<OrganizationName>/<TenantName>。

外部应用程序提供对租户中所有 Document Understanding 项目的访问权限。您不需要为每个项目单独配置访问权限。

将模型版本配置为参数

如果将项目版本配置为参数，您可以更新适用于新项目版本的自动化工作流，无需调整工作流代码。

导航到您的 Automation Cloud 租户。
转到 Orchestrator。
选择您的自动化文件夹。
转到“资产”选项卡。
选择“添加资产”，然后从下拉列表中选择“新建资产”。
在“资产名称”字段中键入名称。
从“类型”下拉列表中选择“文本”。
在“文本”字段中键入名称，定义特定于版本的资产。
选择“创建”。
这样，您就可以更新适用于新项目版本的自动化工作流，无需更改工作流代码。将自动化部署到指定文件夹时，模型版本会根据 Orchestrator 中的资产进行设置。这一流程与将外部应用凭据保存为资产类似。
导航到您的 Studio 项目。
在工作流中添加“获取资产”活动，以获取版本资产。
将检索到的值作为输入变量转交给 Document Understanding 项目活动。