Жизненный цикл пользовательской модели аналитики документов

С помощью API версии 3.1 (GA) и более поздних версий пользовательские модели представляют свойство dateDateTime, установленное для каждой модели, обученной с помощью API 3.1 или более поздней версии. Пользовательские модели зависят от версии API версии API макета и версии API операции сборки модели. Для получения наилучших результатов продолжайте использовать версию API, с которым была обучена модель для всех запросов анализа. Руководство применяется ко всем пользовательским моделям аналитики документов, включая модели извлечения и классификации.

Модели, обученные с использованием версии API общедоступной версии

В API версии 3.1 пользовательские модели представляют новое свойство срока действия модели. Срок действия модели устанавливается на два года с даты создания модели для всех запросов, использующих API общедоступной версии для создания модели. Чтобы продолжить использовать модель после даты окончания срока действия, необходимо обучить модель с текущей версией API общедоступной версии. Версия API может быть той, которая была первоначально обучена моделью с или более поздней версией API. На следующем рисунке показаны параметры, когда необходимо переобучить модель с истекающим сроком действия или истекшим сроком действия.

Модели, обученные с помощью предварительной версии API

Для запросов на сборку, используя предварительную версию API, срок действия устанавливается на два года с даты создания модели. Модели, обученные с помощью API предварительной версии, не должны использоваться в рабочей среде и должны быть переобучены после того, как доступна соответствующая версия API общедоступной версии. Совместимость между версиями API предварительной версии и версиями API общедоступной версии не всегда поддерживается. Модели, обученные с помощью предварительной версии API, больше не доступны для использования соответствующего ОБЩЕДОСТУПНОго API.

Просмотр даты окончания срока действия модели

API модели GET возвращает сведения о модели, включая expirationDateTime свойство.

GET /documentModels/{customModelId}?api-version={apiVersion}
{
  "modelId": "{customModelId}",
  "description": "{customModelDescription}",
  "createdDateTime": "2021-09-24T12:54:35Z",
  "expirationDateTime": "2023-01-01T00:00:00Z",
  "apiVersion": "2023-07-31",
  "docTypes": { ... }
}

Повторное обучение модели

Чтобы переобучить модель с более последней версией API, убедитесь, что результаты макета документов в обучаемом наборе данных соответствуют версии API запроса модели сборки. Например, если вы планируете создать модель с v3.1:2023-07-31 версией API, соответствующие файлы *.ocr.json в обучаемом v3.1:2023-07-31 наборе данных также должны быть созданы с помощью версии API. Файлы ocr.json создаются путем выполнения макета в обучаемом наборе данных. Чтобы проверить версию результатов макета, проверьте apiVersion свойство в analyzeResult ocr.json документах.

Следующие шаги

Создание и объединение настраиваемых моделей: