Démarrage rapide - Identifier le visage

Vue d'ensemble (Overview)

L'objectif de ce guide est de vous aider à créer un exemple fonctionnel de l'activité Identifier le visage ( Identify Face ). Cet exemple de travail vous permet de vérifier rapidement la connexion à votre compte AWS et de vous familiariser avec les types de données d'entrée/de sortie de l'activité.

En suivant les étapes de ce guide, vous disposerez d'une séquence d'automatisation qui effectue les opérations suivantes :

1. Établit une connexion à votre compte AWS et aux services Amazon Rekognition via l'activité Amazon Scope .
2. Crée une nouvelle collection pour stocker des informations sur les visages détectés dans une image via l'activité Créer une collection (Create Collection) .
3. Détecte les visages dans une image et les ajoute à votre collection spécifiée via l'activité Ajouter un visage ( Add Face ).

4. Détecte le plus grand visage de votre image d'entrée et recherche dans la collection spécifiée (Collection) les visages correspondants ; renvoyant un tableau de visages identifiés via l’activité Identifier le visage (Identify Face ).

   5. Teste les propriétés d'entrée/de sortie des activités Amazon Rekognition via les activités For Each et Write Line .

Prérequis

Avant de commencer, remplissez les conditions préalables applicables ci-dessous.

Si vous avez rempli les conditions préalables d'un autre guide de démarrage rapide d'Amazon Rekognition , vous êtes prêt et pouvez accéder directement à la section Étapes ci-dessous.

1. Terminez les étapes de configuration d'Amazon Rekognition.
2. Créez un nouveau projet d'automatisation.
   1. Ouvrez UiPath Studio.
   2. Sous Nouveau projet, cliquez sur Traiter (cela ouvre une fenêtre Nouveau processus vide ).
   3. Saisissez un nomde projet , un emplacementet une description.
   4. Cliquez sur Créer (Create).
   
   

   

   
   
3. Installez les packages UiPath.Amazon.Scope.Activities et UiPath.Amazon.Rekognition.Activities .
   1. Dans le ruban Conception (Design), cliquez sur Gérer les packages ( Manage Packages ) (cela ouvre la fenêtre Gérer les packages ).
   2. Sous Tous les packages, cliquez sur Go!
   3. Dans la barre de recherche , saisissez Amazon.
   4. Cliquez sur, installez et acceptez la licence pour UiPath.Amazon.Scope.Activities et UiPath.Amazon.Rekognition.Activities.
      • Pour plus d’informations sur les packages UiPath Studio, consultez la section Gestion des packages dans le guide de Studio.

Étapes

Construire votre projet

Pour utiliser l'activité Identifier le visage ( Identify Face ) :

1. Ajoutez l'activité Amazon Scope à votre projet.
2. Si vous ne disposez pas d'une collection existante contenant les visages que vous souhaitez identifier, ajoutez l'activité Créer une collection (Create Collection) après l'activité Étendue Amazon ( Amazon Scope ), sinon, passez à l'étape 3.
3. Si vous n'avez pas les visages que vous souhaitez identifier stockés dans votre collection spécifiée, ajoutez l'activité Add Face après Amazon Scope ou Create Collection (selon le cas), sinon, passez à l'étape 4.
4. Ajoutez l'activité Identifier le visage après l'activité Ajouter un visage ( Add Face ) (le cas échéant).
5. Entrez le CollectionName que vous souhaitez utiliser pour stocker vos visages.
   • Recommandation : utilisez la même variable String pour les activités Créer une collection (Create Collection) et Ajouter des visages (Add Faces ) afin d'assurer la cohérence.
6. Entrez l' ImagePath ou ImageURL de l'image qui contient les visages que vous souhaitez ajouter à votre collection.
   • Recommandation : créez une variable String pour l'emplacement de votre image afin de pouvoir la réutiliser dans d'autres activités (par exemple, Comparer des visages ( Compare Faces)).
     • L'objectif de ce projet étant d'identifier le même visage sur différentes images, cette variable ne doit pas être la même que la variable String de l'activité Ajouter un visage ( Add Face ) (le cas échéant).
     • Dans l'image d'exemple ci-dessous, vous verrez qu'il y a deux variables. La variable imageOne est utilisée dans l'activité Add Face et la variable imageTwo est utilisée dans l'activité Identifier Face .
7. Créez et entrez une variable Face[] pour votre valeur Faces .
   • Lors de la création de votre variable, sélectionnez le type de variable UiPath.Amazon.Rekognition.Models.Face[] .
   • Cette variable doit être différente de la variable Face[] de l'activité Ajouter un visage ( Add Face ) (le cas échéant).
     • Dans l'image d'exemple ci-dessous, vous verrez qu'il y a deux variables. La variable faceOne est utilisée dans l'activité Add Face et la variable faceTwo est utilisée dans l'activité Identifier Face .

Testez votre projet

1. Pour tester l'activité Identifier le visage ( Identify Face ), ajoutez une activité Pour chaque ( For Each ) avec une activité Ligne d' écriture (Write Line ), après l'activité Ajouter un visage ( Add Face ) (le cas échéant) et l'activité Identifier le visage ( Identify Face ).
2. Dans l’activité For Each après l’activité Add Face :
   1. Dans la propriété TypeArgument , sélectionnez UiPath.Amazon.Rekognition.Models.Face.
   2. Dans la propriété Valeurs (Values), entrez la variable Face[] que vous avez créée pour l'activité Ajouter un visage ( Add Face ) (par exemple, facesOne).
   3. Dans la propriété Text , entrez item.ImageId.
      • Cela renvoie la valeur ImageID que vous avez attribuée via l'activité Ajouter un visage ( Add Face ).
3. Dans l’activité For Each après l’activité Identifier le visage :
   1. Dans la propriété TypeArgument , sélectionnez UiPath.Amazon.Rekognition.Models.Face.
   2. Dans la propriété Valeurs (Values), entrez la variable Face[] que vous avez créée pour l'activité Identifier le visage ( Identify Face ) à l'étape 3 ci-dessus (par exemple, facesTwo).
   3. Dans la propriété Text , saisissez item.ImageID+ " : " +item.FaceID.
      • Cela renvoie la valeur ImageID que vous avez attribuée via l'activité Ajouter un visage ( Add Face ), ainsi que le FaceID qu'Amazon Rekognition a attribué.
      • Si vous n'utilisiez pas auparavant l'activité Ajouter un visage ( Add Face ) et que vous ajoutiez un visage via l' API AWS CLI ou AWS SDK ou la console AWS, la valeur IDImage est la même que le type de données IDExterneImage ( ExternalImageID ) dans les activités Amazon Rekognition.
4. Cliquez sur Exécuter ( Run ) et vérifiez que la fenêtre Sortie (Output) inclut deux messages de sortie :
   1. L' IDImage attribué à chaque visage à partir de l'activité Ajouter un visage ( Add Face ).
      • Dans l'image d'exemple ci-dessous, cette valeur est renvoyée trois fois car il y a trois visages dans l'image d'entrée fournie)
   2. ImageID et FaceID du visage identifié dans l'image.
      • Dans l'image d'exemple ci-dessous, une seule valeur IDImage et FaceID est renvoyée (pas trois) ; en effet, l'activité Identifier le visage (Identifier le visage) ne peut identifier que le plus grand visage de l'image.

Vous avez terminé !

Lorsque vous êtes prêt, essayez les autres guides de démarrage rapide pour vous familiariser avec les différentes activités Amazon Rekognition.

Pour en savoir plus sur les autres activités Amazon Rekognition, consultez la page Activités pour obtenir une liste complète des activités et des liens vers les pages de détails des activités.