Cycle de vie du modèle personnalisé Document Intelligence

Article
10/16/2024

Ce contenu s’applique à : v4.0 (préversion) v3.1 (GA)

Avec les API v3.1 (GA) et ultérieures, les modèles personnalisés introduisent une propriété expirationDateTime définie pour chaque modèle entraîné avec l’API 3.1 ou ultérieure. Les modèles personnalisés dépendent de la version d’API de l’API Disposition et de la version de l’API de l’opération de génération de modèle. Pour obtenir de meilleurs résultats, continuez à utiliser la version de l’API avec laquelle le modèle a été entraîné pour toutes les demandes d’analyse. Les conseils s’appliquent à tous les modèles personnalisés Document Intelligence, y compris les modèles d’extraction et de classification.

Modèles entraînés avec la version de l’API GA

Avec l’API v3.1, les modèles personnalisés introduisent une nouvelle propriété d’expiration de modèle. L’expiration du modèle est définie sur deux ans à compter de la date de génération du modèle pour toutes les demandes qui utilisent une API ga pour générer un modèle. Pour continuer à utiliser le modèle après la date d’expiration, vous devez entraîner le modèle avec une version actuelle de l’API en disponibilité générale. La version de l’API peut être celle avec laquelle le modèle a été initialement entraîné ou une version ultérieure. L’illustration suivante illustre les options disponibles lorsque vous devez réentraîner un modèle arrivant à expiration ou ayant expiré.

Capture d’écran montrant comment choisir une version d’API et recycler un modèle.

Modèles entraînés avec la version d’API en préversion

Pour les demandes de build, à l’aide d’une version d’API en préversion, la date d’expiration est définie sur trois mois à compter de la date de génération du modèle. Les modèles entraînés avec une API en préversion ne doivent pas être utilisés en production et doivent être réentraînés une fois que la version de l’API GA correspondante est disponible. La compatibilité entre les versions d’API en préversion et les versions de l’API en disponibilité générale n’est pas toujours maintenue. Vous devez vous attendre à ce que les modèles entraînés avec une version d’API en préversion ne soient pas utilisables une fois l’API d’aperçu supprimée.

Les API en préversion sont généralement mises hors service dans les trois mois suivant la disponibilité de l’API GA correspondante.

Affichage de la date d’expiration du modèle

L’API de modèle GET retourne les détails du modèle, y compris la propriété 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": { ... }
}

Recycler un modèle

Pour réentraîner un modèle avec une version d’API plus récente, assurez-vous que les résultats de disposition des documents de votre jeu de données d’entraînement correspondent à la version de l’API de la demande de modèle de build. Par instance, si vous envisagez de générer le modèle avec la version de l’APIv3.1:2023-07-31, les fichiers *.ocr.json correspondants dans votre jeu de données d’entraînement doivent également être générés avec la version de l’APIv3.1:2023-07-31. Les fichiers ocr.json sont générés en exécutant la disposition sur votre jeu de données d’entraînement. Pour valider la version des résultats de la mise en page, vérifiez la apiVersionpropriété dans les documents ocr.jsonanalyzeResult.

Étapes suivantes

Apprenez à créer et à composer des modèles personnalisés :

Générer un modèle personnalisé Composer des modèles personnalisés

Partage via