Identify Face

UiPath.AmazonRekognition.Activities.AddFace

La actividad Identificar rostro utiliza la API SearchFacesByImage de Amazon Rekognition para detectar primero el rostro más grande en tu imagen de entrada (ImagePath o ImageURL) y, a continuación, buscar en la colección especificada (Collection) los rostros coincidentes. La actividad compara las características de la cara de entrada con las caras de la colección y genera una matriz de caras (Caras) que coinciden con tu imagen de entrada.

Resumen

Dependencias

Dependencia	Detalles
Paquetes	UiPath.Amazon.Rekognition.Activities
Actividades	Amazon Scope Crear colección (a menos que ya exista una colección) Añadir rostro (a menos que la colección ya contenga los rostros que desea identificar)

Atributos

Atributo	Detalles
Tipos de datos de entrada (variables)	String Se aplica a la propiedad: RutaDeImagen,URLDeImagen y NombreDeColección
Tipos de datos de salida (variables)	Faces[] Se aplica a la propiedad: caras Para obtener más información, consulta el tipo de datos Face en la documentación de la API de Amazon Rekognition.
API utilizada	Amazon Rekognition: BuscarFacesPorImagen
Ejemplos	Inicio rápido

Propiedades

Los valores para las siguientes propiedades se especifican al agregar esta actividad a tu proyecto en UiPath Studio.

Común

NombreParaMostrar

El nombre para mostrar de la actividad.

Atributos	Detalles
Tipo	String
Obligatorio	Sí
Valor predeterminado	Identify Face
Valores permitidos	Introduce una variable String o String .
Notas	N/D

Entrada

CollectionName

El nombre o ID de una colección existente que quieres utilizar para identificar los rostros detectados.

Atributos	Detalles
Tipo	String
Obligatorio	Sí
Valor predeterminado	Vacío
Valores permitidos	Introduce una variable String o String .
Notas	Si tienes una colección existente que quieres usar, introduce su nombre de colección exacto. No hay una actividad para recuperar una lista de los nombres de tu colección, pero puedes llamar a la API ListCollections directamente utilizando la AWS CLI o la API del SDK de AWS.

RutaDeImagen

La ruta a la imagen local que desea analizar.

Atributos	Detalles
Tipo	String
Obligatorio	Sí (si la ImageURL está vacía)
Valor predeterminado	Vacío
Valores permitidos	Introduce una variable String o String .
Notas	Se requiere la propiedad RutaDeImagen o URLDeImagen . Si introduces valores para RutaDeImagen y URLDeImagen, se utiliza el valor de Ruta de imagen .

URLdeImagen

La URL de una imagen que desea analizar.

Atributos	Detalles
Tipo	String
Obligatorio	Sí (si la RutaDeImagen está vacía)
Valor predeterminado	Vacío
Valores permitidos	Introduce una variable String o String .
Notas	Se requiere la propiedad RutaDeImagen o URLDeImagen . Si introduces valores para RutaDeImagen y URLDeImagen, se utiliza el valor de Ruta de imagen .

Otros

Privado

Si se selecciona, los valores de variables y argumentos no estarán registrados a un nivel detallado.

Atributos	Detalles
Tipo	Casilla de verificación
Obligatorio	No
Valor predeterminado	no seleccionados
Valores permitidos	Seleccionado o no seleccionado
Notas	N/D

Opciones

Confianza

El valor de confianza mínimo (es decir, porcentaje de similitud) para considerar las caras como una coincidencia.

Atributos	Detalles
Tipo	Double
Obligatorio	No
Valor predeterminado	070 (no se muestra en la propiedad)
Valores permitidos	Introduzca un número entre 0 y 1 para indicar el porcentaje de similitud (por ejemplo, introduzca 0,8 si desea que la similitud sea del 80%).
Notas	Si se establece esta propiedad, la propiedad Caras solo devuelve las caras que cumplen o superan el valor especificado Ejemplo: si introduces un valor de 0,8, los rostros de la rutaImagen o la imagenURL se consideran identificadas con los rostros de la colección si la actividad devuelve un nivel de confianza de 0,8 o superior. Si la actividad devuelve un nivel de confianza inferior a 0,8, las caras no se consideran identificadas y la propiedad Caras devuelve un valor nulo.

ResultadosMáximos

El número máximo de rostros que desea que la actividad devuelva en la respuesta.

Atributos	Detalles
Tipo	Int32
Obligatorio	No
Valor predeterminado	Vacío
Valores permitidos	Introduce una variable Int32 o Int32 .
Notas	N/D

Salida

Rostros

Una matriz de rostros que coinciden con el rostro especificado en la imagen de entrada.

Atributos	Detalles
Tipo	Face[] UiPath.Amazon.Rekognition.Models.Face[]
Obligatorio	No (recomendado si planea usar los datos de salida en actividades posteriores)
Valor predeterminado	Vacío
Valores permitidos	Introduzca su valor como variable Face[] .
Notas	Si se establece el valor de Confianza , la matriz solo incluye los rostros que cumplen o superan el nivel de similitud especificado. Si tienes previsto utilizar la actividad Para cada para procesar la salida de la matriz, selecciona UiPath.Amazon.Rekognition.Models.Face como TypeArgument.