Ciclo di vita del modello personalizzato di Informazioni sui documenti

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. Il modello è configurato per scadere due anni dopo la creazione per tutte le richieste che usano un'API ga per compilarla. 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.

Nota: la data di scadenza del modello per i modelli v3.1/4.0 viene impostata solo se il training viene eseguito dopo la versione 3.1/v4.0. Se i modelli sono stati creati in precedenza senza data di scadenza associata e non sono stati sottoposti a training dopo la versione 3.1/v4.0, la data di scadenza sarà Null. I modelli con proprietà data di scadenza saranno ancora disponibili fino al ritiro dell'API. La notifica del ritiro di una determinata versione dell'API GA verrà comunicata almeno 3 anni prima della scadenza.

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

Per le richieste di compilazione, usando una versione dell'API di anteprima, la data di scadenza viene impostata su due anni dalla data in cui viene compilato il 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. I modelli sottoposti a training con una versione dell'API di anteprima non sono più utilizzabili dall'API ga corrispondente.

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: