ドキュメントを分類

UiPath.IntelligentOCR.StudioWeb.Activities.ClassifyDocument

説明

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

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

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

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

プロジェクトの対応 OS

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

構成

デザイナー パネル

• 入力 - 入力ファイルまたは Document Data オブジェクトを指定します。
  重要: 1 つのファイルに含めることができる最大ページ数は 500 です。この制限を超えるファイルは分類できません。
  ヒント: ファイルが IResource 型の変数として格納されていない場合、変換を実行するオプションがあります。このためには、[入力] プロパティ フィールドで LocalResource.FromPath(<reference_to_the_file>) を使用します。

  [繰り返し (コレクションの各要素)] アクティビティを使用して、ファイルのリストを繰り返し処理するシナリオを考えてみます。currentItem が、繰り返し処理する変数であるとします。currentItem を IResource に変換するには、LocalResource.FromPath(currentItem) を [入力] フィールドに貼り付けます。
• Document Understanding プロジェクト - ドロップダウン メニューからお使いの Document Understanding プロジェクトを選択する必要があります。 利用可能なオプションは次のとおりです。
  • Predefined - 標準的なシナリオに推奨される、事前トレーニング済みの特殊なモデルを使用するプロジェクトです。
  • 接続先のテナントおよびフォルダーにある既存のプロジェクト
  • + アイコンを選択すると、新しいプロジェクトを作成できます。
  注: テナントに 500 個を超えるプロジェクトを作成し、[ドキュメントを分類] アクティビティを使用した場合、UiPath Studio または Studio Web には、最初の 500 個を超えるプロジェクトは表示されません。したがって、これらのプロジェクトは使用できません。
• 分類器 - 定義済みの プロジェクトを使用している場合は、ドロップダウン メニューから目的の Document Understanding 分類器を選択できます。
  注: 生成 AI 分類器に送信されたデータは、公開されていない LLM モデル インスタンスに送信されます。外部には送信されず、処理後に保存またはトレーニングに使用されることはありません。
  • [Predefined] プロジェクトには、次の 2 つのオプションがあります。
    • ML Classification – ML ベースの分類器です。
    • Generative Classifier – 生成 AI 分類器の種類です。
      重要:

      この機能は現在のところ監査プロセスの一部であり、レビューが完了するまで FedRAMP 承認の一部と見なすべきではありません。現在レビュー中の機能の完全なリストについては、こちらをご覧ください。

      • プロンプト - ドキュメントの種類を識別するための指示です。キーと値のペアとして指定します。キーはドキュメントの種類の名前を、値はドキュメントの種類の説明を表します。分類器がドキュメントを識別するのに役立ちます。
        • ドキュメントの種類 - 分類結果として使用するドキュメントの種類の名前を指定します (最大 30 文字)。
        • 生成 AI のプロンプト - 生成 AI 分類器に対して、ドキュメントの種類を識別するための指示を入力する必要があります。 最大 1000 文字を入力できます。
• バージョン (プレビュー) - 既存の Document Understanding モダン プロジェクトを使用する場合は、このプロパティを使用します。 データを処理するプロジェクトのバージョンに対応するタグを選択します。 たとえば、バージョン 3 に割り当てられた Production タグを選択すると、アクティビティは実稼働環境でプロジェクトのバージョン 3 のデータを処理します。

  [バージョン] の既定値は [ステージング] です。選択したプロジェクトに ステージング タグが存在しない場合、既定値は Production です。

  タグを選択すると、そのバージョンでサポートされているドキュメントの種類のリストが表示されます。

プロパティ パネル

詳細設定

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

入力

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

出力

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

生成 AI 分類器を使用する

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

1. [ドキュメントを分類] アクティビティを追加します。
2. [プロジェクト] ドロップダウン リストから [Predefined] を選択します。
3. [分類器] で [生成 AI 分類器] を選択します。

   [プロンプト] プロパティがアクティビティの本体に表示されます。

4. [プロンプト] フィールドに、指示をディクショナリのキーと値のペアとして入力します。ここで、
   • キーとは [ドキュメントの種類] で入力する値のことです (例: 履歴書)。
   • 値とは、[生成プロンプト] で入力する値のことで、ドキュメントの種類を識別するために生成分類器が使用する説明です。

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

     表 1. 生成 AI 分類器のプロンプトとして使用されるキーと値のペア

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

   図 1. 生成 AI 分類器のプロンプトとして使用されるキーと値のペア