Compartilhar via


Extração de campo de consulta da Informação de Documentos

*A Informação de Documentos agora oferece suporte a campos de consulta, permitindo a extensão do esquema de qualquer modelo predefinido para extrair os campos específicos necessários. Os campos de consulta também podem ser adicionados ao layout para extrair campos além da estrutura de formulários ou documentos.

Observação

Atualmente, a extração de campo de consulta do Document Intelligence Studio está disponível com layouts e modelos predefinidos, exceto os modelos predefinidos UX.Tax.

Campos de consulta ou pares chave-valor

Embora campos de consulta e pares chave-valor desempenhem funções semelhantes, há algumas distinções a serem consideradas ao decidir qual recurso escolher.

  • Os pares chave-valor estão disponíveis apenas com layouts e modelos de fatura. Se quiser estender o esquema de um modelo predefinido, use campos de consulta.

  • Se você não souber os campos específicos a serem extraídos ou o se número de campos for grande (maior do que 20), pares chave-valor podem ser uma solução melhor.

  • Os pares chave-valor extraem as chaves e valores conforme existem no formulário ou documento, exigindo o planejamento para variações de chave. Por exemplo, as chaves First Name ou Given Name. Com os campos de consulta, você define a chave e o modelo extrai apenas o valor correspondente.

  • Use campos de consulta quando o valor necessário não puder ser descrito como um par chave-valor no documento. Por exemplo, a data de acordo em um contrato.

Para realizar a extração de campo de consulta, especifique os campos que deseja extrair e a Informação de Documentos analisará o documento adequadamente. Veja um exemplo:

  • Se você estiver processando um contrato no Estúdio da Informação de Documentos, use a versão 2024-11-30 (GA) da API:

    Captura de tela do botão de campo de consulta do Estúdio de Informação de Documentos.

  • Você pode passar uma lista de rótulos de campo como Party1, Party2, TermsOfUse, PaymentTerms, PaymentDate e TermEndDate" como parte da solicitação AnalyzeDocument.

    Captura de tela da janela de seleção de campos de consulta no Estúdio de Informação de Documentos.

  • Além dos campos de consulta, a resposta inclui a saída do modelo. Para obter uma lista de recursos ou esquema extraídos por cada modelo, confira os recursos de análise do modelo.

Solicitação da API REST dos campos de consulta**

Use o recurso campos de consulta com o modelo de documento geral, e adicione campos ao processo de extração sem precisar treinar um modelo personalizado:

POST https://{endpoint}/documentintelligence/documentModels/prebuilt-layout:analyze?api-version=2024-02-29-preview&features=queryFields&queryFields=Terms,PaymentDate HTTP/1.1
Host: *.cognitiveservices.azure.com
Content-Type: application/json
Ocp-Apim-Subscription-Key:

{
  "urlSource": "https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/form-recognizer/sample-layout.pdf"
}

Próximas etapas