Estrazione dei campi di query di Intelligence sui documenti

**Document Intelligence supporta ora il campo di query per estendere lo schema di qualsiasi modello predefinito per estrarre i campi specifici necessari. È anche possibile aggiungere campi di query al layout per estrarre campi oltre alla struttura da moduli o documenti.

Nota

L'estrazione dei campi di query di Document Intelligence Studio è attualmente disponibile con modelli predefiniti e layout, escluso l'esperienza utente. Modelli predefiniti delle imposte.

Eseguire query su campi o coppie chiave-valore

I campi di query e le coppie chiave-valore eseguono funzioni simili, esistono alcune distinzioni da tenere presenti quando si decide quale funzionalità scegliere.

  • Le coppie chiave-valore sono disponibili solo con modelli di layout e fatture. Se si vuole estendere lo schema per un modello predefinito, usare i campi di query.

  • Non si conoscono i campi specifici da estrarre o il numero di campi è elevato (maggiore di 20), le coppie chiave-valore potrebbero essere una soluzione migliore.

  • Le coppie chiave-valore estraggono le chiavi e i valori presenti nel modulo o nel documento, è necessario pianificare qualsiasi variazione di chiave. Ad esempio, chiavi First Name o Given Name. Con i campi di query, si definisce la chiave e il modello estrae solo il valore corrispondente.

  • Usare i campi di query quando il valore necessario non può essere descritto come coppia di valori chiave nel documento. Ad esempio, la data del contratto di un contratto.

Per l'estrazione dei campi di query, specificare i campi da estrarre e Document Intelligence analizza il documento di conseguenza. Ecco un esempio:

  • Se si elabora un contratto in Document Intelligence Studio, usare la versione dell'API 2024-02-29-preview, 2023-10-31-previewo successiva:

    Screenshot del pulsante campi di query in Document Intelligence Studio.

  • È possibile passare un elenco di etichette di campo come Party1, Party2, PaymentTermsTermsOfUse, PaymentDate, e TermEndDate" come parte della AnalyzeDocument richiesta.

    Screenshot della finestra di selezione dei campi di query in Document Intelligence Studio.

  • Oltre ai campi della query, la risposta include l'output del modello. Per un elenco delle funzionalità o dello schema estratto da ogni modello, vedere Funzionalità di analisi del modello.

Query fields REST API request**

Usare la funzionalità campi di query con il modello di documento generale e aggiungere campi al processo di estrazione senza dover eseguire il training di un modello personalizzato:

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"
}

Passaggi successivi