次の方法で共有


Document Intelligence クエリ フィールドの抽出

**Document Intelligence では、必要な特定のフィールドを抽出するために、事前構築済みモデルのスキーマを拡張するクエリ フィールドがサポートされるようになりました。 クエリ フィールドをレイアウトに追加して、フォームまたはドキュメントからの構造に加えてフィールドを抽出することもできます。

Note

Document Intelligence Studio のクエリ フィールド抽出は現在、レイアウト モデルと事前構築済みモデル (UX.Tax 事前構築済みモデルを除く) で使用できます。

クエリ フィールドまたはキーと値のペア

クエリ フィールドとキーと値のペアは同様の関数を実行しますが、選択する機能を決定する際に注意すべきいくつかの違いがあります。

  • キーと値のペアは、レイアウト モデルと請求書モデルでのみ使用できます。 事前構築済みモデルのスキーマを拡張しようとしている場合は、クエリ フィールドを使用します。

  • 抽出する特定のフィールドがわからない場合、またはフィールドの数が大きい (20 を超える) 場合は、キーと値のペアの方がより適している可能性があります。

  • キーと値のペアによってフォームまたはドキュメントに存在するキーと値が抽出されますが、キーのバリエーションを計画する必要があります。 たとえば、キー First Name または Given Name です。 クエリ フィールドでは、キーを定義しますが、モデルは対応する値のみを抽出します。

  • 必要な値をドキュメント内でキーと値のペアとして記述できない場合は、クエリ フィールドを使用してください。 たとえば、契約の合意日などです。

クエリ フィールド抽出の場合は、抽出するフィールドを指定すると、Document Intelligence により、それに応じてドキュメントが分析されます。 次に例を示します。

  • Document Intelligence Studio で契約を処理する場合は、2024-02-29-preview2023-10-31-preview、またはそれ以降の API バージョンを使用してください。

    Document Intelligence Studio のクエリ フィールド ボタンのスクリーンショット。

  • AnalyzeDocument 要求の一部として、Party1Party2TermsOfUsePaymentTermsPaymentDateTermEndDate などのフィールド ラベルのリストを渡すことができます。

    Document Intelligence Studio のクエリ フィールド選択ウィンドウのスクリーンショット。

  • クエリ フィールドに加えて、応答にはモデルの出力が含まれます。 各モデルによって抽出された機能またはスキーマのリストについては、モデル分析機能参照してください。

クエリ フィールド REST API 要求**

一般的なドキュメント モデルでクエリ フィールド機能を使用して、カスタム モデルをトレーニングすることなく抽出プロセスにフィールドを追加します。

POST https://{endpoint}/documentintelligence/documentModels/prebuilt-layout:analyze?api-version=2024-02-29-preview&features=queryFields&queryFields=Terms,PaymentDate HTTP/1.1
Host: *.cognitiveservices.azure.com
Content-Type: application/json
Ocp-Apim-Subscription-Key:

{
  "urlSource": "https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/form-recognizer/sample-layout.pdf"
}

次のステップ