文件智慧自訂模型生命週期
此內容適用於： 
v4.0 (預覽版) v3.1 (GA)
在 v3.1 (GA) 及更新版本的 API 中，自訂模型引進了 expiryDateTime 屬性，該屬性是為使用 3.1 API 或更新版本訓練的每個模型設定的。 自訂模型相依於版面配置 API 版本的 API 版本，以及模型建置作業的 API 版本。 為了獲得最佳的結果，請繼續使用模型訓練所使用的 API 版本來處理所有分析要求。 此指南適用於所有文件智慧自訂模型，包括擷取和分類模型。
使用 GA API 版本定型的模型
使用 v3.1 API 時，自訂模型會引進新的模型到期屬性。 對於使用 GA API 建置模型的所有要求，模型到期時間設定為自模型建置日期起的兩年。 若要在過期日期後繼續使用模型，您需要使用目前的 GA API 版本來訓練模型。 API 版本可以是模型最初訓練時使用的 API 版本，也可以是更新版本的 API。 下圖說明了當您需要重新訓練即將到期或已過期的模型時的選項。
使用預覽 API 版本定型的模型
針對使用預覽 API 版本的建置要求，到期日會設定為自模型建置日期起的三個月。 使用預覽 API 定型的模型不應該用於實際執行，且一旦對應的 GA API 版本推出，就應重新定型。 預覽 API 版本與 GA API 版本之間的相容性不一定會保持住。 您應該預期一旦預覽 API 淘汰，使用預覽 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 屬性。
下一步
了解如何建立和撰寫自訂模型：