Extrair

Extraia campos estruturados de documentos usando modelos de Extração e Processamento Inteligente (IXP).

O nó Extract extrai campos estruturados de um documento (uma fatura, recibo, formulário ou contrato) usando um modelo UiPath Intelligent Xtraction and Processing (IXP) e retorna o resultado para os nós downstream agirem. Use-o quando uma etapa no seu processo precisar de dados digitados extraídos de um arquivo não estruturado.

Adicionar um nó Extração

O nó Extract executa um modelo de extração de IXP. Você pode usar um modelo que já existe ou criar um novo no nó.

1. Selecione + no identificador do nó que segue e, em seguida, selecione Documento > Extrair.
2. Selecione uma destas opções:
   • Extrair documento (Visualização): adiciona um nó com um novo modelo, que você cria e avalia no nó.
   • Nesta solução: reutiliza o modelo de um nó Extract em outro fluxo de trabalho da mesma solução.
   • Publicado: usa um modelo de IXP implantado, como um implantado a partir do IXP ou do nó Extrair de outro fluxo de trabalho. Cada modelo aparece como seu próprio nó. Você precisa acessar o local onde o modelo é implantado.

Seu administrador deve ativar o IXP e o Document Understanding, mesmo quando você usar apenas modelos do IXP. A administração lista os serviços.

A criação, avaliação e implantação de um modelo no nó são descritos na documentação do IXP:

• Gerenciamento de nós de extração
• Consumo de modelos por meio do Fluxo

Quando o nó é executado, o Maestro Automate envia o documento para o modelo, o modelo o digitaliza e o extrai, e o resultado estruturado retorna no output do nó. O nó aguarda o modelo finalizar antes de continuar; portanto, dê tempo para documentos grandes.

Configuração

Configure o nó Extrair no painel de propriedades depois de adicioná-lo à tela.

Campo	Required	Padrão	Description
de transações	Sim	Nenhum	O documento do qual extrair. Associe-o a um arquivo produzido anteriormente no fluxo de trabalho, como a saída de um gatilho ou de um nó anterior.
Intervalo de Página	Não	Vazio	As páginas das quais extrair, por exemplo 1-5 Deixe vazio para processar todo o documento.
Definição	Não aplicável	Nenhum	Um resumo do modelo do nó: sua versão e resultados de avaliação, os documentos anotados e os campos que ele extrai. Editar abre a visualização completa, onde você configura o modelo e seus campos.

Saída

O nó Extract retorna seu resultado em $vars.<nodeId>.output, com estas chaves:

• version
• type
• result
• taxonomy
• metadata

Os campos dentro de result dependem dos campos que seu modelo extrai. Para vê-los, depure o fluxo de trabalho, abra a visualização expandida do nó e verifique a coluna Saída . Ele mostra a saída da última execução como Esquema, JSON ou Resultado da extração. Antes que o nó seja executado, as chaves não têm valores. A saída na documentação do IXP descreve o painel.

Para testar nós posteriores sem executar uma extração, altere o modo da coluna Saída de Ativo para Simulação estática, um valor que você define, ou Gerado, uma resposta que um LLM gera. A simulação de saída descreve ambos.

Tratamento de Erro

Na guia Tratamento de erro , selecione Habilitar tratamento de erros. Então, o nó tem um identificador de saída de erro. Se a extração falhar, a execução continua no caminho de erro, e o erro está em $vars.<nodeId>.error, com as chaves code, message, detail, category e status . O tratamento de erros descreve como rotear.

Observações

• Publicado lista os modelos que são implantados quando você abre o painel Adicionar nó . Após implantar um novo modelo, abra o painel novamente para vê-lo.

Próximas Etapas

• Processamento de documentos: como os nós do documento trabalham juntos.
• Analisar arquivos: extraia dados de um arquivo passo a passo.
• Comunidade: faça perguntas e compartilhe fluxos de trabalho com outros construtores no Fórum da UiPath.