Livscykel för anpassad dokumentinformationsmodell

Artikel
10/16/2024

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.

Skärmbild som visar hur du väljer en API-version och tränar om en modell.

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 modell Skapa anpassade modeller

Dela via