Gerenciamento de nós de extração

Adicione, configure e remova nós de extração no UiPath Maestro Flow.

O nó Extract extrai campos estruturados de um documento, como uma fatura, recibo, formulário ou contrato, usando um modelo de extração de IXP e retorna o resultado para os nós downstream agirem.

Pré-requisitos

Antes de adicionar um nó Extract , certifique-se de que seu tenant tenha os serviços IXP e Document Understanding habilitados. O nó Extract depende de ambos os serviços, mesmo quando você usa apenas modelos IXP.

Adicionando um nó Extract a um fluxo

Para adicionar um nó Extrair a um fluxo, proceda da seguinte forma:

1. Abra seu fluxo no Maestro Flow.
2. Selecione Adicionar nó, depois Documento e, em seguida, Extrair.
3. Selecione uma das seguintes opções na paleta de nós:
   • Extrair documento - Crie um novo nó e, implicitamente, um novo modelo.
   • Nesta solução - Selecione um nó existente na lista suspensa.
   • Publicado - Selecione na lista suspensa um modelo de IXP implantado, como um modelo implantado a partir de Documentos complexos e não estruturados de Extração e Processamento Inteligente (IXP) ou do nó Extrair de outro fluxo. Cada modelo aparece como um nó individual.

Resultado: o nó é adicionado à tela de Fluxo, vinculado ao modelo que você selecionou. Nesse ponto, você pode conectar o nó Extract ao nó anterior em seu fluxo.

Configuração do nó Extração

Ao passar o mouse sobre um nó Extrair na tela Fluxo, uma barra de ferramentas aparece. Você pode selecionar uma das seguintes opções para configurar o nó:

• Editar - Abre as propriedades do nó, onde você configura as entradas, o tratamento de erros e as configurações avançadas do nó. Para obter detalhes, consulte Configuração do nó em Propriedades.
• Abrir exibição completa - Abre a guia Definição , onde você configura o modelo de extração e a taxonomia do nó. Para obter detalhes, consulte Configuração do nó na Definição.

Configurando o nó em Propriedades

Para configurar o nó em Propriedades, proceda da seguinte forma:

1. Na tela Fluxo, passe o mouse sobre o nó Extrair .
2. Na barra de ferramentas que aparece, selecione Editar.

Resultado: as propriedades do nó são abertas em uma janela. A seção Propriedades no meio contém as configurações que configuram o nó Extrair . O painel Entrada à esquerda e o painel Saída à direita estão disponíveis para cada nó no Fluxo. Para obter detalhes, consulte os painéis Entrada e Saída.

Propriedades

A seção Propriedades contém as seguintes guias:

• Parâmetros
• Tratamento de Erro
• Avançado

Parâmetros

Observação:

Em caso de erros de validação, um número é exibido na aba Parâmetros .

Para configurar os campos dentro da aba Parâmetros proceda da seguinte forma:

• Entrada do arquivo:

  • Arquivo — O arquivo do qual extrair os dados. Associe-o a um arquivo produzido anteriormente no fluxo, como a saída de um gatilho ou de um nó anterior. Use Inserir para abrir o seletor de variáveis, onde você pode pesquisar variáveis. O seletor lista as saídas dos nós anteriores em $vars e os metadados do fluxo, como FolderKey, InstanceId e ProcessKey em $metadata.

  • Intervalo de páginas - Opcionalmente, adicione as páginas a serem processadas, por 1-5. Deixe vazio para processar todo o documento. Use o ícone de tipo de valor T no campo para escolher entre:

    • Valor fixo — insira um valor diretamente.
    • Expressão - Insira uma expressão JavaScript com o IntelliSense.

    Você também pode usar Insert para adicionar uma variável.

• Definição – Um resumo do modelo de extração do nó:
  • O modelo de extração e sua versão, junto com as métricas de avaliação. Um nó que não tem execução de avaliação mostra Ainda não avaliado.
  • Documentos anotados - O número de documentos anotados do número total de documentos.
  • Carregar - Carregue documentos para anotar.
  • Anotar – Abra a visualização de anotação. Essa opção fica indisponível até você adicionar campos à taxonomia.
  • Executar avaliação - Execute uma avaliação do modelo de extração.
  • Editar - Abra a guia Definição do painel Extrair documento . Para obter detalhes, consulte Configuração do nó na Definição.
  • Configuração do modelo – Um resumo somente leitura da configuração do modelo: Modelo de extração, Estratégia de extração, Suporte ao idioma, Análise de layout e Atribuição.
  • Taxonomia – O número de campos na taxonomia. Se a taxonomia não tiver campos, selecione Adicionar campos para abrir a guia Definição com um novo grupo de campos.

