テキスト抽出器の追加

文書からセマンティックなキーと値のペア(KVP)を抽出する

文書からセマンティックキーバリューペア（KVP）を抽出するために、テキスト抽出器を設定することができます。 セマンティックKVP抽出は、データを抽出するためのキーと値のペアに注目することで、フォーマットやレイアウトなどのドキュメントのバリエーションに適応することができます。

ドキュメントからキーと値のペアを抽出する：

1. エージェントワークフローのテキスト抽出ノードを選択します。

2. Extract key-value pairs スイッチをオンにする。

3. Add schemaをクリックする。

4. 有効なJSONスキーマを使用して、ドキュメントから抽出したいフィールドとテーブルを指定します。 以下にJSONの例を示す。

   [
       {
           "document_type": "Invoice",
           "document_description": "An invoice is a standard document issued by a seller to a buyer, outlining products or services provided, quantities, prices, and payment terms.",
           "fields": {
               "invoice_number": {
                   "description": "A unique identifier assigned by the vendor for this invoice.",
                   "example": "2023-AUS-987654"
               },
               "document_date": {
                   "description": "Date of the document.",
                   "example": "2025-07-05"
               },
               "vendor_name": {
                   "description": "Legal or trade name of the company issuing the invoice. Usually located in the header or footer, near the logo, or billing details.",
                   "example": "ABC Supply Company Ltd"
               },
               "vendor_number": {
                   "description": "Internal identifier used by the buyer's system to refer to the vendor.",
                   "example": "VEND-1023"
               }
           }
       }
   ]
   }

5. テキスト抽出ツールに使用するモデルを選択してください。

   「 モデル 」リストからモデルを選択するか、 「すべての基礎モデルを表示」 をクリックして、利用可能なすべてのモデルが一覧表示されるモデル選択ダイアログを開きます。 モデルを検索するか、リストから選択してください。 モデルを選択したら、 「保存」 をクリックしてください。 選択したモデルに関連する通知（非推奨の通知やサードパーティのライセンス要件など）が表示されます。

   一部のモデルでは、ダイアログにステータスタグが表示され、 「推奨 」や「 サードパーティ製」 などの状態が示されます。 警告アイコンは、そのモデルが次回のリリースで廃止または非推奨になる可能性があることを示しています。

6. KVP フォーススキーマ名を入力してください。

既存のスキーマを編集するには、エージェントのワークフローでテキスト抽出ノードを選択し、 スキーマの編集をクリックします。

セマンティックKVP抽出におけるkpv_model_name値のばらつき

オンプレミス

フローツールがデフォルト値を使用する場合 kvp_model_name 、またはAPI呼び出し元が実行時に値を指定する場合、期待される結果を得るためには、渡された kvp_model_name 値の微妙な違いを理解することが重要です。

データを入力にマッピングする

デフォルトでは、オートマッピングが有効になっている。 しかし、入力に値をマッピングすることはできる。

値を入力にマップするには、以下の手順を実行する：

1. テキスト抽出ノードを選択し、 データマッピングの編集をクリックします。

2. データマッピングの入力値を指定する。 データマッピングの詳細については、 データのマッピングを参照してください。

テキスト抽出の制限と制約

テキスト抽出機能には次のような制限や制約があります。