activities
latest
false
UiPath logo, featuring letters U and I in white
Classic Integrations Activities
Last updated Nov 8, 2024

Identify Face

UiPath.AmazonRekognition.Activities.AddFace

The Identify Face activity uses the Amazon Rekognition SearchFacesByImage API to first detect the largest face in your input image (ImagePath or ImageURL), then search the specified collection (Collection) for matching faces. The activity compares the features of the input face with the faces in the collection and outputs an array of faces (Faces) that match your input image.

Summary

Dependencies

Dependency

Details

Packages

UiPath.Amazon.Rekognition.Activities

Activities

Create Collection (unless a collection already exists)

Add Face (unless the collection already contains the faces you want to identify)

Attributes

Attribute

Details

Input Datatypes (Variables)

String

Applies to property: ImagePath,ImageURL, and CollectionName

Output Datatypes (Variables)

Faces[]

  • Applies to property: Faces
  • For more information, see the Face datatype in the Amazon Rekognition API documentation.

API used

Amazon Rekognition - SearchFacesByImage

Examples

Properties

The values for the following properties are specified when adding this activity to your project in UiPath Studio.



Common

DisplayName

The display name of the activity.

Attributes

Details

Type

String

Required

Yes

Default value

Identify Face

Allowed values

Enter a String or String variable.

Notes

N/A

Input

CollectionName

The name or ID of an existing collection that you want to use to identify detected faces.

Attributes

Details

Type

String

Required

Yes

Default value

Empty

Allowed values

Enter a String or String variable.

Notes

  • If you have an existing collection that you want to use, enter its exact collection name.
  • There is not an activity to retrieve a list of your collection names, but you can call the ListCollections API directly using the AWS CLI or AWS SDK API.

ImagePath

The path to a local image that you want to analyze.

Attributes

Details

Type

String

Required

Yes (if the ImageURL is empty)

Default value

Empty

Allowed values

Enter a String or String variable.

Notes

  • Either the ImagePath or ImageURL property is required.
  • If you enter values for both the ImagePath and ImageURL, the Image Path value is used.

ImageURL

The URL of an image that you want to analyze.

Attributes

Details

Type

String

Required

Yes (if the ImagePath is empty)

Default value

Empty

Allowed values

Enter a String or String variable.

Notes

  • Either the ImagePath or ImageURL property is required.
  • If you enter values for both the ImagePath and ImageURL, the Image Path value is used.

Misc

Private

If selected, the values of variables and arguments are no longer logged at Verbose level.

Attributes

Details

Type

Checkbox

Required

No

Default value

Not Selected

Allowed values

Selected or Not Selected

Notes

N/A

Options

Confidence

The minimum confidence value (i.e., percentage of similarity) to consider the faces to be a match.

Attributes

Details

Type

Double

Required

No

Default value

0.70 (not displayed in the property)

Allowed values

Enter a number between 0 and 1 to indicate the percentage of similarity (e.g., enter .8 if you want the similarity to be 80%).

Notes

  • If this property is set, the Faces property only returns the faces that meet or exceed the specified value
  • Example: If you enter a value of .8, the faces in the ImagePath or ImageURL image are considered identified to the faces in the Collection if the activity returns a confidence level of .8 or greater. If the activity returns a confidence level less than .8, the faces are not considered identified and the Faces property returns a null value.

MaxResults

The maximum number of faces that you want the activity to return in the response.

Attributes

Details

Type

Int32

Required

No

Default value

Empty

Allowed values

Enter a Int32 or Int32 variable.

Notes

N/A

Output

Faces

An array of faces that match the face specified in the input image.

Attributes

Details

Type

Face[]

UiPath.Amazon.Rekognition.Models.Face[]

Required

No (recommended if you plan to use the output data in subsequent activities)

Default value

Empty

Allowed values

Enter your value as a Face[] variable.

Notes

  • If the Confidence value is set, the array only includes the faces that meet or exceed the specified level of similarity.
  • If you plan to use the For Each activity to process the array output, select UiPath.Amazon.Rekognition.Models.Face as the TypeArgument.
  • Summary
  • Dependencies
  • Attributes
  • Properties
  • Common
  • Input
  • Misc
  • Options
  • Output

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.