このコンテンツの適用対象:
v4.0 (GA)v3.1 (GA)
v3.1 (GA) 以降の API では、カスタム モデルでは、3.1 API 以降でトレーニングされた各モデルに設定された expirationDateTime プロパティが導入されます。 カスタム モデルは、Layout API バージョンの API バージョンとモデル構築操作の API バージョンに依存します。 最良の結果を得るには、すべての分析要求に対してモデルがトレーニングされた API バージョンを引き続き使用します。 このガイダンスは、抽出および分類モデルを含む、Document Intelligence のすべてのカスタム モデルに適用されます。
GA API バージョンでトレーニングされたモデル
v3.1 API では、カスタム モデルに新しいモデルの有効期限プロパティが導入されています。 モデルは、GA API を使用して構築するすべての要求の作成から 2 年後に有効期限が切れるよう構成されています。 API バージョンは、最初にモデルのトレーニングに使用されたバージョンか、それ以降の API バージョンになります。 次の図は、期限が終了しそうな、または期限切れのモデルを再トレーニングする必要がある場合の、各オプションを示しています。
注: v3.1/4.0 モデルのモデルの有効期限は、v3.1/v4.0 のリリース後にトレーニングが完了した場合にのみ設定されます。 モデルが以前に作成され、有効期限が関連付けされておらず、v3.1/v4.0 より後に再トレーニングされなかった場合、有効期限は null になります。 有効期限プロパティを持つモデルは、API が廃止されるまで引き続き使用できます。 特定の GA API バージョンの提供終了の通知は、有効期限の少なくとも 3 年前に通知されます。
プレビュー API バージョンでトレーニングされたモデル
構築要求の場合、プレビュー API バージョンを使用すると、有効期限はモデルが構築された日から 2 年に設定されます。 プレビュー API でトレーニングされたモデルは運用環境では使用しないでください。対応する GA API バージョンが使用可能になったら、再トレーニングする必要があります。 プレビュー API バージョンと GA API バージョンの互換性は、常に維持されるとは限りません。 プレビュー API バージョンでトレーニングされたモデルは、対応する GA API が利用可能になると使用できなくなります。
モデルの有効期限の表示
モデルの取得 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 バージョンに対応していることを確認します。 たとえば、API バージョン v3.1:2023-07-31 を使用してモデルを構築する予定の場合は、トレーニング データセット内の対応する *.ocr.json ファイルも API バージョン v3.1:2023-07-31 で生成されている必要があります。 ocr.json ファイルは、トレーニング データセットでレイアウトを実行すると生成されます。 レイアウト結果のバージョンを検証するには、ocr.json ドキュメントの apiVersion で analyzeResult プロパティを確認します。
次のステップ
カスタム モデルの作成について学習します。