提取

使用 IXP 提取模型从文档中提取结构化字段。

“提取”节点使用 UiPath Intelligent Xtraction 和处理 (IXP) 模型从文档（发票、收据、表单或合同）中拉取结构化字段，并返回结果，以便下游节点进行操作。当流程中的某个步骤需要从非结构化文件中提取带类型的数据时，请使用此功能。

提示：

To build, evaluate, deploy, and use the model behind the Extract node, check the IXP in Flow guide.

添加提取节点

提取节点运行 IXP 提取模型。您可以使用现有模型，也可以在节点中新建模型。

1. 选择其跟随节点句柄上的“+” ，然后选择“文档”>“提取” 。
2. 选择以下选项之一：
   • 提取文档（预览）：添加具有新模型的节点，该模型是您在节点中构建和评估的。
   • 在此解决方案中：在同一解决方案的另一个工作流中重用提取节点的模型。
   • 已发布：使用已部署的 IXP 模型，例如从 IXP 或另一个工作流的提取节点部署的模型。每个模型都显示为自己的节点。您需要访问模型的部署位置。

The Extract node requires both the IXP and Document Understanding services, even when you only use IXP models. Enabling or disabling services describes how to turn them on.

When the node runs, Maestro Orchestrate sends the document to the model, the model digitizes and extracts it, and the structured result returns on the node's output. The node waits for the model to finish before continuing, so allow time for large documents.

Build, evaluate, and deploy the model

If you create the model with Extract document, you build and evaluate it in the node. When you deploy the solution, the model deploys with it. A Published model is read-only in the node. The IXP in Flow guide describes each task:

任务	Page in the IXP in Flow guide
Add, configure, and remove the node, and open the definition of its model	管理提取节点
Upload sample documents	正在上传示例文档
Define the taxonomy: the fields that the model extracts	定义分类
Review and correct the predictions of the model	查看预测
Measure how well the model performs before you deploy it	模型评估
Deploy the model with the solution and manage its deployed versions	模型部署
Use a model from IXP, from this workflow, or from another workflow	通过 Flow 使用模型
Learn what happens when a document exceeds the token or page limit of the model	文档处理限制

配置

将提取节点添加到画布后，请在属性面板中对其进行配置。

字段	必填	默认	描述
文件	是	无	要从中提取内容的文档。将其绑定到先前在工作流中生成的文件，例如触发器或早期节点的输出。
页面范围	否	空白	要从中提取的页面，例如1-5 。将其留空以处理整个文档。
定义	不适用	无	节点模型摘要：版本和评估结果、带批注的文档及其提取的字段。“编辑”将打开完整视图，您可以在其中设置模型及其字段。

输出

提取节点在$vars.<nodeId>.output处返回其结果，键值如下：

• version
• type
• result
• taxonomy
• metadata

The fields inside result depend on the fields your model extracts. To see them, debug the workflow, open the node's expanded view, and check the Output column. It shows the output of the last run as Schema, JSON, or Extraction result. Before the node runs, the keys have no values. Output in the IXP in Flow guide describes the panel.

要在不运行提取的情况下测试后面的节点，请将“输出”列的模式从“实时”更改为“静态模拟” （您定义的值）或“生成” （LLM 生成的响应）。输出模拟描述了两者。

错误处理

在“错误处理”选项卡上，选择“启用错误处理” 。节点具有错误输出句柄。如果提取失败，则运行将在错误路径上继续，错误位于$vars.<nodeId>.error 、 code 、 message 、 detail 、 category和status键。错误处理描述了如何对其进行路由。

注意

• 已发布列出了打开“添加节点”面板时部署的模型。部署新模型后，请再次打开面板以查看该面板。

后续步骤

• IXP in Flow guide: build, evaluate, and deploy the model behind the node.
• 文档处理：文档节点如何协同工作。
• 分析文件：逐步从文件中提取数据。