クイックスタート - 顔を識別

UiPath のオートメーションで Amazon Rekognition アクティビティを使用した Identify Face

概要

このガイドの目的は、[ 顔を識別 ] アクティビティの実用的なサンプルを作成できるようになることです。この実用的なサンプルを使用すると、AWS アカウントへの接続をすばやく確認し、アクティビティの入力/出力データ型に習熟することができます。

このページの手順を完了すると、以下のアクションを実行するオートメーション シーケンスが使用できるようになります。

1. [ Amazon スコープ ] アクティビティを使用して、AWS アカウントと Amazon Rekognition サービスへの接続を確立します。

2. 新しいコレクションを作成し、[ コレクションを作成 ] アクティビティを使用して画像で検出された顔に関する情報を保存します。

3. 画像内の顔を検出し、[ 顔を追加 ] アクティビティを使用して指定したコレクションに追加します。

4. 入力画像内の最大の顔を検出し、指定されたコレクション (コレクション) で一致する顔を検索します。[ 顔を識別 ] アクティビティを使用して識別された顔の配列を返します。5. Amazon Rekognition アクティビティの [input/putput] プロパティを、[繰り返し ( コレクション の各要素)] アクティビティと [1 行を書き込み ] アクティビティを使用してテストします。

   

前提条件

開始する前に、以下に示す該当する前提条件を満たす必要があります。

別の Amazon Rekognition クイックスタート ガイドの前提条件を満たしている場合は、以下の 「手順 」セクションに直接進むことができます。

1. Amazon Rekognition のセットアップ 手順を完了します。
2. 新しいオートメーション プロジェクトを作成します。

   1. UiPath Studio を開きます。

   2. [新しいプロジェクト] の [プロセス] をクリックします ([新しい空のプロセス] ウィンドウが開きます)。

   3. プロジェクトの [名前]、[場所]、[説明] を入力します。

   4. [Create] をクリックします。

      

3. UiPath.Amazon.Scope.Activities パッケージと UiPath.Amazon.Rekognition.Activities パッケージをインストールします。
   1. [デザイン] リボンの [パッケージを管理] をクリックします ([パッケージを管理] ウィンドウが開きます)。
   2. [すべてのパッケージ] の下の [Go!] をクリックします。
   3. 検索バーに「Amazon」と入力します。
   4. [インストール] をクリックし UiPath.Amazon.Scope.Activities と UiPath.Amazon.Rekognition.Activities の両方のライセンスに同意します。

      • UiPath Studio パッケージの詳細については、『Studio ガイド』の「パッケージの管理」をご覧ください。

        

手順

プロジェクトを構築する

[ 顔を識別 ] アクティビティを使用するには、以下の手順を実行します。

1. プロジェクトに [Amazon スコープ ] アクティビティを追加します。
2. 特定したい顔を含む既存のコレクションがない場合は、[ Amazon スコープ] アクティビティの後に [ コレクションを作成] アクティビティを追加します。それ以外の場合は、手順 3 に進みます。
3. 指定したコレクションに、識別する顔が保存されていない場合は、[ Amazon スコープ] または[コレクションを作成] (いずれか該当する) の後に [ 顔を追加] アクティビティを追加します。追加しない場合は、手順 4 に進みます。
4. 該当する場合、[ 顔を追加] アクティビティの後に [ 顔を識別] アクティビティを追加します。
5. 顔データの保存に使用する コレクション名 を入力します。
   • 推奨事項: 一貫性を確保するために、[コレクションを作成] アクティビティと [顔を追加] アクティビティの両方に同じ String 変数を使用してください。
6. コレクションに追加する顔を含む画像の [画像パス ] または [画像 URL ] を入力します。
   • 推奨事項: 画像の場所の String 変数を作成して、他のアクティビティ (例: [顔を比較]) で再利用できるようにします。
     • このプロジェクトの目標は、異なる画像で同じ顔を識別することであるため、この変数を [顔を追加 ] アクティビティの String 変数 (該当する場合) と同じにしないでください。
     • 下の画像例では、2 つの変数があることがわかります。imageOne 変数は [顔を追加] アクティビティで使用され、imageTwo 変数は [顔を識別] アクティビティで使用されます。
7. [顔] の値の Face[] 変数を作成し、入力します。
   • 変数を作成するときは、 UiPath.Amazon.Rekognition.Models.Face[] 変数の型を選択します。
   • この変数は、[ 顔を追加] アクティビティの Face[] 変数 (該当する場合) とは異なる必要があります。

     • 下の画像例では、2 つの変数があることがわかります。faceOne 変数は [顔を追加] アクティビティで使用され、faceTwo 変数は [顔を識別] アクティビティで使用されます。

       

プロジェクトをテストする

1. [ 顔を識別] アクティビティをテストするには、[ 顔を追加] アクティビティ (該当する場合) と [ 顔を識別] アクティビティの後に、[ 繰り返し (それぞれと 1 行を書き込み)] アクティビティを追加します。
2. [ 繰り返し (コレクション の各要素)] アクティビティで、[ 顔を追加] アクティビティの後
   1. [TypeArgument] プロパティで [UiPath.Amazon.Rekognition.Models.Face] を選択します。
   2. [値] プロパティに、[顔を追加] アクティビティ用に作成したFace[]変数を入力します (例: facesOne)。
   3. [テキスト] プロパティに「item」と入力します。ImageId です。
      • これにより、[顔を追加] アクティビティで割り当てた ImageID の値が返されます。
3. [繰り返し (コレクションの各要素)] アクティビティで、[顔を識別] アクティビティの後
   1. [TypeArgument] プロパティで [UiPath.Amazon.Rekognition.Models.Face] を選択します。
   2. [値] プロパティに、上記手順 3 で [顔を識別] アクティビティ用に作成したFace[]変数を入力します (例: facesTwo)。
   3. [テキスト] プロパティに「item」と入力します。ImageID+ " : " +itemです。FaceIDです。
      • これにより、[顔を追加] アクティビティで割り当てた ImageID 値と、Amazon Rekognition が割り当てた FaceID が返されます。
      • 以前に [顔を追加] アクティビティを使用しておらず、AWS CLI、AWS SDK API、または AWS コンソールを使用して顔を追加した場合、ImageID の値は Amazon Rekognition アクティビティの ExternalImageID データ型と同じです。
4. [実行] をクリックし、[出力] ウィンドウに次の 2 つの出力メッセージが表示されていることを確認します。
   1. [顔を追加] アクティビティから各顔に割り当てられた画像 ID。
      • 下の画像例では、入力画像に 3 つの面があるため、この値は 3 回返されます。
   2. 写真で識別された顔の ImageID と FaceID 。

      • 下の画像例では、 ImageID と FaceID の 1 つの値のみが返されます (3 つではありません)。これは、[ 顔を識別 ] アクティビティでは画像内で最大の顔しか識別できないためです。

        

完了です!

準備ができたら、他の クイックスタート ガイドを試して、さまざまな Amazon Rekognition アクティビティにさらに習熟してください。

他の Amazon Rekognition アクティビティの詳細については、「 アクティビティ 」ページを参照してください。すべてのアクティビティの一覧と、アクティビティの詳細ページへのリンクが記載されています。