Configurar uma definição de documento
Para configurar um tipo de documento no componente Inteligência do documento, é necessário criar um cenário de negócios e, depois, configurar as definições do documento relevantes para esse cenário de negócios. Por exemplo, no Aplicativo de integração de exemplo, a integração da conta é o cenário de negócios e o documento de identificação é a definição do documento. Você pode fazer outras definições de documento para o cenário Integração de conta de exemplo, como um documento de contracheque.
Você pode criar uma definição de documento com ou sem um fluxo automático.
Crie uma definição de documento com um fluxo automático
Para criar uma definição de documento com um fluxo automático, siga estas etapas:
1. Configurar os pré-requisitos
2. Adicionar definições do Dataverse
3. Criar um fluxo de etapa de pipeline personalizado
4. Criar um fluxo de pipeline personalizado
1. Configurar os pré-requisitos
Entre no Power Apps.
Crie uma solução não gerenciada para a personalização ou trabalhe em uma existente.
2. Adicionar definições do Dataverse
O processo de adição de definições do Dataverse envolve as seguintes etapas:
2a. Adicionar um cenário de negócios para a Inteligência de documento
Observação
Você também pode usar um cenário de negócios existente.
A definição do cenário de negócios ajuda a filtrar somente as definições de documento relevantes de acordo com os cenários de negócios.
Na interface do usuário da Inteligência de documento, ao solicitar um novo documento, a lista suspensa para selecionar o documento para upload exibe somente as definições de documento relevantes de acordo com cenários de negócios específicos.
a. No Power Apps, para a solução selecionada, acesse Adicionar existente>Mais>Opção e selecione msfsi_documentdefinitionscenario.
b. Adicione uma nova opção ao cenário Definição de documento. Por exemplo, o cenário Conta.
2b. Adicionar tipo de documento
Observação
Também é possível usar um tipo de documento existente.
a. No Power Apps, para a solução selecionada, acesse Adicionar existente>Mais>Opção e selecione msfsi_documenttype.
b. Adicione uma nova opção ao Tipo de documento. Por exemplo, o tipo de documento de Identificação.
2c. Adicionar definição do documento
Adicione um novo registro à tabela Definição de documento (msfsi_documentdefinition) e salve-o. A tabela é sensível à solução.
a. No Power Apps, para a solução selecionada, acesse Novo>Mais>Outro>Definição de documento.
b. Defina o valor do campo É fluxo automático como Sim.
c. Selecione o tipo que você já definiu. Várias definições de documento com diferentes definições de fluxo podem usar um tipo de documento.
d. Selecione os cenários de negócios relevantes.
Por exemplo, você pode adicionar o cenário Conta ao cenário Integração de conta.
Uma definição de documento pode ter vários cenários de definição de documento relevantes. Assim, você pode usar o mesmo tipo de documento em vários cenários de negócios com o mesmo fluxo de trabalho automático. Por exemplo, nos cenários Integração de conta e Integração de empréstimo, você pode usar o mesmo fluxo de trabalho automático de documento de identificação. Você pode configurar a definição de documento para ambos os cenários de negócios.
Além disso, mais de uma definição de documento pode usar um cenário de negócios.
e. Selecione Salvar. Depois de salvar a definição do documento, você verá a exibição Definições de etapa do pipeline, conforme mostrado na imagem a seguir, e poderá adicionar definições de etapa para as definições de documento criadas.
2d. Adicionar definições da etapa de pipeline
Adicione novos registros à tabela Definição de etapas do pipeline (msfsi_pipelinestepdefinition) para cada ação que deseja executar nos documentos vinculados à definição de documento atual. Por exemplo, se uma definição de documento de identidade for definida na tabela de definição de documento, você precisará configurar as etapas do processo de documento de identificação como parte da jornada automatizada de identificação. A tabela de definição de documento reconhece a solução.
Cada definição de etapa tem um fluxo do Power Automate relacionado que executa a lógica de negócios real.
a. Selecione Nova definição da etapa do pipeline.
b. Especifique o Nome da definição do documento e Ordem, a ordem de execução desta etapa com referência às outras etapas da definição do documento.
c. Se necessário, você poderá especificar os seguintes valores:
Link de informações: um link exibido na interface do usuário para descrever o método de etapa e, no caso de uma etapa de modelo de IA, para fornecer uma explicação sobre a execução do modelo. Somente o administrador de negócios pode especificar esse valor.
Modelo do AI Builder: especifique o valor se o fluxo executar um modelo do AI Builder.
Tipo: especifique se esta é uma etapa de extração ou de enriquecimento. A interface do usuário exibe o primeiro tipo de extração e o primeiro tipo de enriquecimento em uma única exibição de documento como parte da guia Extração.
Limite de êxito e Limite de falha: o fluxo pode usar esses valores para determinar o status recomendado do documento.
d. Salve suas alterações. Depois de salvar a definição da etapa de pipeline, você verá a exibição Definições da etapa de campo conforme mostrado na imagem a seguir. Você pode adicionar definições da etapa de campo para as definições da etapa de pipeline criadas.
2e. Adicionar definição de campo da etapa (opcional)
Adicione novos registros à tabela Definição de campo da etapa (msfsi_stepfielddefinition) se a etapa exigir a configuração de campos em sua lógica de negócios. A tabela de definição de campo de etapa reconhece a solução. Você pode usar a configuração principalmente nos seguintes casos:
Etapa do AI Builder pronta para uso
Interface do usuário para exibir e gerenciar os campos das primeiras etapas de extração e de enriquecimento.
Você também pode usar a configuração em outros casos, se necessário.
2f. Adicionar definições especiais da etapa
Para cada definição de documento, você pode definir duas etapas especiais, uma única etapa de extração e uma única etapa de enriquecimento, de modo que a interface de usuário do Documento exiba a saída na guia Detalhes extraídos.
Etapa de extração
A etapa de extração ajuda você a extrair informações de um documento. Se estiver usando um modelo do AI Builder para definir a etapa, você deverá treiná-lo. Você pode usar um modelo de IA predefinido ou um modelo personalizado que você criou e treinou.
Observação
No momento, a etapa do AI builder pronta para uso oferece suporte somente ao modelo predefinido de leitor de ID e ao modelo de processamento de documento personalizado.
Você pode definir a etapa de extração da seguinte maneira:
a. Selecione o modelo do AI Builder de sua escolha.
b. Defina o Tipo como Extração. Para cada definição de documento, adicione uma única etapa do tipo extração.
c. Se você quiser que a etapa de extração seja executada automaticamente, defina a Ordem como 0 para que essa etapa seja a primeira no fluxo principal.
d. Insira os valores de Limite de êxito e de Limite de falha. O valor padrão do limite de êxito é 0,9, e o valor padrão do limite de falha é 0,2.
A recomendação da etapa de extração para o documento depende dos valores de confiança da Coleção e de outros campos de saída extraídos:
Se os campos foram extraídos com um valor de confiança superior ao limite de êxito, a recomendação da etapa é aprovar o documento.
Se os campos foram extraídos com um valor de confiança inferior ao limite de falha, a recomendação da etapa é rejeitar o documento.
Caso contrário, a recomendação da etapa para o documento não é clara.
Etapa de enriquecimento
A etapa de enriquecimento ajuda você a enriquecer os dados extraídos com informações de suporte.
Você pode definir a etapa de enriquecimento da seguinte maneira:
a. Defina o Tipo como Enriquecimento. Para cada definição de documento, adicione uma única etapa do tipo enriquecimento.
b. Defina a Ordem da etapa em relação às outras etapas.
Criar definições de campo da etapa para as etapas de extração e de enriquecimento
Para cada campo dos dados extraídos ou de suporte, você deve configurar o comportamento esperado na interface do usuário.
a. Defina o valor de Nome de exibição, que é o rótulo do campo na interface do usuário.
b. Defina Nome externo como o nome do campo definido no modelo ou no sistema externo.
c. Defina o valor de Necessário para aprovação como Sim, caso este campo deva ter um valor antes da aprovação do documento. O valor padrão é Não.
d. Defina o valor de Somente leitura como Sim, se este campo não puder ser editado na interface do usuário. O valor padrão é Não.
Observação
Recomendamos não ter os campos Necessário para aprovação marcados como Somente leitura em uma etapa de extração.
e. (Opcional) Defina o valor de Ordem como a posição do campo solicitado na interface do usuário. O padrão é ordem alfabética.
3. Criar um fluxo de etapa de pipeline personalizado
Crie um novo fluxo da nuvem instantâneo que executa a ação para cada definição de etapa do pipeline.
Observação
Nas etapas com a ação de executar o modelo do AI Builder e salvar a saída, você poderá usar o fluxo principal pronto para uso: Etapa do AI builder do documento. Essa etapa usa a pesquisa de modelo do AI Builder da definição da etapa e executa esse modelo no documento. Se o tipo de definição da etapa for extração e tiver definições de campo ativas, o fluxo também formatará a saída como uma estrutura unificada com a qual a interface do usuário funciona. No momento, há suporte para formatação nos modelos predefinidos Leitor de documentos de identidade e Processamento de documentos personalizado.
No Power Apps, acesse Novo>Automação>Fluxo da Nuvem>Instantâneo.
Insira o nome do fluxo, selecione Desencadear um fluxo manualmente e, em seguida, selecione Criar.
No gatilho do fluxo, adicione ID do pipeline do documento e mais parâmetros, com base em seus requisitos.
Chame o fluxo filho Etapa pré-pipeline para adicionar a etapa vinculada ao pipeline em execução.
a. Selecione Nova etapa e, em seguida, selecione Adicionar um fluxo filho.
b. Selecione o fluxo pronto para uso Etapa pré-pipeline e adicione seus parâmetros.
Adicione as etapas para executar as ações necessárias no documento. É possível usar a configuração definida nos registros Definição de etapa de pipeline relacionada e Definição de campo da etapa.
Chame a Etapa pós-pipeline para especificar detalhes como o estado da etapa, o estado recomendado do documento e, opcionalmente, a saída da etapa.
a. Selecione Nova etapa e, em seguida, selecione Adicionar um fluxo filho.
b. Selecione o fluxo pronto para uso Etapa pós-pipeline e adicione seus parâmetros.
Responda ao fluxo que faz a chamada retornando os parâmetros de saída solicitados, como etapa, estado do documento e assim por diante.
a. Selecione Nova etapa e, em seguida, selecione Responder a um Power App ou fluxo.
b. Forneça as respostas com base nos requisitos.
4. Criar um fluxo de pipeline personalizado
No Power Apps, acesse Novo>Automação>Fluxo da Nuvem>Automatizado.
Insira o nome do pipeline, selecione Quando uma linha é adicionada, modificada ou excluída e selecione Criar.
Especifique vários detalhes no gatilho do fluxo conforme especificado:
Defina Alterar tipo como Modificado.
Defina Nome da tabela como Pipelines de documentos.
Defina Escopo como Organização.
Insira o valor de Selecionar coluna como msfsi_triggercustompipelineon. O valor denota o campo para modificar e desencadear o pipeline personalizado, se ele existir.
Insira o valor de Filtrar linhas como _msfsi_documentdefinition_value eq{ID da definição do documento}. Aqui, {ID de definição de documento} é a definição de documento para a qual você está construindo o pipeline personalizado.
Chame o fluxo filho Obter detalhes do pipeline para obter informações sobre o pipeline em execução e seus documentos relacionados.
a. Selecione Nova etapa e, em seguida, selecione Adicionar um fluxo filho.
b. Selecione o fluxo pronto para uso Obter detalhes do pipeline. Além disso, selecione Sim/Não para Buscar parâmetro do arquivo se você precisar do conteúdo da cadeia de caracteres base64 do arquivo.
Chame os fluxos filho da etapa personalizada na ordem em que foram definidos.
Observação
Se a definição da primeira etapa desta definição de documento, de acordo com a Ordem, for do tipo Extração, a etapa Documento do AI Builder pronto para uso será executada automaticamente no fluxo principal. Portanto, não é necessário chamar a etapa ativamente do pipeline personalizado.
Recomendamos que você execute as etapas personalizadas no escopo dos blocos try-catch para fornecer recomendações finais de pipeline em todos os casos.
Decida o estado final do pipeline e o status de recomendação do documento.
Você pode usar saídas de etapas diferentes, como o estado da etapa e o estado do documento, para calcular os estados finais do pipeline e do documento.
O status do documento de Aprovado, Rejeitado ou Incerto é exibido na interface do usuário como uma recomendação do pipeline em relação ao documento carregado.
Chame o fluxo filho Pós-pipeline para atualizar o registro do pipeline em execução com o estado final e a recomendação do documento.
a. Selecione Nova etapa e, em seguida, selecione Adicionar um fluxo filho.
b. Selecione o fluxo pronto para uso Pós-pipeline e insira seus parâmetros:
Estado do pipeline: Falha ou Êxito como seu valor.
Estado do documento do pipeline: Aprovado, Rejeitado ou Não claro
Pipeline mais recente: ID do registro do pipeline em execução. Este valor está disponível no gatilho.
ID da solicitação de documento: ID da solicitação de documento à qual o pipeline está relacionado. Este valor existe no gatilho.
É atualização automática: defina como Sim se você quiser que o pipeline atualize automaticamente o estado da solicitação do documento ou como Não se você deseja apenas mostrar a recomendação e atualizar manualmente o status da solicitação do documento.
Criar uma definição de documento sem um fluxo automático
Você pode criar uma definição de documento sem nenhum fluxo automático, pipeline personalizado ou fluxo de pipeline de etapa personalizado. Para criar uma definição de documento sem um fluxo automático, siga estas etapas usando o Power Apps:
Crie uma opção Cenário de negócios ou use uma opção existente.
Crie uma opção Tipo de documento ou use uma opção existente.
Adicione uma definição de documento.
Adicione um registro de documento à tabela Definição de documento (msfsi_documentdefinition) e salve-o.
a. Acesse Novo>Mais>Outro>Definição de documento.
b. Defina o valor de É fluxo automático como Não.
c. Selecione o tipo de documento que você definiu anteriormente.
d. Selecione os cenários de negócios relevantes.
e. Selecione Salvar.
Remover um fluxo de documento
A remoção de um fluxo de documento significa que o fluxo automático está desativado, mas a definição do documento existe e se torna um documento para revisão manual sem insights automáticos.
No Power Apps, acesse a solução personalizada.
Selecione o registro de definição de documento relevante na solução para abrir o formulário do registro.
Altere o valor de É fluxo automático para Não.
Desative as definições de etapa do pipeline relacionadas e a definição de campo da etapa.
Desative o pipeline personalizado relacionado.
Remover uma definição de documento
A remoção de uma definição de documento do cenário empresarial desativa o registro de definição do documento específico. Você não pode criar uma solicitação de documento a partir deste tipo de documento.
No Power Apps, acesse a solução personalizada.
Selecione o registro de definição de documento relevante na solução para abrir o formulário do registro.
Desative a definição do documento.