Извлечение поля запроса аналитики документов
**Аналитика документов теперь поддерживает поле запроса для расширения схемы любой предварительно созданной модели для извлечения необходимых полей. Поля запроса также можно добавить в макет, чтобы извлечь поля в дополнение к структуре из форм или документов.
Примечание.
Извлечение поля запросов Document Intelligence Studio в настоящее время доступно с макетами и предварительно созданными моделями, за исключением пользовательского интерфейса. Предварительно созданные налоговые модели.
Поля запроса или пары значений ключей
Поля запросов и пары значений ключей выполняют аналогичные функции, при выборе выбранной функции следует учитывать несколько различий.
Пары "Ключевые значения" доступны только с моделями макетов и счетов. Если вы хотите расширить схему для предварительно созданной модели, используйте поля запроса.
Вы не знаете, какие поля нужно извлечь, или количество полей большое (больше 20), пары значений ключей могут быть лучшим решением.
Пары "ключ-значение" извлекают ключи и значения, как они существуют в форме или документе, необходимо спланировать любые варианты ключей. Например, ключи
First NameилиGiven Name. При использовании полей запроса вы определяете ключ и модель извлекает только соответствующее значение.Используйте поля запроса, если необходимое значение не может быть описано как пара значений ключа в документе. Например, дата соглашения контракта.
Для извлечения полей запроса укажите поля, которые необходимо извлечь, и аналитика документов анализирует документ соответствующим образом. Приведем пример:
Если вы обрабатываете контракт в Студии аналитики документов, используйте
2024-02-29-previewверсию API ,2023-10-31-previewили более позднюю версию API:
Вы можете передать список меток полей, например
Party1,Party2,TermsOfUse,PaymentTermsPaymentDateиTermEndDate" в рамкахAnalyzeDocumentзапроса.
В дополнение к полям запроса ответ включает выходные данные модели. Список функций или схем, извлеченных каждой моделью, см. в разделе "Анализ моделей".
Запрос REST API полей запроса**
Используйте функцию полей запроса с общей моделью документа и добавьте поля в процесс извлечения без необходимости обучения пользовательской модели:
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"
}