Ciclo di vita del modello personalizzato di Informazioni sui documenti

Questo contenuto si applica a: v4.0 (anteprima) v3.1 (disponibilità generale)

Con le API v3.1 (disponibilità generale) e versioni successive, i modelli personalizzati introducono una proprietà expirationDateTime impostata per ogni modello sottoposto a training con l'API 3.1 o versioni successive. I modelli personalizzati dipendono dalla versione dell'API della versione dell'API Layout e dalla versione dell'API dell'operazione di compilazione del modello. Per ottenere risultati ottimali, continuare a usare la versione dell'API con cui è stato eseguito il training del modello per tutte le richieste di analisi. Le linee guida si applicano a tutti i modelli personalizzati di Informazioni sui documenti, inclusi i modelli di estrazione e di classificazione.

Modelli sottoposti a training con la versione dell'API di disponibilità generale

Con l'API v3.1, i modelli personalizzati introducono una nuova proprietà di scadenza del modello. La scadenza del modello è impostata su due anni dalla data in cui il modello è stato compilato per tutte le richieste che usano un'API di disponibilità generale per compilare il modello. Per continuare a usare il modello oltre la data di scadenza, è necessario eseguire il training del modello con una versione corrente dell'API di disponibilità generale. La versione dell'API può essere quella con cui è stato originariamente eseguito il training del modello o una versione successiva. La figura seguente illustra le opzioni disponibili quando è necessario ripetere il training di un modello in scadenza o scaduto.

Modelli sottoposti a training con la versione di anteprima dell'API

Per le richieste di compilazione, quando si usa una versione dell'API di anteprima, la data di scadenza viene impostata su tre mesi dalla data di compilazione del modello. I modelli sottoposti a training con un'API di anteprima non devono essere usati nell'ambiente di produzione e devono essere sottoposti a training una volta disponibile la versione corrispondente dell'API di disponibilità generale. La compatibilità tra le versioni dell'API di anteprima e le versioni dell'API di disponibilità generale non è sempre gestita. È consigliabile prevedere che i modelli sottoposti a training con una versione di anteprima dell'API non siano utilizzabili dopo il ritiro dell'API stessa.

Le API di anteprima vengono in genere ritirate entro tre mesi dalla disponibilità della relativa API di disponibilità generale.

Visualizzazione della data di scadenza del modello

L'API del modello GET restituisce i dettagli del modello, inclusa la proprietà 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": { ... }
}

Ripetere il training di un modello

Per ripetere il training di un modello con una versione più recente dell'API, assicurarsi che i risultati del layout per i documenti nel set di dati di training corrispondano alla versione dell'API della richiesta del modello di compilazione. Ad esempio, se si prevede di compilare il modello con la versione dell'API v3.1:2023-07-31, è necessario generare anche i file *.ocr.json corrispondenti nel set di dati di training con la versione dell'API v3.1:2023-07-31. I file ocr.json vengono generati eseguendo il layout nel set di dati di training. Per convalidare la versione dei risultati del layout, controllare la proprietà apiVersion in analyzeResult dei documenti ocr.json.

Passaggi successivi

Informazioni su come creare e comporre modelli personalizzati:

Creare un modello personalizzato Comporre modelli personalizzati