Train Model

[ モデルをトレーニング ] アクティビティは、指定した BLOB ストレージ コンテナー ( Azure Storage BLOB Uri ) に格納されているソース フォーム ドキュメントを使用して、Form Recognizer のカスタム モデル トレーニング API を呼び出し、新しい カスタム モデル を作成およびトレーニングします。

モデルのトレーニング操作が完了すると、アクティビティはモデルに割り当てられた識別子を String ([モデル ID]) として出力します。この ID は、後続のアクティビティ (例: [モデル情報を取得]) で入力変数として使用できます。

動作のしくみ

以下の手順とメッセージ シーケンス ダイアグラムは、設計時 (つまり、アクティビティの依存関係と入/出力プロパティ) から実行時に至るまでの、アクティビティの動作のしくみの例を示したものです。

1. 「セットアップ」の手順を完了します。
2. プロジェクトに [ Azure フォーム認識器スコープ] アクティビティを追加します。
3. [ Azure フォーム認識スコープ] アクティビティ内に [ モデルのトレーニング ] アクティビティを追加します。
4. [入力] セクションのプロパティに値を 入力 します。
5. [出力 ] セクションのプロパティのために String 型変数を作成し、入力します。

6. アクティビティを実行します。

   • 入力プロパティは、 モデルのトレーニング API に渡されます。
   • API は、[出力] セクションのプロパティ変数に String の値を返します。
     
     

     

     
     

プロパティ

以下のプロパティの値は、このアクティビティを UiPath Studio でプロジェクトに追加するときに指定します。

共通

表示名

アクティビティの表示名です。

属性	詳細
入力	String
Required	はい
既定値	Train Model
許容値	String または String 型変数を入力します。
備考	N/A

入力

Azure Storage Blob Uri

トレーニング モデルで使用するソース フォーム ドキュメントを含む、Azure BLOB ストレージ コンテナーの共有アクセス署名 (SAS) URI です。

属性	詳細
入力	String
Required	はい
既定値	空
許容値	String または String 型変数を入力します。
備考	URI の値を取得するには、「 セットアップ」 ガイドの「 共有アクセス署名を取得する 」の手順に従います (クイック リファレンスについては、以下の画像を参照してください)。 サポートされているフォームのドキュメント形式: PNG、JPEG、PDF (その他すべての種類の書式設定は無視されます)。

オプション

サブフォルダーを含む

ソース フォーム ドキュメントが Azure BLOB ストレージ コンテナー内のサブフォルダーに保存されていることを示します。

属性	詳細
入力	チェックボックス
Required	いいえ
既定値	非選択
許容値	選択または非選択
備考	既定では、モデルのトレーニング操作では、Azure BLOB ストレージ コンテナーのルートにあるフォーム ドキュメントのみが使用されます。 フォーム ドキュメントがサブフォルダーに保存されている場合は、このオプションを選択します。

ソース フィルターのプレフィックス

名前が指定された値で始まるドキュメントをフォームするように、トレーニング データ セットを制限します。

属性	詳細
入力	String
Required	いいえ
既定値	空
許容値	String または String 型変数を入力します。
備考	Azure BLOB ストレージ コンテナーにさまざまなフォーム ドキュメントが含まれている場合、ドキュメント名の共有部分を入力して、このトレーニング モデルに含めるドキュメントを指定できます。 たとえば、「Invoice」と入力した場合、"Invoice" で始まる名前のフォーム ドキュメントのみが使用されます。

ラベル ファイルを使用

選択すると、モデルでラベル ファイルが使用されます。

属性	詳細
入力	チェックボックス
Required	いいえ
既定値	非選択
許容値	選択または非選択
備考	N/A

その他

プライベート (Private)

選択すると、変数と引数の値が Verbose レベルでログ記録されなくなります。

属性	詳細
入力	チェックボックス
Required	いいえ
既定値	非選択
許容値	選択または非選択
備考	N/A

出力

モデル ID

トレーニング モデルに割り当てられた識別子です。

属性	詳細
入力	String
Required	いいえ (後続のアクティビティで出力データを使用する必要があります)
既定値	空
許容値	String 型変数を入力します。
備考	このプロパティ用に作成した変数は、他の Azure Form Recognizer アクティビティ (例: [ モデル キーを取得]、[ モデル情報を取得]) の入力変数として使用できます。