Dicas para criar atributos eficazes no Analyzer no Acrobat

A criação de atributos eficazes é um processo iterativo. Comece com uma definição simples, revise como o Analyzer a interpreta em documentos reais e adicione detalhes apenas quando os resultados mostrarem que é necessário esclarecimento.

Comece com uma definição simples

Inicie com uma descrição direta das informações que deseja extrair.

Evite adicionar restrições, condições ou exemplos até entender como a definição inicial funciona. Começar de forma simples facilita identificar qual redação melhora ou reduz a precisão.

Por exemplo:

    Extraia a taxa de retenção do documento.

Escreva definições claras em linguagem simples

Descreva o conceito como se estivesse explicando para alguém que não conhece o documento.

Concentre-se no significado em vez de onde a informação aparece.

Evite depender de:

• Formatação.
• Números de seção.
• Posição na página.
• Outras instruções dependentes do layout.

Por exemplo:

    Um cartão de tarifas lista as funções ou posições e a taxa por hora de cada.

Refinar um atributo

O refinamento geralmente leva mais de um ciclo de avaliação.

Diagnosticar resultados inesperados

Use o padrão nos resultados para decidir como alterar a definição.

Os resultados são muito amplos

Se o atributo extrair conteúdo não relacionado:

• Torne a definição mais específica.
• Especifique o formato de resposta esperado quando for útil.
• Escolha um tipo de valor apropriado, como Número para resultados numéricos.

Por exemplo:

    Retorne a resposta apenas como porcentagem.

Os resultados são muito limitados ou estão ausentes

Se os valores esperados não forem retornados:

• Remova restrições desnecessárias.
• Adicione exemplos positivos e negativos para esclarecer o resultado pretendido.
• Confirme se as informações de destino realmente aparecem nos documentos sendo avaliados.

Os resultados variam entre documentos

Se uma definição funcionar para alguns documentos, mas não para outros:

• Valide-a primeiro com documentos que você sabe que contêm as informações de destino.
• Expanda os testes para uma variedade mais ampla de documentos somente após os resultados iniciais serem consistentes.
• Verifique manualmente o documento de origem quando não tiver certeza se o valor esperado está presente.

Use exemplos deliberadamente

Os exemplos podem esclarecer o que a definição deve incluir ou excluir.

• Use exemplos positivos para mostrar valores que devem ser extraídos.
• Use exemplos negativos para mostrar valores que não devem ser extraídos.
• Limite os exemplos a entre três e cinco quando possível.

Os exemplos devem refinar uma definição clara, não substituí-la.

Use lógica de várias etapas apenas quando necessário

Alguns atributos dependem do contexto ou de uma sequência de decisões. Nesses casos, descreva a lógica explicitamente.

Por exemplo

Extraia a taxa de retenção seguindo estas etapas:

1. Locate a seção de taxas do documento.
2. Identifique as taxas de retenção expressas como percentuais no início do prazo.
3. Trate X% como padrão; todos os outros percentuais indicam taxas negociadas.
4. Retorne o percentual e se é padrão ou negociado.

Use esta abordagem somente quando uma definição mais simples não produzir resultados confiáveis.

Use o feedback de avaliação

Revise os valores extraídos durante o teste e marque os resultados como corretos ou incorretos.

Quando um resultado estiver incorreto, forneça o valor correto quando possível. Isso ajuda você a identificar falsos positivos, combinações perdidas e padrões que indicam onde a definição precisa de refinamento.

Valide antes de escalar

Antes de aplicar um atributo amplamente, valide-o em relação a uma amostra representativa de documentos.

A validação ajuda você a:

• Identificar casos extremos.
• Evitar aplicar uma definição imprecisa em um grande conjunto de documentos.
• Criar confiança de que o atributo se comporta de forma consistente.

Se os resultados ainda parecerem incorretos, verifique os documentos de origem antes de refinar ainda mais a definição. Causas comuns incluem:

• Qualidade de texto ruim em documentos digitalizados.
• Arquivos protegidos por senha ou bloqueados.
• Arquivos de origem corrompidos.
• Informações de destino ausentes.

Confirme que as informações esperadas existem no documento antes de alterar uma definição que pode já estar correta.