Cykl życia niestandardowego modelu analizy dokumentów

W przypadku interfejsów API w wersji 3.1 (GA) i nowszych modele niestandardowe wprowadzają właściwość expirationDateTime ustawioną dla każdego modelu trenowanego przy użyciu interfejsu API 3.1 lub nowszego. Modele niestandardowe są zależne od wersji interfejsu API układu i wersji interfejsu API operacji kompilacji modelu. Aby uzyskać najlepsze wyniki, kontynuuj korzystanie z wersji interfejsu API, z użyciem którego model został wytrenowany dla wszystkich żądań analizy. Wskazówki dotyczą wszystkich modeli niestandardowych analizy dokumentów, w tym modeli wyodrębniania i klasyfikacji.

Modele trenowane przy użyciu wersji interfejsu API ogólnie dostępnego

W przypadku interfejsu API w wersji 3.1 modele niestandardowe wprowadzają nową właściwość wygasania modelu. Wygaśnięcie modelu jest ustawione na dwa lata od daty utworzenia modelu dla wszystkich żądań, które używają interfejsu API ga do tworzenia modelu. Aby nadal używać modelu po dacie wygaśnięcia, należy wytrenować model przy użyciu bieżącej wersji interfejsu API ogólnie dostępnej. Wersja interfejsu API może być wersją, którą model został pierwotnie wytrenowany z lub nowszą wersją interfejsu API. Na poniższej ilustracji przedstawiono opcje, gdy trzeba ponownie wytrenować wygasający lub wygasły model.

Modele wytrenowane przy użyciu wersji interfejsu API w wersji zapoznawczej

W przypadku żądań kompilacji przy użyciu wersji interfejsu API w wersji zapoznawczej data wygaśnięcia jest ustawiona na trzy miesiące od daty skompilowania modelu. Modele trenowane za pomocą interfejsu API w wersji zapoznawczej nie powinny być używane w środowisku produkcyjnym i powinny być ponownie trenowane po udostępnieniu odpowiedniej wersji interfejsu API ga. Zgodność między wersjami interfejsu API w wersji zapoznawczej i wersjami interfejsu API ogólnie dostępnego nie zawsze jest zachowywana. Po wycofaniu interfejsu API w wersji zapoznawczej należy oczekiwać, że modele wytrenowane przy użyciu wersji zapoznawczej interfejsu API nie będą używane.

Interfejsy API w wersji zapoznawczej są zwykle wycofywane w ciągu trzech miesięcy od udostępnienia odpowiedniego interfejsu API ga.

Wyświetlanie daty wygaśnięcia modelu

Interfejs API modelu GET zwraca szczegóły modelu, w tym expirationDateTime właściwość .

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

Ponowne trenowanie modelu

Aby ponownie wytrenować model przy użyciu nowszej wersji interfejsu API, upewnij się, że wyniki układu dokumentów w zestawie danych szkoleniowych odpowiadają wersji interfejsu API żądania modelu kompilacji. Jeśli na przykład planujesz skompilować model przy użyciu wersji interfejsu v3.1:2023-07-31 API, odpowiednie pliki *.ocr.json w zestawie danych szkoleniowych powinny być również generowane przy użyciu wersji interfejsu v3.1:2023-07-31 API. Pliki ocr.json są generowane przez uruchomienie układu w zestawie danych trenowania. Aby zweryfikować wersję wyników układu, sprawdź apiVersion właściwość w analyzeResult dokumentach ocr.json.

Następne kroki

Dowiedz się, jak tworzyć i tworzyć modele niestandardowe: