Levenscyclus van aangepaste modellen voor Document Intelligence

Artikel
12/12/2024

Deze inhoud is van toepassing op:v4.0 (GA)v3.1 (GA)

Met de API's v3.1 (GA) en hoger introduceren aangepaste modellen een expirationDateTime-eigenschap die is ingesteld voor elk model dat is getraind met de 3.1 API of hoger. Aangepaste modellen zijn afhankelijk van de API-versie van de layout-API-versie en de API-versie van de buildbewerking van het model. Voor de beste resultaten blijft u de API-versie gebruiken waarmee het model is getraind voor alle analyseaanvragen. De richtlijnen zijn van toepassing op alle aangepaste Document Intelligence-modellen, inclusief extractie- en classificatiemodellen.

Modellen die zijn getraind met ga-API-versie

Met de v3.1-API introduceren aangepaste modellen een nieuwe modelverloopeigenschap. De vervaldatum van het model is ingesteld op twee jaar vanaf de datum waarop het model is gebouwd voor alle aanvragen die een GA-API gebruiken om een model te bouwen. Als u het model na de vervaldatum wilt blijven gebruiken, moet u het model trainen met een huidige GA API-versie. De API-versie kan het model zijn dat oorspronkelijk is getraind met of een latere API-versie. In de volgende afbeelding ziet u de opties wanneer u een verlopend of verlopen model opnieuw moet trainen.

Schermopname van het kiezen van een API-versie en het opnieuw trainen van een model.

Modellen die zijn getraind met preview-API-versie

Voor buildaanvragen, met behulp van een preview-API-versie, wordt de vervaldatum ingesteld op twee jaar vanaf de datum waarop het model is gebouwd. Modellen die zijn getraind met een preview-API, mogen niet worden gebruikt in productie en moeten opnieuw worden getraind zodra de bijbehorende GA-API-versie beschikbaar is. Compatibiliteit tussen preview-API-versies en GA-API-versies wordt niet altijd onderhouden. Modellen die zijn getraind met een preview-API-versie, kunnen niet meer worden gebruikt. De bijbehorende GA-API is beschikbaar.

Vervaldatum van model weergeven

De GET-model-API retourneert de modeldetails, inclusief de expirationDateTime eigenschap.

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": { ... }
}

Een model opnieuw trainen

Als u een model opnieuw wilt trainen met een recentere API-versie, moet u ervoor zorgen dat de indelingsresultaten voor de documenten in uw trainingsgegevensset overeenkomen met de API-versie van de aanvraag voor het buildmodel. Als u bijvoorbeeld van plan bent om het model te bouwen met de v3.1:2023-07-31 API-versie, moeten de bijbehorende *.ocr.json-bestanden in uw trainingsgegevensset ook worden gegenereerd met de v3.1:2023-07-31 API-versie. De ocr.json bestanden worden gegenereerd door de indeling uit te voeren op uw trainingsgegevensset. Als u de versie van de indelingsresultaten wilt valideren, controleert u de apiVersion eigenschap in de analyzeResult ocr.json documenten.

Volgende stappen

Meer informatie over het maken en opstellen van aangepaste modellen:

Aangepaste modellensamenstellen

Delen via