- 概要
- モデルの構築
- モデルの評価
- モデルのデプロイ
- モデルを使用する
- 開発者
- よくある質問
タクソノミーを管理する
UiPath Maestro Flow™ で、[抽出] ノードがドキュメントからキャプチャするデータを定義するフィールド グループ、フィールド、フィールドの種類、および指示を管理します。
プロンプトの指示の概要
プロンプトの指示は、ドキュメントから適切な値を抽出するために必要なコンテキストをモデルに提供する自然言語での記述です。タクソノミーの複数のレベルで指示を追加できます。
- タクソノミー全体について
- 各フィールド グループについて
- 繰り返し (各フィールド)
- (各フィールドの種類について)。指示は、そのフィールドの種類を使用するすべてのフィールドで共有されます。
抽出に関する全体的な指示 - タクソノミー全体に関連するコンテキストをモデルに提供します。プロジェクト内の全体的な抽出タスクやドキュメントの詳細を含みます。
指示 - ドキュメントからデータを正常に抽出する方法についてのコンテキストをモデルに提供します。指示を反復することで、予測を改善できます。
プロンプトの全体的な指示を管理する
タクソノミー全体にプロンプトの指示を追加するには、以下の手順を実行します。
- [フロー 抽出 ] ノード上でホバーして [ 全画面表示を開く] を選択すると、[ 定義 ] タブが開きます。
- [ 定義 ] タブの [ タクソノミー ] セクションに移動します。
- [ 抽出に関する全体的な指示 ] を展開し、指示を追加します。
ノード レベルの指示には、業界やドキュメントの種類の説明、またはドキュメント固有の考慮事項 (1 つのファイル内にドキュメントが複数回出現する場合など) を含めることができます。
フィールド グループを管理する
フィールド グループは [ タクソノミー ] タブから直接管理します。これにより、複数の項目を作成、編集、移動、または削除してから編集内容を保存できます。すべての変更は、変更を保存する際に同時に適用され、個々の変更ごとに新しいバージョンが生成されるのではなく、単一のプロジェクト バージョンの更新として保存されます。
フィールド グループを作成および設定する
フィールド グループを作成および設定するには、以下の手順を実行します。
-
[フロー 抽出 ] ノード上でホバーして [ 全画面表示を開く] を選択すると、[ 定義 ] タブが開きます。
-
[ 定義 ] タブで、[ タクソノミー ] タブに移動します。
-
次のフィールドを設定します。
- 名前 - フィールド グループの名前です。フィールド グループには、フィールドに含まれるフィールドの数も表示されます。
- 指示 - フィールド グループに対する指示です。[列] フィルターで [指示] 列を非表示にし、[リセット] を選択して初期ビューを復元できます。
- 型 - モデルがフィールド グループを抽出する頻度です。以下のいずれかを選択します。
- 単一インスタンス - ドキュメントごとに 1 回抽出されます。
- 複数インスタンス - 出現ごとに 1 回ずつ抽出されます。
行を並べ替えるには、行の先頭にあるドラッグ ハンドルを使用します。
-
必要に応じて、[ + フィールド グループ ] ボタンを選択して、さらにフィールド グループを追加します。
-
[保存] を選択します。
フィールド グループ間の階層を定義するには、親フィールド グループを作成してから、その中に 1 つ以上の子フィールド グループを追加します。この構造により、フィールド グループ間の関係が確立されます。つまり、親フィールド グループに対して予測が返されない場合は、子フィールド グループも予測を返しません。親フィールド グループは実質的に主要な分類として機能し、その子は追加の詳細レベルを提供します。
親フィールド グループに対する指示は、子フィールド グループには影響しません。
フィールド グループとその階層の例
次の例は、フィールド グループとその階層を示しています。
- 請求書 (Invoice)
- Invoice Number
- 請求書>明細項目
- 単価
- 数 (Quantity)
- 明細行の金額
モデルがドキュメント内に請求書のフィールド グループを見つけられない場合、つまりドキュメントが請求書ではない場合、請求書>明細項目は返されません。
フィールド グループを編集する
フィールド グループを編集するには、以下の手順を実行します。
- [ 定義 ] タブで、[ タクソノミー ] タブに移動します。
- フィールド グループの名前または指示を選択します。
- 変更を行います。
- [保存] を選択します。
フィールド グループの変更履歴を表示する
フィールド グループの変更履歴を表示するには、以下の手順を実行します。
- [ タクソノミー ] タブで、フィールド グループの省略記号を選択します。
- [変更履歴を表示] を選択します。
結果: [ 変更履歴 ] ウィンドウが開きます。フィールド グループのバージョンが、選択したバージョンのフィールド グループ名と指示とともに表示されます。バージョンの比較と復元について詳しくは、「 変更履歴を表示する」をご覧ください。
フィールド定義をコピーする
フィールド グループのすべてのフィールド定義をコピーして、1 つ以上の他のフィールド グループに貼り付けることができます。
フィールド定義をコピーするには、以下の手順を実行します。
- [ 定義 ] タブで、[ タクソノミー ] タブに移動します。
- コピーするフィールドがあるフィールド グループの行上でホバーし、省略記号ボタンを選択します。
- [ すべてのフィールドの定義をコピー] を選択します。各フィールド グループの横にチェック ボックスが表示され、「 コピーしたフィールドを貼り付けるフィールド グループを選択する 」というメッセージを示すバーが表示されます。
- フィールドを貼り付ける各フィールド グループのチェックボックスをオンにします。
- [ 貼り付け] を選択します。コピーをキャンセルするには、代わりに [ 終了 ] を選択します。
- [保存] を選択します。
結果: コピーされたフィールドが、選択したフィールド グループに追加されます。
フィールド グループを移動する
フィールド グループを別のフィールド グループの下に移動したり、子フィールド グループを最上位レベルに戻したりすることができます。
フィールド グループを移動するには、以下の手順を実行します。
- [ 定義 ] タブで、[ タクソノミー ] タブに移動します。
- フィールド グループの行にカーソルを合わせ、省略記号ボタンを選択します。
- [ 移動] を選択します。[ フィールド グループを移動] ウィンドウが開き、フィールド グループの現在の親が表示されます。
- [ 新しい親を選択] ドロップダウン リストから、新しい親フィールド グループを選択します。フィールド グループを最上位レベルに移動するには、[ なし] を選択します。
- [Move field group] を選択します。
- [保存] を選択します。
結果: フィールド グループが新しい親の下に表示されます。
大なり記号 > を使用して、フィールド グループの階層を定義します。この記号は、親フィールド グループと子フィールド グループとの間の関係を設定します。
フィールド グループを削除する
フィールド グループを削除するには、以下の手順を実行します。
- [ 定義 ] タブで、[ タクソノミー ] タブに移動します。
- フィールド グループの行にカーソルを合わせ、省略記号ボタンを選択します。
- [ 削除] を選択します。フィールド グループを削除するウィンドウが開きます。フィールド グループを削除すると、そのフィールドもすべて削除されます。
- [ 確認] を選択します。フィールド グループは、変更を保存するまで取り消し線付きで表示されます。
- [保存] を選択します。
結果: フィールド グループとそのフィールドがタクソノミーから削除されます。
フィールド グループを削除すると、そのアノテーションが失われます。この操作を元に戻す方法は、以前にデプロイしたモデル バージョンに戻す以外にありません。大幅な変更を行う前に、最新のモデル バージョンをデプロイしてください。
フィールドを管理する
フィールドは [ タクソノミー ] タブから直接管理します。保存する前に複数のフィールドを作成、編集、または削除します。保存すると、すべての変更が同時に適用されます。
フィールドを作成および設定する
フィールドを作成および設定するには、以下の手順を実行します。
- [ 定義 ] タブで、[ タクソノミー ] タブに移動します。
- フィールドを追加するフィールド グループで、[ + 新しいフィールド] を選択します。
- 次のフィールドを設定します。
-
名前 - フィールドの名前です。フィールドに、そのフィールドが表すデータを正確に表す名前を付けます。
-
指示 - フィールドの指示です。フィールドに関連する詳細な説明を入力し、必要なコンテキストを抽出に対して提供します。
-
型 - フィールドの型です。次の事前設定済みのフィールドの種類のいずれかを選択します。
- 日付 - カレンダーの日付のみ、時刻なし。たとえば、
2023-02-21です。 - 正確なテキスト - ドキュメント内に逐語的に表示されます。
- 推論されたテキスト - 引用符ではなく派生させる場合があります。
- 金額 - ISO 通貨コードを含む金額。たとえば、
12.11 USDです。 - 数値 - 10 進数です。たとえば、
1250.50です。 - Boolean - 例:
trueやfalse。
カスタムのフィールドの種類を作成するには、ドロップダウン リストの下部にある [ 新しいフィールドの種類 ] を選択します。[ フィールドの種類 ] タブが開いて新しいフィールドの種類の行が追加され、フィールドでは新しいフィールドの種類が使用されます。詳しくは、「フィールドの種類を管理する」の「フィールドの種類を作成および設定する」セクションをご覧ください。
注:- フィールドの種類は、異なるフィールドで再利用できます。これにより、指示を共有できます。
- フィールドの種類をフィールドの作成後に変更できます。データ型に対応していない型に変更すると、既存のアノテーションに影響します。詳しくは、「 フィールドを編集する」 セクションをご覧ください。
- テキストのフィールドの種類には、ドキュメントに存在していて抽出されたとおりの入力値 ([正確なテキスト]) を含めることができます。また、テキストに明確に記載されていない場合は、ドキュメントから推論された入力値を含めることもできます ([推論されたテキスト])。
- 日付 - カレンダーの日付のみ、時刻なし。たとえば、
-
- 必要に応じて、[ + 新しいフィールド ] を選択してさらにフィールドを追加します。
- [保存] を選択します。
フィールドの型は後で変更できます。既存のアノテーションへの影響については、「 フィールドを編集 する」セクションをご覧ください。
フィールド グループ内のフィールドを並べ替えるには、行の先頭にあるドラッグ ハンドルを使用します。
フィールドの編集
フィールドを編集するには、以下の手順を実行します。
- [ 定義 ] タブで、[ タクソノミー ] タブに移動します。
- フィールドの名前、指示、または種類を選択します。
- 変更を行います。
- [保存] を選択します。
アノテーションを互換性のないデータ型に再マッピングすることはできません。フィールドの型をデータ型の型に変更すると、そのフィールドの既存のアノテーションは無効になるため、それらを確認して修正する必要があります。たとえば、[ 正確なテキスト] フィールドを [Date ] に変更すると、アノテーション済みの値は保持されますが無効としてマークされます。フィールドの種類を Choice フィールドに変更すると、アノテーション済みの値はクリアされます。[正確なテキスト] や [推論されたテキスト] など、互換性のある種類を変更しても、アノテーションは保持されます。
フィールドの変更履歴を表示する
フィールドの変更履歴を表示するには、以下の手順を実行します。
- [ 定義 ] タブで、[ タクソノミー ] タブに移動します。
- フィールドの行の上にホバーし、省略記号ボタンを選択します。
- [変更履歴を表示] を選択します。
結果: [ 変更履歴 ] ウィンドウが開きます。フィールドのバージョンが、選択したバージョンのフィールド名、フィールドの種類、および指示とともに一覧表示されます。バージョンの比較と復元について詳しくは、「 変更履歴を表示する」をご覧ください。
フィールド定義をコピーする
フィールド定義をコピーして、1 つ以上のフィールド グループに貼り付けることができます。
フィールド定義をコピーするには、以下の手順を実行します。
- [ 定義 ] タブで、[ タクソノミー ] タブに移動します。
- 定義をコピーするフィールド行上でホバーし、省略記号ボタンを選択します。
- [ フィールドの定義をコピー] を選択します。各フィールド グループの横にチェック ボックスが表示され、「 コピーしたフィールドを貼り付けるフィールド グループを選択する 」というメッセージを示すバーが表示されます。
- フィールドを貼り付ける各フィールド グループのチェックボックスをオンにします。
- [ 貼り付け] を選択します。コピーをキャンセルするには、代わりに [ 終了 ] を選択します。
- [保存] を選択します。
結果: コピーされたフィールドが、選択したフィールド グループに追加されます。
フィールドを削除する
フィールドを削除するには、以下の手順を実行します。
- [ 定義 ] タブで、[ タクソノミー ] タブに移動します。
- フィールドの行の上にホバーし、省略記号ボタンを選択します。
- [ 削除] を選択します。[ 削除] フィールドウィンドウが開きます。フィールドを削除すると、そのアノテーションも削除されます。
- [ 確認] を選択します。フィールドは、変更を保存するまで、取り消し線付きで表示されます。保存する前にフィールドを復元するには、行の末尾にある [ 削除を元に戻 す] を選択します。
- [保存] を選択します。
結果: フィールドとそのアノテーションがタクソノミーから削除されます。
フィールドを削除しても、そのフィールドで使用されているカスタム フィールドの種類は削除されません。フィールドの種類を削除するには、「 フィールドの種類を削除する」 セクションをご覧ください。
フィールドを削除すると、そのアノテーションが失われます。この操作を元に戻す方法は、以前にデプロイしたモデル バージョンに戻す以外にありません。大幅な変更を行う前に、最新のモデル バージョンをデプロイしてください。
フィールドの種類を管理する
フィールドの種類を使用すると、そのフィールドの種類を使用するすべてのフィールド間で指示を共有できます。フィールドの種類は [ フィールドの種類 ] タブから直接管理します。フィールドやフィールド グループと同様に、保存する前に複数のフィールドの種類を作成、編集、削除でき、すべての変更は保存時に同時に適用されます。
フィールドの種類を作成および設定する
フィールドの種類を作成および設定するには、以下の手順を実行します。
- [ 定義 ] タブで、[ タクソノミー ] セクションに移動し、[ フィールドの種類 ] タブを選択します。
- [ + フィールドの種類] を選択します。テーブルの下部に新しい行が追加されます。
- 次のフィールドを設定します。
-
名前 - フィールドの種類の名前です。名前の横にある数字は、そのフィールドの種類を使用しているフィールドの数を示します。
-
指示 - そのフィールドの種類を使用するすべてのフィールドに共通する指示です。
注:フィールドの種類は、異なるフィールドで再利用できます。これにより、指示を共有できます。
-
型 - フィールドの型のデータ型です。詳しくは、「 利用可能なデータ型」をご覧ください。
-
設定 - データ型の追加設定です。この設定は、 Choice データ型でのみ使用できます。[ 設定を追加 ] を選択して [ チョイス ] パネルを開き、各チョイスに次の設定を行います。
- 表示値 - 選択の値です。
- 代替値 - この選択肢にマップされるコンマ区切りの値です。たとえば、
USD, US Dollarです。
[ + チョイスを追加] を選択して選択肢を追加します。ドラッグ ハンドルでチョイスを並べ替え、削除アイコンを選択してチョイスを削除します。
-
- [保存] を選択します。
また、[タクソノミー] タブのフィールドの [種類] ドロップダウン リストから [新しいフィールドの種類] を選択して、フィールドの設定中にフィールドの種類を作成することもできます。[ フィールドの種類 ] タブが開いて新しいフィールドの種類の行が追加され、フィールドでは新しいフィールドの種類が使用されます。
利用可能なデータ型
次のデータの種類を使用できます。
| データ型 | 説明 |
|---|---|
| 正確なテキスト | ドキュメント内に逐語的に表示されます。 |
| 推論されたテキスト | 引用するのではなく派生する場合があります。 |
| 選択肢 | クローズドセット;値は逐語的に表示されます。 |
| Number | 10 進数です。たとえば、1250.50のようになります。 |
| 金額 | ISO 通貨コードを含む金額です。たとえば、12.11 USDのようになります。 |
| 日付 | カレンダーの日付のみです。時刻は含みません。たとえば、2023-02-21のようになります。 |
| 日付と時刻 | カレンダーの日付と時刻です。たとえば、2023-02-21T14:05:00Zのようになります。 |
| Time | 時刻のみです。日付は含みません。たとえば、14:05:00のようになります。 |
| Duration | 時点ではなく、時間の長さです。たとえば、「 P30D (30 日)」などです。 |
| メール | たとえば、invoices@acme.com です。 |
| ホスト名 | たとえば、acme.example.com です。 |
| IPv4 アドレス | たとえば、192.0.2.10 です。 |
| IPv6 アドレス | IPv6 アドレスです。 |
| UUID | たとえば、2c01b272-7117-41f7-ca59-08ded70a0e12 です。 |
| Boolean | 例: true または false |
フィールドの種類を編集する
フィールドの種類を編集するには、以下の手順を実行します。
- [ 定義 ] タブで、[ タクソノミー ] セクションに移動します。
- [ フィールドの種類 ] タブを選択します。
- フィールドの種類の名前、指示、種類、または設定を選択します。
- 変更を行います。
- [保存] を選択します。
フィールドの種類のデータ型を変更すると、そのデータ型を使用するすべてのフィールドに影響します。アノテーションは、互換性のないデータ型に再マッピングできないため、これらのフィールドの既存のアノテーションは有効ではなくなるため、確認して修正する必要があります。チョ イスのデータ 型を別のデータ型に変更すると、設定されているチョイスも削除されます。
フィールドの種類を削除する
フィールドの種類を削除するには、以下の手順を実行します。
- [ 定義 ] タブで、[ タクソノミー ] セクションに移動し、[ フィールドの種類 ] タブを選択します。
- フィールドの種類の行にカーソルを合わせ、行の最後にある削除アイコンを選択します。[ フィールドの種類を削除 ] ウィンドウが開きます。
- [ 削除] を選択します。フィールドの種類は、変更を保存するまで取り消し線付きで表示されます。保存する前にフィールドの種類を復元するには、行の末尾にある [ 削除を元に戻 す] を選択します。
- [保存] を選択します。
結果: フィールドの種類がタクソノミーから削除されます。
カスタムのフィールドの種類と事前設定済みのフィールドの種類の両方を削除できます。削除したフィールドの種類がフィールドを使用している場合は、[ フィールドの種類を削除] ウィンドウにそれらのフィールドが一覧表示されます。[ 次で置換] ドロップダウン リストから、割り当てるフィールドの種類を選択します。[ 置換しない] を選択した場合、表示されるフィールドには型がないため、変更を保存する前に [ タクソノミー ] タブで各フィールドに対して新しい型を選択する必要があります。
変更履歴を表示する
フィールドまたはフィールド グループの変更履歴を表示するには、以下の手順を実行します。
- [ 定義 ] タブで、[ タクソノミー ] セクションに移動します。
- フィールドまたはフィールド グループで、省略記号を選択し、[ 変更履歴を表示] を選択します。[ 変更履歴 ] ウィンドウが表示され、以下の詳細が表示されます。
- バージョンのリストです。各バージョンには、その番号、現在のバージョンの [CURRENT ] ラベル、スコア、変更の種類、変更が発生した日時、および実行回数が表示されます。
- 選択したバージョンの詳細: フィールド名、フィールドの種類、指示、およびそのバージョンのモデル設定。
- 現在と比較 - 選択したバージョンと現在のバージョンを比較するには、このオプションを有効化します。
- [すべて復元] と [指示を復元] - 選択したバージョンを復元します。
推論されるフィールドと正確なフィールドの例
推論されるフィールド
私は保険会社の引受業務チームで働いています。顧客に提供する所定の保険証券のカテゴリとして、自動車、住宅、健康、高級品など数百のカテゴリがあり、そのそれぞれがタイプ A、B、C のようにタイプ カテゴリに対応しています。
ドキュメントの内容に基づいて、処理が必要な保険証券のタイプ カテゴリを抽出して特定できるようにしたいと考えています。
この例では、メッセージのどこにも、この電子メールがタイプ E に関連することを明確に示す箇所がありません。そこで指示の中で、保険の種類ごとにコンテキストを提供し、モデルの予測に情報を提供します。たとえば、高級品に関連する請求はすべてタイプ E カテゴリに属します。
推論として設定する必要があるフィールドの例:
- ドキュメントのどこにも存在しないが、そのコンテキストから暗示される値
- ドキュメント内の複数の領域にわたり連結する必要がある値
- 複数の段落、行、または列にまたがる値
正確なフィールド
このリクエストを簡単に処理するには、既存の保険証券番号、名前、請求額が必要になると思われます。これらは、ドキュメント自体に明確に記載されており、抽出して下流工程に送る必要があることがわかっている値です。
図 1. 推論されるフィールドと正確なフィールドの例
- プロンプトの指示の概要
- プロンプトの全体的な指示を管理する
- フィールド グループを管理する
- フィールド グループを作成および設定する
- フィールド グループを編集する
- フィールド グループの変更履歴を表示する
- フィールド定義をコピーする
- フィールド グループを移動する
- フィールド グループを削除する
- フィールドを管理する
- フィールドを作成および設定する
- フィールドの編集
- フィールドの変更履歴を表示する
- フィールド定義をコピーする
- フィールドを削除する
- フィールドの種類を管理する
- フィールドの種類を作成および設定する
- フィールドの種類を編集する
- フィールドの種類を削除する
- 変更履歴を表示する
- 推論されるフィールドと正確なフィールドの例