ドキュメントを分類

UiPath.IntelligentOCR.StudioWeb.Activities.ClassifyDocument

説明

このアクティビティを使用すると、目的の分類器と分類するドキュメントを選択してドキュメントを分類できます。

注: [ドキュメントを分類] アクティビティでは、パブリックエンドポイントを使用します。

生成モデルでサポートされている言語は、使用されている OCR エンジンと同じです。詳しくは、「OCR でサポートされている言語」をご覧ください。

このアクティビティが Studio のワークフローの最初の Document Understanding アクティビティでない限り、入力は Document Data である必要があります。File は、アクティビティが Studio のワークフローの最初の Document Understanding アクティビティである場合にのみ、入力として使用します。

プロジェクトの対応 OS

Windows | クロスプラットフォーム

構成

デザイナーパネル

プロジェクト - ドロップダウンメニューからお使いの Document Understanding プロジェクトを選択する必要があります。利用可能なオプションは次のとおりです。
- Predefined - 既定のプロジェクトの種類です。
- + アイコンをクリックして新しいプロジェクトを作成できます。
注: テナントに 500 個を超えるプロジェクトを作成し、[ドキュメントを分類] アクティビティを使用した場合、UiPath Studio または Studio Web には、最初の 500 個を超えるプロジェクトは表示されません。したがって、これらのプロジェクトは使用できません。
分類器 - ドロップダウンメニューからお使いの Document Understanding の分類器を選択する必要があります。
注: 生成 AI 分類器に送信されたデータは、公開されていない LLM モデルインスタンスに送信されます。外部には送信されず、処理後に保存またはトレーニングに使用されることはありません。
- Predefined - 既定のプロジェクトの種類です。
- Generative Classifier - 生成 AI 分類器です。
  重要:
  この機能は現在、監査プロセスの一部であり、レビューが完了するまで FedRAMP 承認の一部とは見なされません。現在レビュー中の機能の完全なリストについては、こちらをご覧ください。
  - プロンプト - ドキュメントの種類を識別するためのプロンプトです。キーと値のペアとして指定します。キーはドキュメントの種類の名前を、値はドキュメントの種類の説明を表します。分類器がドキュメントを識別するのに役立ちます。
    - ドキュメントの種類 - 分類結果として使用するドキュメントの種類の名前を指定します (最大 30 文字)。
    - 生成 AI のプロンプト - 生成 AI 分類器の入力としてプロンプトを入力する必要があります。最大 1000 文字を入力できます。
入力 - 入力ファイルまたは Document Data オブジェクトを指定します。
重要: 1 つのファイルに含めることができる最大ページ数は 500 です。この制限を超えるファイルは分類できません。

ヒント: ファイルが IResource 型の変数として格納されていない場合、変換を実行するオプションがあります。このためには、[入力] プロパティフィールドで LocalResource.FromPath(<reference_to_the_file>) を使用します。
[繰り返し (コレクションの各要素)] アクティビティを使用して、ファイルのリストを繰り返し処理するシナリオを考えてみます。currentItem が、繰り返し処理する変数であるとします。currentItem を IResource に変換するには、LocalResource.FromPath(currentItem) を [入力] フィールドに貼り付けます。

プロパティパネル

詳細設定

最小信頼度 - 分類時にドキュメントの種類を割り当てる基準となる、最小の信頼度のしきい値を指定します。ドキュメントの信頼度スコアがこのしきい値を下回ると、ドキュメントの種類が「不明」として報告されます。
ヒント: ほとんどのドキュメントの種類では、予測と信頼度レベルが生成されます。このプロパティを設定すると、しきい値を上回る信頼度レベルを持つ予測のみが考慮されるため、誤検知が防止されます。最適な信頼度レベルを特定するには、ワークフロー内でさまざまなドキュメントをテストし、その結果を Excel スプレッドシートなどに記録した上で、どのしきい値が最も正確かを分析します。

入力

タイムアウト (秒) - 生成 AI モデルへの呼び出しの最大実行時間 (秒単位) です。このタイムアウト値を超えると、遅延やハングを防ぐために操作が自動的に終了されます。このプロパティは、[生成 AI 分類器] が分類器として選択されている場合にのみ表示されます。

出力

ドキュメントデータ - ファイルから抽出される検証済みのすべてのフィールドデータです。

生成 AI 分類器を使用する

[ドキュメントを分類] アクティビティの生成機能をすぐに使用するには、以下の手順を実行してください。

[ドキュメントを分類] アクティビティを追加します。
[プロジェクト] ドロップダウンリストから [Predefined] を選択します。
[分類器] で [生成 AI 分類器] を選択します。
[プロンプト] プロパティがアクティビティの本体に表示されます。

[プロンプト] フィールドに、指示をディクショナリのキーと値のペアとして入力します。ここで、

キーとは [ドキュメントの種類] で入力する値のことです (例: 履歴書)。

値とは、[生成プロンプト] で入力する値のことで、ドキュメントの種類を識別するために生成分類器が使用する説明です。

以下の表に、キーと値のペアのサンプルをいくつか示してありますので、確認してください。

表 1. 生成 AI 分類器のプロンプトとして使用されるキーと値のペア
ドキュメントの種類	生成プロンプト
履歴書	「教育」、「スキル」、「経験」などの、履歴書に関連する一般的なキーワードを検索してください。
請求書 (Invoice)	「請求番号」、「請求先」、「合計金額」などの、一般的なフィールド名を検索してください。