抽出ノードを管理する

UiPath Maestro Flowの抽出ノードを追加、設定、削除します。

抽出ノードは、IXP の抽出モデルを使用して、請求書、領収書、フォーム、契約書などのドキュメントから構造化フィールドを取得し、その結果を返して下流のノードが操作できるようにします。

前提条件

抽出ノードを追加する前に、テナントで IXP サービスと Document Understanding サービスの両方が有効化されていることを確認してください。IXP モデルのみを使用する場合でも、 抽出 ノードは両方のサービスに依存します。

抽出ノードをフローに追加する

抽出 ノードを フローに追加するには、以下の手順を実行します。

1. Maestro Flowでフローを開きます。
2. [ ノードを追加]、[ ドキュメント]、[ 抽出] の順に選択します。
3. ノードパレットから次のいずれかのオプションを選択します。
   • ドキュメントを抽出 - 新しいノードを作成し、暗黙的に新しいモデルを作成します。
   • このソリューションの場合 - ドロップダウン リストから既存のノードを選択します。
   • パブリッシュ済み - ドロップダウン リストから、デプロイ済みの IXP モデルを選択します。たとえば、IXP の非構造化ドキュメントと複雑なドキュメント、または別のフローの 抽出 ノードからデプロイされたモデルなどです。各モデルは個別のノードとして表示されます。

結果: ノードがフロー キャンバスに追加され、選択したモデルにバインドされます。この時点で、 抽出 ノードをフローの前のノードに接続できます。

抽出ノードを設定する

フロー キャンバスの [抽出 ] ノード上でホバーすると、ツールバーが表示されます。ノードを構成するには、以下のいずれかのオプションを選択できます。

• 編集 - ノードのプロパティを開き、ノードの入力、エラー処理、詳細設定を設定します。詳しくは、「 プロパティ」の「ノードを構成する」をご覧ください。
• 全画面表示を開く - [ 定義 ] タブが開き、抽出モデルとノードのタクソノミーを設定します。詳しくは、「 定義」の「ノードを設定する」をご覧ください。

[プロパティ] でノードを設定する

[プロパティ] でノードを設定するには、以下の手順を実行します。

1. フロー キャンバスで、[ 抽出] ノードにカーソルを合わせます。
2. 表示されるツールバーで、[ 編集] を選択します。

結果: ノードのプロパティがウィンドウで開きます。中央の [ プロパティ ] セクションには、 抽出 ノードを構成する設定が含まれています。左側の 入力 パネルと右側の 出力 パネルは、フローのすべてのノードで使用できます。詳しくは、「 入力パネルと出力パネル」をご覧ください。

プロパティ

[ プロパティ] セクションには、次のタブがあります。

• パラメーター
• エラー処理
• Advanced (カスタム)

パラメーター

注:

検証エラーの場合は、[ パラメーター ] タブに数値が表示されます。

[ パラメーター] タブ内のフィールドを設定するには、以下の手順を実行します。

• ファイル入力:

  • ファイル - データの抽出元のファイルです。トリガーや前のノードの出力など、フローの早い段階で生成されたファイルにバインドします。[ 挿入 ] を使用して変数ピッカーを開き、そこで変数を検索できます。ピッカーでは、前のノードの出力が $varsの下に一覧表示され、フローのメタデータ ( FolderKey、 InstanceId、 ProcessKeyなど) が $metadataの下に表示されます。

  • ページ範囲 - 必要に応じて、処理するページを追加します (例: 1-5)。ドキュメント全体を処理する場合は、空のままにします。フィールドの値の種類 T アイコンを使用して、以下のいずれかを選択します。

    • 固定値 - 値を直接入力します。
    • 式 - IntelliSense で JavaScript の式を入力します。

    [ 挿入 ] を使用して変数を追加することもできます。

• 定義 - ノードの抽出モデルの概要です。
  • 抽出モデルとそのバージョン、および評価メトリック評価の実行がないノードには、[ まだ評価されていません] と表示されます。
  • アノテーション済みのドキュメント - ドキュメントの総数のうちの、アノテーション済みのドキュメントの数です。
  • アップロード - アノテーションを行うドキュメントをアップロードします。
  • アノテーションを行う - アノテーション ビューを開きます。このオプションは、タクソノミーにフィールドを追加するまで利用できません。
  • 評価を実行 - 抽出モデルの評価を実行します。
  • 編集 - [ドキュメントを抽出] パネルの [定義] タブを開きます。詳しくは、「 定義」の「ノードを設定する」をご覧ください。
  • モデル構成 - モデル構成の読み取り専用の概要です ( 抽出モデル、 抽出戦略、 言語サポート、 レイアウトの解析、 属性付け)。
  • タクソノミー - タクソノミー内のフィールドの数です。タクソノミーにフィールドがない場合は、[ フィールドを追加 ] を選択して、新しいフィールド グループを含む [ 定義 ] タブを開きます。

