Identify Face

UiPath.AmazonRekognition.Activities.AddFace

A atividade Identify Face usa a API do Amazon Rekognition SearchFacesByImage para detectar primeiro o maior rosto na sua imagem de entrada (ImagePath ou ImageURL) e, em seguida, pesquisar a coleção especificada (Collection) em busca de rostos correspondentes. A atividade compara as características do rosto de entrada com os rostos na coleção e gera uma matriz de rostos (Rostos) que correspondem à sua imagem de entrada.

Summary

Dependências

Dependência	Detalhes
Pacotes	UiPath.Amazon.Rekonition.Activities
Atividades	Amazon Scope Criar coleção (a menos que já exista uma coleção) Adicionar Rosto (a menos que a coleção já contenha os rostos que você deseja identificar)

Atributos

Atributo	Detalhes
Tipos de Dados de Entrada (Variáveis)	String Aplica-se às propriedades: CaminhoDaImagem,UrlDaImagem e NomeDaColeção
Tipos de Dados de Saída (Variáveis)	Faces[] Aplica-se à propriedade: Rostos Para obter mais informações, consulte Tipo de dados Facial na documentação da API do Amazon Rekognition.
API usada	Amazon Rekognition - SearchFacesByImage
Exemplos	Início rápido

Propriedades

Os valores para as seguintes propriedades são especificados ao adicionar esta atividade ao seu projeto no UiPath Studio.

Comum

NomeDeExibição

O nome de exibição da atividade.

Atributos	Detalhes
Tipo	String
Required	Sim
Valor padrão	Identify Face
Valores permitidos	Insira uma variável String ou String .
Observações	N/A

Entrada

CollectionName

O nome ou ID de uma coleção existente que você deseja usar para identificar rostos detectados.

Atributos	Detalhes
Tipo	String
Required	Sim
Valor padrão	Vazio
Valores permitidos	Insira uma variável String ou String .
Observações	Se você tiver uma coleção existente que deseja usar, insira seu nome de coleção exato. Não há uma atividade para recuperar uma lista dos nomes de suas coleções, mas você pode chamar a API ListCollections diretamente usando o AWS CLI ou a API do AWS SDK.

CaminhoDaImagem

O caminho para uma imagem local que você deseja analisar.

Atributos	Detalhes
Tipo	String
Required	Sim (se UrlDaImagem estiver vazio)
Valor padrão	Vazio
Valores permitidos	Insira uma variável String ou String .
Observações	A propriedade CaminhoDaImagem ou UrlDaImagem é necessária. Se você inserir valores para o CaminhoDaImagem e o UrlDaImagem, o valor do Caminho da Imagem será usado.

UrlDaImagem

A URL de uma imagem que você deseja analisar.

Atributos	Detalhes
Tipo	String
Required	Sim (se CaminhoDaImagem estiver vazio)
Valor padrão	Vazio
Valores permitidos	Insira uma variável String ou String .
Observações	A propriedade CaminhoDaImagem ou UrlDaImagem é necessária. Se você inserir valores para o CaminhoDaImagem e o UrlDaImagem, o valor do Caminho da Imagem será usado.

Diversos

Particular

Se selecionado, os valores das variáveis e argumentos não são mais registrados no nível Verbose.

Atributos	Detalhes
Tipo	Caixa de seleção
Required	Não
Valor padrão	não selecionado
Valores permitidos	Selecionado ou Não Selecionado
Observações	N/A

Opções

Confidence

O valor mínimo de confiança (ou seja, porcentagem de similaridade) para considerar os rostos como uma correspondência.

Atributos	Detalhes
Tipo	Double
Required	Não
Valor padrão	0,70 (não exibido na propriedade)
Valores permitidos	Insira um número entre 0 e 1 para indicar a porcentagem de similaridade (por exemplo, insira .8 se você quiser que a similaridade seja 80%).
Observações	Se esta propriedade estiver definida, a propriedade Rostos retornará apenas os rostos que atendem ou excedem o valor especificado Exemplo: se você inserir um valor de .8, os rostos na imagem CaminhoDaImagem ou ImageURL serão considerados identificados como os rostos na Coleção se a atividade retornar um nível de confiança de .8 ou superior. Se a atividade retornar um nível de confiança inferior a .8, os rostos não serão considerados identificados e a propriedade Faces retornará um valor nulo.

ResultadosMáx

O número máximo de rostos que você deseja que a atividade retorne na resposta.

Atributos	Detalhes
Tipo	Int32
Required	Não
Valor padrão	Vazio
Valores permitidos	Insira uma variável Int32 ou Int32 .
Observações	N/A

Saída

Rostos

Uma matriz de rostos que corresponde ao rosto especificado na imagem de entrada.

Atributos	Detalhes
Tipo	Face[] UiPath.Amazon.Rekognition.Models.Face[]
Required	Não (recomendado se você planejar usar os dados de saída em atividades subsequentes)
Valor padrão	Vazio
Valores permitidos	Insira seu valor como uma variável Face[] .
Observações	Se o valor de Confiança for definido, a matriz incluirá apenas os rostos que atendem ou excedem o nível especificado de similaridade. Se você planeja usar a atividade For Each para processar a saída do array, selecione UiPath.Amazon.Rekognition.Models.Face como o TypeArgument.