Identify Face

UiPath.AmazonRekognition.Activities.AddFace

Die Aktivität Identify Face verwendet die Amazon Rekognition SearchFacesByImage- API, um zuerst das größte Gesicht in Ihrem Eingabebild (ImagePath oder ImageURL) zu erkennen und dann die angegebene Sammlung (Collection) nach übereinstimmenden Gesichtern zu durchsuchen. Die Aktivität vergleicht die Merkmale des Eingabegesichts mit den Gesichtern in der Sammlung und gibt ein Array von Gesichtern (Gesichter) aus, die mit Ihrem Eingabebild übereinstimmen.

Zusammenfassung

Abhängigkeiten

Abhängigkeit	Details
Pakete	UiPath.Amazon.Rekognition.Activities
Aktivitäten	Amazon Scope Sammlung erstellen (es sei denn, die Sammlung enthält bereits die Gesichter, die Sie identifizieren möchten)

Attribute

Attribut	Details
Eingabedatentypen (Variablen)	String Gilt für die Eigenschaft: Bildpfad , Bild-URL und Sammlungsname
Ausgabedatentypen (Variablen)	Faces[] Gilt für die Eigenschaft: Gesichter For more information, see the Face datatype in the Amazon Rekognition API documentation.
Verwendete API	Amazon Rekognition - SearchFacesByImage
Beispiele	Schnellstart

Eigenschaften

Die Werte für die folgenden Eigenschaften werden beim Hinzufügen dieser Aktivität zu Ihrem Projekt in UiPath Studio angegeben.

Allgemein

DisplayName

Der Anzeigename der Aktivität.

Attribute	Details
Typ	String
Erforderlich	Ja
Standardwert	Identify Face
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Keine Angabe

Eingabe

CollectionName

Der Name oder die ID einer vorhandenen Sammlung, die Sie zum Identifizieren erkannter Gesichter verwenden möchten.

Attribute	Details
Typ	String
Erforderlich	Ja
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Wenn Sie bereits eine Sammlung haben, die Sie verwenden möchten, geben Sie den genauen Sammlungsnamen ein. 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.

Bildpfad

Der Pfad zu einem lokalen Bild, das Sie analysieren möchten.

Attribute	Details
Typ	String
Erforderlich	Ja (wenn die Bild-URL leer ist)
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Entweder die Eigenschaft Bildpfad oder BildURL ist erforderlich. Wenn Sie Werte sowohl für den Bildpfad als auch für die Bild-URL eingeben, wird der Wert des Bildpfads verwendet.

BildURL

Die URL eines Bilds, das Sie analysieren möchten.

Attribute	Details
Typ	String
Erforderlich	Ja (wenn der Bildpfad leer ist)
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Entweder die Eigenschaft Bildpfad oder BildURL ist erforderlich. Wenn Sie Werte sowohl für den Bildpfad als auch für die Bild-URL eingeben, wird der Wert des Bildpfads verwendet.

Sonstiges

Private

Falls ausgewählt werden die Werte von Variablen und Argumenten nicht mehr auf ausführlicher Ebene protokolliert.

Attribute	Details
Typ	Kontrollkästchen
Erforderlich	Nein
Standardwert	nicht ausgewählt
Zulässige Werte	Ausgewählt oder nicht ausgewählt
Hinweise	Keine Angabe

Optionen

Confidence

Der minimale Konfidenzwert (d. h. Prozentsatz der Ähnlichkeit), für den die Gesichter als übereinstimmend betrachtet werden.

Attribute	Details
Typ	Double
Erforderlich	Nein
Standardwert	0,70 (nicht in der Eigenschaft angezeigt)
Zulässige Werte	Geben Sie eine Zahl zwischen 0 und 1 ein, um den Prozentsatz der Ähnlichkeit anzugeben (z. B. geben Sie .8 ein, wenn die Ähnlichkeit 80 % betragen soll).
Hinweise	Wenn diese Eigenschaft festgelegt ist, gibt die Eigenschaft Gesichter nur die Gesichter zurück, die den angegebenen Wert erfüllen oder überschreiten Beispiel: Wenn Sie einen Wert von .8 eingeben, werden die Gesichter im ImagePath- oder ImageURL- Bild als mit den Gesichtern in der Sammlung identifiziert, wenn die Aktivität ein Konfidenzniveau von .8 oder höher zurückgibt. Wenn die Aktivität eine Konfidenzstufe von weniger als .8 zurückgibt, gelten die Gesichter nicht als identifiziert und die Eigenschaft Gesichter gibt einen Null-Wert zurück.

MaxErgebnisse

Die maximale Anzahl von Gesichtern, die die Aktivität in der Antwort zurückgeben soll.

Attribute	Details
Typ	Int32
Erforderlich	Nein
Standardwert	Leer
Zulässige Werte	Geben Sie eine Int32 oder Int32 -Variable ein.
Hinweise	Keine Angabe

Ausgabe

Gesichter

Ein Array von Gesichtern, die mit dem im Eingabebild angegebenen Gesicht übereinstimmen.

Attribute	Details
Typ	Face[] UiPath.Amazon.Rekognition.Models.Face[]
Erforderlich	Nein (empfohlen, wenn Sie die Ausgabedaten in nachfolgenden Aktivitäten verwenden möchten)
Standardwert	Leer
Zulässige Werte	Geben Sie Ihren Wert als Face[] -Variable ein.
Hinweise	Wenn der Konfidenz- Wert festgelegt ist, enthält das Array nur die Gesichter, die die angegebene Ähnlichkeitsstufe erfüllen oder überschreiten. If you plan to use the For Each activity to process the array output, select UiPath.Amazon.Rekognition.Models.Face as the TypeArgument.