エラー処理

[ エラー処理 ] タブには、[ エラー処理を有効化 ] オプションがあります。有効化すると、ノードには、失敗をキャッチして処理するエラー出力ハンドルが取得され、ノードの出力には、code、message、detail、category、および status キーを持つerror オブジェクトが含まれます。

Advanced (カスタム)

[ 詳細設定 ] タブには、次の設定があります。

• ID - ノードの ID です (例: extractDocument2)。これを変更するには、[編集] アイコンを選択します。
• アイコンの色 - キャンバス上のノード アイコンの色です。
• 変数を更新 - ノードの実行時に変数に値を割り当てます。[ 変数の更新を追加] を選択し、次の設定を行います。
  • 変数 - 更新する変数です。既存の変数を選択するか、[ 新しい変数を作成] を選択します。
  • 式 - 割り当てる値です。[ 挿入] を使用して変数を追加します。式で変数を参照するには、 を使用します $vars.{name}。

入力パネルと出力パネル

[入力] パネルと [出力] パネルは、フローのすべてのノードで使用できます。これらはフローからのデータであり、 ユーザーが 抽出ノードを設定することはありません。

入力

[ 入力] パネルには、フローの前のノードが一覧表示されます。入力は、次の形式で表示できます。

• スキーマ - 前の各ノードの出力キーとその型です。新しいノードの場合、キーには値がありません。
• JSON - JSON 形式の入力です。新しいノードの場合、このビューは空です。

出力

[ 出力] パネルには、ノードの前回の実行の出力が、 version、 type、 result、 taxonomy、 metadata キーとともに表示されます。ノードがまだ実行されていない場合、キーには値がありません。出力は、 スキーマ、 JSON、または 抽出結果 の形式で表示できます。

ドロップダウン リストで、ノードが返す応答を選択します。

• 本稼働 - ノードからの実際の応答です。
• 静的モック - ユーザーが定義した値です。毎回返されます。
• 生成される - LLM が動的に生成する応答です。

定義でのノードの構成

[ 定義 ] タブでノードを設定するには、以下の手順を実行します。

1. フロー キャンバスで、[ 抽出] ノードにカーソルを合わせます。
2. 表示されるツールバーで、[ 全画面表示を開く] を選択します。

結果: [ ドキュメントを抽出 ] パネルで [ 定義 ] タブが開きます。

[ 定義 ] タブには、次のセクションがあります。

• 評価の概要 - 抽出モデル、そのバージョン、および評価メトリックです。評価の実行がないノードには、[ まだ評価されていません] と表示されます。詳しくは、「 ノードのヘルス スコア」をご覧ください。このセクションには、次のオプションもあります。

  • アノテーション済みのドキュメント - ドキュメントの総数のうちの、アノテーション済みのドキュメントの数です。
  • アップロード - アノテーションを行うドキュメントをアップロードします。
  • ドキュメントにアノテーションを付与 - アノテーション ビューを開きます。このオプションは、タクソノミーにフィールドを追加するまで利用できません。

• モデルの設定 - 抽出モデルとその詳細設定です。詳しくは、「 モデルの設定」をご覧ください。

• タクソノミー - ノードが各ドキュメントから抽出するフィールドです。

  • 抽出に関する全体的な指示 - タクソノミー全体に関連するコンテキストを追加します。
  • [タクソノミー] タブ - フィールド グループとフィールドを追加および管理します。新しいノードの場合は、[ フィールド グループ ] を選択して最初のフィールド グループを追加します。
  • [フィールドの種類] タブ - 事前設定済みのフィールドの種類とカスタムのフィールドの種類を追加および管理します。
  • ドキュメントをプレビュー - タクソノミーの横にあるドキュメントのプレビューを開きます。
  • インポート/エクスポート - タクソノミーをインポートまたはエクスポートします。詳しくは、「 タクソノミーをインポートおよびエクスポートする」をご覧ください。

  詳しくは、「 タクソノミーを管理する」をご覧ください。

タクソノミーを変更する場合は、必ず [ 保存] を選択してください。

抽出ノードを削除する

フローから 抽出 ノードを削除するには、以下の手順を実行します。

1. フロー キャンバスで、[ 抽出] ノードにカーソルを合わせます。
2. 表示されるツールバーで、省略記号アイコンを選択します。
3. [ 削除] を選択します。または、フロー キャンバスで [ 抽出 ] ノードを選択して、 Backspace キーを押します。

結果: [ 抽出] ノードがフロー キャンバスから削除されます。

Maestro Flowの関連ドキュメント

• 抽出 - ノードの参照です。抽出結果の読み込み方法、欠落しているフィールド、信頼度スコア、表フィールドが含まれます。
• ドキュメント処理 - フロー キャンバスで使用できるドキュメント処理ノードです。