문서 인텔리전스 사용자 지정 모델 수명 주기
이 콘텐츠는 
v4.0(GA) v3.1(GA)에 적용됩니다.
v3.1(GA) 이상 API를 사용하면 사용자 지정 모델에 3.1 API 이상으로 학습된 각 모델에 대해 설정되는 expirationDateTime 속성이 도입됩니다. 사용자 지정 모델은 Layout API 버전의 API 버전과 모델 빌드 작업의 API 버전에 따라 달라집니다. 최상의 결과를 얻으려면 모든 분석 요청에 대해 모델이 학습된 API 버전을 계속 사용하세요. 이 지침은 추출 및 분류 모델을 포함한 모든 문서 인텔리전스 사용자 지정 모델에 적용됩니다.
GA API 버전으로 학습된 모델
v3.1 API를 사용하면 사용자 지정 모델에 새로운 모델 만료 속성이 도입됩니다. 모델 만료는 GA API를 사용하여 모델을 빌드하는 모든 요청에 대해 모델이 빌드된 날짜로부터 2년으로 설정됩니다. 만료 날짜가 지난 모델을 계속 사용하려면 현재 GA API 버전으로 모델을 학습시켜야 합니다. API 버전은 모델이 원래 학습되었거나 이후의 API 버전일 수 있습니다. 다음 그림에서는 만료되거나 만료된 모델을 다시 학습해야 하는 경우의 옵션을 보여 줍니다.
미리 보기 API 버전으로 학습된 모델
빌드 요청의 경우 미리 보기 API 버전을 사용하여 만료 날짜는 모델이 빌드된 날짜로부터 2년으로 설정됩니다. 미리 보기 API로 학습된 모델은 프로덕션에서 사용해서는 안 되며 해당 GA API 버전을 사용할 수 있게 되면 다시 학습해야 합니다. 미리 보기 API 버전과 GA API 버전 간의 호환성이 항상 유지되는 것은 아닙니다. 미리 보기 API 버전으로 학습된 모델은 더 이상 사용할 수 없으며 해당 GA API를 사용할 수 있습니다.
모델 만료 날짜 보기
GET 모델 API는 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": { ... }
}
모델 재교육
최신 API 버전으로 모델을 다시 학습하려면 학습 데이터 세트에 있는 문서의 레이아웃 결과가 모델 빌드 요청의 API 버전과 일치하는지 확인하세요. 예를 들어, v3.1:2023-07-31 API 버전으로 모델을 빌드하려는 경우 학습 데이터세트의 해당 *.ocr.json 파일도 v3.1:2023-07-31 API 버전으로 생성되어야 합니다. ocr.json 파일은 학습 데이터 세트에서 레이아웃을 실행하여 생성됩니다. 레이아웃 결과 버전의 유효성을 검사하려면 ocr.json 문서의 analyzeResult에서 apiVersion 속성을 확인하세요.
다음 단계
사용자 지정 모델을 만들고 구성하는 방법을 알아봅니다.