Tratamento de Erro

A aba Tratamento de erros contém a opção Habilitar tratamento de erros . Quando você habilita-o, o nó recebe um identificador de saída de erro que captura e lida com falhas, e a saída do nó inclui um objeto error com os atributos code, message, detail, category e status teclas.

Avançado

A aba Avançado contém as seguintes configurações:

• ID - O ID do nó, por exemplo extractDocument2 Para alterá-lo, selecione o ícone de edição.
• Cor do ícone — a cor do ícone do nó na tela.
• Atualizar variável - Atribui valores a variáveis quando o nó é executado. Selecione Adicionar atualização de variável e, em seguida, defina as seguintes configurações:
  • Variável — a variável a ser atualizada. Selecione uma variável existente ou selecione Criar nova variável.
  • Expressão — o valor a ser atribuído. Utilize Insert para adicionar uma variável. Para fazer referência a uma variável em uma expressão, $vars.{name}.

Painéis de entrada e saída

Os painéis Entrada e Saída estão disponíveis para todos os nós no Fluxo. Elas mostram dados do fluxo e você não configura o nó Extract nelas.

Entrada

O painel Entrada lista os nós anteriores no fluxo. Você pode visualizar a entrada nos seguintes formatos:

• Esquema - As chaves de saída de cada nó anterior e seus tipos. Para um novo nó, as chaves não têm valores.
• JSON — a entrada no formato JSON. Para um novo nó, essa visualização fica vazia.

Saída

O painel Saída mostra a saída da execução anterior do nó, com as teclas version, type, result, taxonomy e metadata . Se o nó ainda não tiver sido executado, as chaves não terão valores. Você pode visualizar a saída no formato Esquema, JSON ou Resultado de extração .

A lista suspensa seleciona qual resposta o nó retorna:

• Ativa – A resposta real do nó.
• Simulação estática - Um valor que você define, retornado todas as vezes.
• Gerado - Uma resposta que um LLM gera dinamicamente.

Configurando o nó no Definição

Para configurar o nó na aba Definição , proceda da seguinte forma:

1. Na tela Fluxo, passe o mouse sobre o nó Extrair .
2. Na barra de ferramentas que aparece, selecione Abrir exibição completa.

Resultado: o painel Extrair documento abre a aba Definição .

A guia Definição contém as seguintes seções:

• Resumo da avaliação – O modelo de extração, sua versão e métricas de avaliação. Um nó que não tem execução de avaliação mostra Ainda não avaliado. Para obter detalhes, consulte Pontuação de integridade do nó. A seção também contém as seguintes opções:

  • Documentos anotados - O número de documentos anotados do número total de documentos.
  • Upload - Carrega documentos para anotar.
  • Anotar documento - Abre a visualização de anotação. Essa opção fica indisponível até você adicionar campos à taxonomia.

• Configuração do modelo – O modelo de extração e suas configurações avançadas. Para obter detalhes, verifique Configuração do modelo.

• Taxonomia — os campos que o nó extrai de cada documento:

  • Instruções gerais de extração – Adicione contexto que seja relevante para toda a taxonomia.
  • Guia Taxonomia - Adicionar e gerenciar grupos de campos e campos. Para um novo nó, selecione Grupo de campos para adicionar o primeiro grupo de campos.
  • Guia Tipos de campo - Adicione e gerencie os tipos de campo pré-configurados e personalizados.
  • Visualizar documentos - Abra uma visualização de documento ao lado da taxonomia.
  • Importação/Exportação - Importe ou exporte a taxonomia. Para obter detalhes, consulte Importação e exportação de taxonomias.

  Para obter detalhes, consulte Gerenciamento da taxonomia.

Quando você alterar a taxonomia, certifique-se de selecionar Salvar.

Remoção de um nó Extração

Para remover um nó Extrair de um fluxo, proceda da seguinte forma:

1. Na tela Fluxo, passe o mouse sobre o nó Extrair .
2. Na barra de ferramentas que aparece, selecione o ícone de reticências.
3. Selecione Excluir. Alternativamente, selecione o nó Extrair na tela Fluxo e pressione Backspace.

Resultado: o nó Extrair é removido da tela Fluxo.

Documentação relacionada do Maestro Flow

• Extrair - A referência do nó, incluindo como ler o resultado da extração, campos ausentes, pontuações de confiança e campos de tabela.
• Processamento de documentos - Os nós de processamento de documentos disponíveis na tela de fluxo.