Identify Face

UiPath.AmazonRekognition.Activities.AddFace

L'activité Identifier le visage ( Identify Face ) utilise l'API Amazon Rekognition SearchFacesByImage pour détecter d'abord le plus grand visage dans votre image d'entrée (ImagePath ou ImageURL), puis recherche la collection spécifiée (Collection) pour les visages correspondants. L'activité compare les caractéristiques du visage d'entrée avec celles de la collection et génère un tableau de visages (Visages) qui correspond à votre image d'entrée.

Résumé

Dépendances

Dépendance	Détails (Details)
Paquets	UiPath.Amazon.Rekognition.Activities
Activités (Activities)	Amazon Scope Créer une collection (sauf si une collection existe déjà) Ajouter un visage (Add Face ) (sauf si la collection contient déjà les visages que vous souhaitez identifier)

Attributs

Attribut	Détails (Details)
Types de données d'entrée (variables)	String S'applique à la propriété : CheminImage,ImageURL et CollectionName
Types de données de sortie (variables)	Faces[] S'applique à la propriété : Faces Pour plus d'informations, consultez le type de données Face dans la documentation de l'API Amazon Rekognition.
API utilisée	Amazon Rekognition - SearchFacesByImage
Exemples	Démarrage rapide

Propriétés

Les valeurs des propriétés suivantes sont spécifiées lors de l'ajout de cette activité à votre projet dans UiPath Studio.

Commun

DisplayName

Le nom complet de l’activité.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Oui (Yes)
Valeur par défaut	Identify Face
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	S/O

Entrée

CollectionName

Le nom ou l'ID d'une collection existante que vous souhaitez utiliser pour identifier les visages détectés.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Oui (Yes)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	Si vous avez une collection existante que vous souhaitez utiliser, entrez son nom de collection exact. Il n'existe pas d'activité permettant de récupérer une liste de vos noms de collection, mais vous pouvez appeler l'API ListCollections directement à l'aide de l' AWS CLI ou de l' API AWS SDK.

CheminImage

Le chemin d'accès à une image locale que vous souhaitez analyser.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Oui (si ImageURL est vide)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	La propriété CheminImage ou URLImage est requise. Si vous entrez des valeurs pour CheminImage et URLImage, la valeur Chemin d'accès à l'image est utilisée.

URLImage

L'URL d'une image que vous souhaitez analyser.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Oui (si ImagePath est vide)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	La propriété CheminImage ou URLImage est requise. Si vous entrez des valeurs pour CheminImage et URLImage, la valeur Chemin d'accès à l'image est utilisée.

Divers

Private

Si elles sont sélectionnées, les valeurs des variables et des arguments ne sont plus enregistrées au niveau détaillé.

Attributs	Détails (Details)
Saisie de texte	Case à cocher
Requis	Non (No)
Valeur par défaut	non sélectionné
Valeurs autorisées	Sélectionné ou Non sélectionné
Remarques	S/O

Options

Confidence

La valeur de confiance minimale (c'est-à-dire le pourcentage de similarité) pour considérer que les visages correspondent.

Attributs	Détails (Details)
Saisie de texte	Double
Requis	Non (No)
Valeur par défaut	0,70 (non affiché dans la propriété)
Valeurs autorisées	Saisissez un nombre entre 0 et 1 pour indiquer le pourcentage de similarité (par exemple, saisissez 0,8 si vous souhaitez que la similarité soit de 80 %).
Remarques	Si cette propriété est définie, la propriété Faces ne renvoie que les visages qui respectent ou dépassent la valeur spécifiée Exemple : si vous saisissez une valeur de 0,8, les visages de l'image CheminImage ou ImageURL sont considérés comme identifiés par les visages de la collection si l'activité renvoie un niveau de confiance de 0,8 ou plus. Si l'activité renvoie un niveau de confiance inférieur à 0,8, les visages ne sont pas considérés comme identifiés et la propriété Visages renvoie une valeur null.

RésultatsMax

Le nombre maximal de visages que vous souhaitez que l'activité renvoie dans la réponse.

Attributs	Détails (Details)
Saisie de texte	Int32
Requis	Non (No)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable Int32 ou Int32 .
Remarques	S/O

Sortie

Visages

Un tableau de visages qui correspond au visage spécifié dans l'image d'entrée.

Attributs	Détails (Details)
Saisie de texte	Face[] UiPath.Amazon.Rekognition.Models.Face[]
Requis	Non (recommandé si vous prévoyez d'utiliser les données de sortie dans des activités ultérieures)
Valeur par défaut	Vide
Valeurs autorisées	Entrez votre valeur en tant que variable Face[] .
Remarques	Si la valeur Confidence (Confidence) est définie, le tableau inclut uniquement les visages qui atteignent ou dépassent le niveau de similarité spécifié. Si vous prévoyez d'utiliser l'activité For Each pour traiter la sortie du tableau, sélectionnez UiPath.Amazon.Rekognition.Models.Face comme TypeArgument.