Livscykel för anpassad dokumentinformationsmodell

Det här innehållet gäller för:v4.0 (förhandsversion)v3.1 (GA)

Med v3.1 (GA) och senare API:er introducerar anpassade modeller en expirationDateTime-egenskap som har angetts för varje modell som tränats med 3.1-API:et eller senare. Anpassade modeller är beroende av API-versionen av layout-API-versionen och API-versionen av modellbyggåtgärden. För bästa resultat fortsätter du att använda DEN API-version som modellen tränades med för alla analysbegäranden. Vägledningen gäller för alla anpassade modeller för dokumentinformation, inklusive extraherings- och klassificeringsmodeller.

Modeller som tränats med GA API-version

Med v3.1-API:et introducerar anpassade modeller en ny modellförfalloegenskap. Modellens giltighetstid är inställd på två år från det datum då modellen skapas för alla begäranden som använder ett GA-API för att skapa en modell. Om du vill fortsätta att använda modellen efter förfallodatumet måste du träna modellen med en aktuell GA API-version. API-versionen kan vara den som modellen ursprungligen tränades med eller en senare API-version. Följande bild illustrerar alternativen när du behöver träna om en modell som upphör att gälla eller har upphört att gälla.

Modeller som tränats med förhandsversion av API

För byggbegäranden, med hjälp av en förhandsversion av API:et, anges förfallodatumet till tre månader från det datum då modellen skapades. Modeller som tränats med ett förhandsversions-API bör inte användas i produktion och bör tränas om när motsvarande GA API-version är tillgänglig. Kompatibilitet mellan förhandsversioner av API-förhandsversioner och GA API-versioner bibehålls inte alltid. Du bör förvänta dig att modeller som tränats med en förhandsversion av API:et inte kan användas när förhandsgransknings-API:et har dragits tillbaka.

Förhandsversions-API:er dras vanligtvis tillbaka inom tre månader efter att motsvarande GA-API är tillgängligt.

Visa modellens förfallodatum

GET-modell-API:et returnerar modellinformationen expirationDateTime inklusive egenskapen .

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

Träna en modell igen

Om du vill träna om en modell med en nyare API-version kontrollerar du att layoutresultaten för dokumenten i din träningsdatauppsättning motsvarar API-versionen av begäran om byggmodell. Om du till exempel planerar att skapa modellen med v3.1:2023-07-31 API-versionen bör motsvarande *.ocr.json-filer i din träningsdatauppsättning också genereras med v3.1:2023-07-31 API-versionen. De ocr.json filerna genereras genom att du kör layouten på din träningsdatauppsättning. Om du vill verifiera versionen av layoutresultatet apiVersion kontrollerar du egenskapen i analyzeResult ocr.json dokument.

Nästa steg

Lär dig hur du skapar och skapar anpassade modeller:

Skapa en anpassad modellSkapa anpassade modeller