Ciclo de vida del modelo personalizado de Document Intelligence

Este contenido se aplica a: v4.0 (versión preliminar) v3.1 (GA)

Con la API v3.1 (GA) y posteriores, los modelos personalizados presentan una propiedad expirationDateTime que se establece para cada modelo entrenado con la API 3.1 o posterior. Los modelos personalizados dependen de la versión de api de la versión de la API de diseño y de la versión de API de la operación de compilación del modelo. Para obtener mejores resultados, siga usando la versión de API con la que se entrenó el modelo para todas las solicitudes analyze. La guía se aplica a todos los modelos personalizados de Document Intelligence, incluidos los modelos de extracción y clasificación.

Modelos entrenados con la versión de la API de disponibilidad general

Con la API v3.1, los modelos personalizados presentan una nueva propiedad de expiración del modelo. La expiración del modelo se establece en dos años a partir de la fecha en que se compila el modelo para todas las solicitudes que usan una API de disponibilidad general para compilar un modelo. Para seguir usando el modelo después de la fecha de expiración, tiene que entrenar el modelo con una versión de API de disponibilidad general actual. La versión de API puede ser aquella con la que el modelo se entrenó originalmente o una versión de API posterior. En la ilustración siguiente se muestran las opciones que hay cuando tiene que volver a entrenar un modelo expirado o que expira próximamente.

Modelos entrenados con la versión preliminar de la API

En el caso de las solicitudes de compilación, con una versión preliminar de la API, la fecha de expiración se establece en tres meses a partir de la fecha en que se compila el modelo. Los modelos entrenados con una API en versión preliminar no se deben usar en producción y deben volver a entrenarse una vez que esté disponible la versión de la API de disponibilidad general correspondiente. La compatibilidad entre las versiones preliminares de la API y las versiones de API de disponibilidad general no siempre se mantiene. Debería esperar que los modelos entrenados con una versión preliminar de la API no se puedan usar una vez retirada la API de versión preliminar.

Las API de versión preliminar se suelen retirar en un plazo de tres meses a partir de que la API de disponibilidad general correspondiente esté disponible.

Visualización de la fecha de expiración del modelo

La API del modelo GET devuelve los detalles del modelo, incluida la propiedad 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": { ... }
}

Volver a entrenar un modelo

Para volver a entrenar un modelo con una versión de API más reciente, asegúrese de que los resultados de diseño de los documentos del conjunto de datos de entrenamiento corresponden a la versión de API de la solicitud del modelo de compilación. Por ejemplo, si planea construir el modelo con la versión API v3.1:2023-07-31, los archivos *.ocr.json correspondientes en su conjunto de datos de entrenamiento también deben generarse con la versión API v3.1:2023-07-31. Los archivos ocr.json se generan mediante la ejecución del diseño en el conjunto de datos de entrenamiento. Para validar la versión de los resultados del diseño, verifique la propiedad apiVersion en analyzeResult de los documentos ocr.json.

Pasos siguientes

Aprenda a crear y componer modelos personalizados:

Crear un modelo personalizado Crear modelos personalizados