このコンテンツは次に適用されます:🟥v2.1 | 最新バージョン:🟪v4.0 (GA)
重要
v4.0 2024-11-30 (GA) model compose 操作では、分析用の暗黙的な分類子ではなく、明示的にトレーニングされた分類子が追加されます。 以前の構成済みモデル バージョンについては、「構成済みカスタム モデル v3.1 」を参照してください 。 現在、構成済みモデルを使用している場合は、最新の実装にアップグレードすることを検討してください。
構成済みモデルとは
構成済みモデルでは、1 つのモデル ID で呼び出された構成済みモデルに複数のカスタム モデルをグループ化できます。 たとえば、構成済みモデルには、供給、機器、家具の発注書を分析するためにトレーニングされたカスタム モデルが含まれる場合があります。 適切なモデルを手動で選択する代わりに、構成済みのモデルを使用して、各分析と抽出に適したカスタム モデルを決定できます。
一部のシナリオでは、最初にドキュメントを分類してから、モデルからフィールドを抽出するのに最適なモデルを使用してドキュメントを分析する必要があります。 このようなシナリオには、ユーザーがドキュメントをアップロードしたものの、ドキュメントの種類が明示的に不明なシナリオが含まれる場合があります。 別のシナリオとして、複数のドキュメントが 1 つのファイルにまとめてスキャンされ、処理のためにファイルが送信される場合があります。 アプリケーションでは、コンポーネント ドキュメントを識別し、各ドキュメントに最適なモデルを選択する必要があります。
以前のバージョンでは、 model compose 操作によって暗黙的な分類が実行され、送信されたドキュメントを最もよく表すカスタム モデルが決定されました。
操作の model compose 実装は、以前のバージョンからの暗黙的な分類を明示的な分類手順に置き換え、条件付きルーティングを追加します。
新しいモデル作成操作の利点
新しい model compose 操作では、明示的な分類子をトレーニングする必要があり、いくつかの利点があります。
継続的な漸進的改善。 サンプルを追加し、 分類を段階的に改善することで、分類子の品質を一貫して向上させることができます。 この微調整により、ドキュメントが抽出に適したモデルに常にルーティングされるようになります。
ルーティングを完全に制御します。 信頼度ベースのルーティングを追加することで、ドキュメントの種類と分類応答の信頼度しきい値を指定します。
操作中にドキュメント固有のドキュメントの種類を無視します。
model compose操作の以前の実装では、最も高い信頼度スコアが比較的低い場合でも、信頼度スコアに基づいて抽出に最適な分析モデルが選択されました。 信頼度しきい値を指定するか、既知のドキュメントの種類を分類から抽出モデルに明示的にマッピングしないことで、特定のドキュメントの種類を無視できます。同じドキュメントの種類の複数のインスタンスを分析します。 分類子の
splitModeオプションと組み合わせて使用すると、model compose操作では、ファイル内の同じドキュメントの複数のインスタンスを検出し、ファイルを分割して各ドキュメントを個別に処理できます。splitModeを使用すると、1 つの要求でドキュメントの複数のインスタンスを処理できます。アドオン機能のサポート。 クエリ フィールドやバーコードなどの機能に対する追加は、分析モデル パラメーターの一部として指定することもできます。
割り当てられたカスタム モデルの最大数は 500 に拡張されました。
model compose操作の新しい実装により、1 つの構成済みモデルに最大 500 個のトレーニング済みカスタム モデルを割り当てることができます。
モデルコンポーズの使い方
まず、抽出または無視する必要がある情報を含む、必要なすべてのドキュメントのサンプルを収集します。
分類子をトレーニングするには、作成したモデル定義で使用するドキュメントの種類がフォルダー名であるフォルダー内のドキュメントを整理します。
最後に、使用するドキュメントの種類ごとに抽出モデルをトレーニングします。
分類モデルと抽出モデルをトレーニングしたら、Document Intelligence Studio、クライアント ライブラリ、または REST API を 使用して、分類モデルと抽出モデルを構成済みのモデルに構成します。
splitMode パラメーターを使用して、ファイル分割の動作を制御します。
- なし。 ファイル全体が 1 つのドキュメントとして扱われます。
- perPage。 ファイル内の各ページは、個別のドキュメントとして扱われます。
- auto.ファイルは自動的にドキュメントに分割されます。
課金と価格
構成済みモデルは、個々のカスタム モデルと同じように課金されます。 価格は、ダウンストリーム分析モデルによって分析されたページの数に基づきます。 課金は、抽出モデルにルーティングされたページの抽出価格に基づきます。 分類を明示的に追加することで、入力ファイル内のすべてのページの分類に対する料金が発生します。 詳細については、「 ドキュメント インテリジェンスの価格」ページを参照してください。
モデル作成操作を使用する
まず、単一のモデルに組み込むために必要なすべてのモデル ID の一覧を作成します。
Studio、REST API、またはクライアント ライブラリを使用して、モデルを 1 つのモデル ID に作成します。
作成されたモデル ID を使用してドキュメントを分析します。
請求
構成済みモデルは、個々のカスタム モデルと同じように課金されます。 価格は、分析されたページ数に基づいています。 課金は、抽出モデルにルーティングされたページの抽出価格に基づきます。 詳細については、「 ドキュメント インテリジェンスの価格」ページを参照してください。
- 個々のカスタム モデルまたは構成されたカスタム モデルを使用してドキュメントを分析するための価格に変更はありません。
構成済みモデルの機能
Custom templateモデルとcustom neuralモデルは、複数の API バージョンにわたって 1 つの構成済みモデルにまとめて構成できます。応答には、作成されたモデルのうち、ドキュメントの分析に使用されたモデルを示す
docTypeプロパティが含まれています。custom templateモデルの場合、カスタム テンプレートまたは異なるフォームの種類のバリエーションを使用して、作成されたモデルを作成できます。 この操作は、受信フォームが複数のテンプレートのいずれかに属している場合に便利です。custom neuralモデルの場合、ベスト プラクティスは、1 つのドキュメントの種類のすべての異なるバリエーションを 1 つのトレーニング データセットに追加し、カスタム ニューラル モデルでトレーニングすることです。model compose操作は、さまざまな種類のドキュメントを分析用に送信するシナリオに最適です。
モデルの制限を作成する
model compose操作では、1 つのモデル ID に最大 500 個のモデルを割り当てることができます。 作成するモデルの数が構成済みモデルの上限を超える場合は、次のいずれかの方法を使用できます。カスタム モデルを呼び出す前にドキュメントを分類します。 コード、正規表現、検索などのソースを使用して、 読み取りモデル を使用し、ドキュメントから抽出されたテキストと特定のフレーズに基づいて分類を作成できます。
さまざまな構造化ドキュメント、半構造化ドキュメント、非構造化ドキュメントから同じフィールドを抽出する場合は、ディープ ラーニング カスタム ニューラル モデルの使用を検討してください。 カスタム テンプレート モデルとカスタム ニューラル モデルの違いの詳細について説明します。
構成済みモデルを使用してドキュメントを分析することは、1 つのモデルを使用してドキュメントを分析するのと同じです。
Analyze Document結果は、ドキュメントを分析するために選択したコンポーネント モデルを示すdocTypeプロパティを返します。model compose操作は現在、ラベルでトレーニングされたカスタム モデルでのみ使用できます。
構成済みモデルの互換性
| カスタム モデルの種類 | v2.1 および v2.0 でトレーニングされたモデル | カスタム テンプレートモデルとニューラル モデル v3.1 および v3.0 | カスタム テンプレートモデルとニューラル モデル v4.0 2024-11-30 (GA) |
|---|---|---|---|
| バージョン 2.1 および v2.0 でトレーニングされたモデル | サポートされていません | サポートされていません | サポートされていません |
| カスタム テンプレートモデルとニューラル モデル v3.0 および v3.1 | サポートされていません | サポートされています | サポートされています |
| カスタム テンプレートとニューラル モデル v4.0 | サポートされていません | サポートされています | サポートされています |
以前のバージョンの API (v2.1 以前) でトレーニングされたモデルを作成するには、同じラベル付きデータセットを使用して v3.0 API でモデルをトレーニングします。 さらに、v2.1 モデルを他のモデルと共に構成できます。
v2.1 の API を使用して構成されたモデルは引き続きサポートされ、更新は必要ありません。
開発オプション
ドキュメント インテリジェンス v4.0:2024-11-30 (GA) では、次のツール、アプリケーション、およびライブラリがサポートされています。
| 機能 | リソース |
|---|---|
| カスタム モデル | • Document Intelligence Studio • REST API • C# SDK • Java SDK • JavaScript SDK • Python SDK |
| 構成済みモデル | • Document Intelligence Studio • REST API • C# SDK • Java SDK • JavaScript SDK • Python SDK |
ドキュメント インテリジェンス v3.1:2023-07-31 (GA) では、次のツール、アプリケーション、およびライブラリがサポートされています。
| 機能 | リソース |
|---|---|
| カスタム モデル | • Document Intelligence Studio • REST API • C# SDK • Java SDK • JavaScript SDK • Python SDK |
| 構成済みモデル | • Document Intelligence Studio • REST API • C# SDK • Java SDK • JavaScript SDK • Python SDK |
ドキュメント インテリジェンス v3.0:2022-08-31 (GA) では、次のツール、アプリケーション、およびライブラリがサポートされています。
| 機能 | リソース |
|---|---|
| カスタム モデル | • Document Intelligence Studio • REST API • C# SDK • Java SDK • JavaScript SDK • Python SDK |
| 構成済みモデル | • Document Intelligence Studio • REST API • C# SDK • Java SDK • JavaScript SDK • Python SDK |
ドキュメント インテリジェンス v2.1 では、次のリソースがサポートされています。
| 機能 | リソース |
|---|---|
| カスタム モデル | • ドキュメント インテリジェンス ラベル付けツール • REST API • クライアント ライブラリ SDK • ドキュメント インテリジェンス Docker コンテナー |
| 構成済みモデル | • Document Intelligence ラベル付けツール • REST API • C# SDK • Java SDK • JavaScript SDK • Python SDK |
次の手順
カスタムモデルを作成し、構成する方法を学びます。