Document Intelligence のカスタム モデルのライフサイクル

このコンテンツの適用対象: v4.0 (プレビュー)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 年間に設定されます。 有効期限を過ぎたモデルを引き続き使用するには、現在の GA API バージョンでモデルをトレーニングする必要があります。 API バージョンは、最初にモデルのトレーニングに使用されたバージョンか、それ以降の API バージョンになります。 次の図は、期限が終了しそうな、または期限切れのモデルを再トレーニングする必要がある場合の、各オプションを示しています。

プレビュー API バージョンでトレーニングされたモデル

構築要求の場合、プレビュー API バージョンを使用すると、有効期限はモデルが構築された日から 3 か月に設定されます。 プレビュー API でトレーニングされたモデルは運用環境では使用しないでください。対応する GA API バージョンが使用可能になったら、再トレーニングする必要があります。 プレビュー API バージョンと GA API バージョンの互換性は、常に維持されるとは限りません。 プレビュー API が廃止されると、プレビュー API バージョンでトレーニングされたモデルは使用できなくなることを想定しておく必要があります。

プレビュー API は通常、対応する GA API が利用できるようになってから 3 か月以内に廃止されます。

モデルの有効期限の表示

モデルの取得 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 ドキュメントの analyzeResult で apiVersion プロパティを確認します。

次のステップ

カスタム モデルの作成について学習します。

カスタム モデルを構築する カスタム モデルを作成する