As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Etapa 4: Começando a usar o console do Amazon Rekognition
O console do Amazon Rekognition permite que você gerencie recursos relacionados aos rótulos personalizados do Rekognition e ao atributo de moderação personalizada. O console fornece apenas demonstrações de outros atributos do Rekognition.
Esta seção mostra como usar um subconjunto dos recursos do Amazon Rekognition, como detecção de objetos e cenas, análise facial e comparação de faces em um conjunto de imagens. Para obter mais informações, consulte [Como o Amazon Rekognition funciona](how-it-works.md). Você também pode usar a AWS CLI API Amazon Rekognition ou para detectar objetos e cenas, detectar rostos e comparar e pesquisar faces. Para obter mais informações, consulte [Etapa 3: Começar a usar a API AWS CLI e AWS SDK](get-started-exercise.md).
Esta seção também mostra como ver as CloudWatch métricas agregadas da Amazon para o Rekognition usando o console do Rekognition.
**Topics**
+ [
## Configurar permissões do console
](#rekognition-console-permissions)
+ [
# Exercício 1: Detecte objetos e cenas (console)
](detect-labels-console.md)
+ [
# Exercício 2: Analisar faces em uma imagem (console)
](detect-faces-console.md)
+ [
# Exercício 3: Compare faces em imagens (console)
](compare-faces-console.md)
+ [
# Exercício 4: Ver métricas agregadas (console)
](aggregated-metrics.md)
![\[Página do produto de análise de imagem baseada em deep learning do Amazon Rekognition com os botões “Try Demo” e “Download”. SDKs\]](http://docs.aws.amazon.com/pt_br/rekognition/latest/dg/images/amazon-rekognition-start-page.png)
## Configurar permissões do console
Para usar o console do Rekognition, você precisa ter as permissões apropriadas para a função ou conta que está acessando o console. Para algumas operações, o Rekognition criará automaticamente um bucket do Amazon S3 para armazenar arquivos manipulados durante a operação. Se quiser armazenar seus arquivos de treinamento em um bucket diferente desse bucket de console, você precisará de permissões adicionais.
### Permitindo acesso ao console
Para usar o console do Rekognition, você pode usar uma política do IAM como a seguinte, que abrange o Amazon S3 e o console do Rekognition. Para obter informações sobre como atribuir permissões, consulte Atribuição de permissões.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "RekognitionFullAccess",
"Effect": "Allow",
"Action": [
"rekognition:*"
],
"Resource": "*"
},
{
"Sid": "RekognitionConsoleS3BucketSearchAccess",
"Effect": "Allow",
"Action": [
"s3:ListAllMyBuckets",
"s3:ListBucket",
"s3:GetBucketAcl",
"s3:GetBucketLocation"
],
"Resource": "*"
},
{
"Sid": "RekognitionConsoleS3BucketFirstUseSetupAccess",
"Effect": "Allow",
"Action": [
"s3:CreateBucket",
"s3:PutBucketVersioning",
"s3:PutLifecycleConfiguration",
"s3:PutEncryptionConfiguration",
"s3:PutBucketPublicAccessBlock",
"s3:PutBucketCors",
"s3:GetBucketCors"
],
"Resource": "arn:aws:s3:::rekognition-custom-projects-*"
},
{
"Sid": "RekognitionConsoleS3BucketAccess",
"Effect": "Allow",
"Action": [
"s3:ListBucket",
"s3:GetBucketLocation",
"s3:GetBucketVersioning"
],
"Resource": "arn:aws:s3:::rekognition-custom-projects-*"
},
{
"Sid": "RekognitionConsoleS3ObjectAccess",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:DeleteObject",
"s3:GetObjectAcl",
"s3:GetObjectTagging",
"s3:GetObjectVersion",
"s3:PutObject"
],
"Resource": "arn:aws:s3:::rekognition-custom-projects-*/*"
},
{
"Sid": "RekognitionConsoleManifestAccess",
"Effect": "Allow",
"Action": [
"groundtruthlabeling:*"
],
"Resource": "*"
},
{
"Sid": "RekognitionConsoleTagSelectorAccess",
"Effect": "Allow",
"Action": [
"tag:GetTagKeys",
"tag:GetTagValues"
],
"Resource": "*"
},
{
"Sid": "RekognitionConsoleKmsKeySelectorAccess",
"Effect": "Allow",
"Action": [
"kms:ListAliases"
],
"Resource": "*"
}
]
}
```
------
### Acessando buckets externos do Amazon S3
Quando você abre o console do Rekognition pela primeira vez em uma nova AWS região, o Rekognition cria um bucket (bucket do console) que é usado para armazenar arquivos do projeto. Como alternativa, você pode usar seu próprio bucket do Amazon S3 (bucket externo) para carregar as imagens ou o arquivo de manifesto no console. Para usar um bucket externo, adicione o seguinte bloco de políticas à política anterior.
```
{
"Sid": "s3ExternalBucketPolicies",
"Effect": "Allow",
"Action": [
"s3:GetBucketAcl",
"s3:GetBucketLocation",
"s3:GetObject",
"s3:GetObjectAcl",
"s3:GetObjectVersion",
"s3:GetObjectTagging",
"s3:ListBucket",
"s3:PutObject"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket*"
]
}
```
### Atribuindo permissões
Para conceder acesso, adicione as permissões aos seus usuários, grupos ou perfis:
+ Usuários e grupos no Centro de Identidade do AWS IAM (sucessor do AWS Single Sign-On):
Crie um conjunto de permissões. Siga as instruções em [Criar um conjunto de permissões no Guia](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtocreatepermissionset.html) do usuário do *Centro de Identidade do AWS IAM (sucessor do AWS Single Sign-On)*.
+ Usuários gerenciados no IAM com provedor de identidades:
Crie um perfil para a federação de identidades. Siga as instruções em [Criando um perfil para um provedor de identidades de terceiros (federação)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp.html) no *Guia do Usuário do IAM*.
+ Usuários do IAM:
+ Crie um perfil que seu usuário possa assumir. Siga as instruções em [Criação de um perfil para um usuário do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user.html) no *Guia do usuário do IAM*.
+ (Não recomendado) Vincule uma política diretamente a um usuário ou adicione um usuário a um grupo de usuários. Siga as instruções em [Adição de permissões a um usuário (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) no *Guia do usuário do IAM*.
# Exercício 1: Detecte objetos e cenas (console)
Esta seção mostra como, em um nível muito alto, a capacidade de detecção de objetos e cenas do Amazon Rekognition funciona. Quando você especifica uma imagem como entrada, o serviço detecta os objetos e as cenas na imagem e os retorna com uma pontuação de confiança percentual para cada objeto e cena.
Por exemplo, o Amazon Rekognition detecta os seguintes objetos e cenas na imagem de amostra: skate, esporte, pessoa, automóvel, carro e veículo.
![\[Pessoa fazendo uma acrobacia em um skate no meio de uma rua da cidade entre carros estacionados.\]](http://docs.aws.amazon.com/pt_br/rekognition/latest/dg/images/detect-scenes.png)
O Amazon Rekognition também retorna uma pontuação de confiança para cada objeto detectado na imagem de amostra, conforme mostrado na resposta de amostra a seguir.
![\[Gráfico exibindo pontuações de rótulos como Skate, Sport, People, Person, Human e Parking com altos valores de confiança em torno de 99%.\]](http://docs.aws.amazon.com/pt_br/rekognition/latest/dg/images/labels-confidence-score.png)
Para ver todas as pontuações de confiança mostradas na resposta, selecione **Show more (Mostrar mais)** no painel **Labels \$1 Confidence (Rótulos \$1 Confiança)**.
Você também pode observar a solicitação para a API e a resposta da API como referência.
Solicitação
```
{
"contentString":{
"Attributes":[
"ALL"
],
"Image":{
"S3Object":{
"Bucket":"console-sample-images",
"Name":"skateboard.jpg"
}
}
}
}
```
Resposta
```
{
"Labels":[
{
"Confidence":99.25359344482422,
"Name":"Skateboard"
},
{
"Confidence":99.25359344482422,
"Name":"Sport"
},
{
"Confidence":99.24723052978516,
"Name":"People"
},
{
"Confidence":99.24723052978516,
"Name":"Person"
},
{
"Confidence":99.23908233642578,
"Name":"Human"
},
{
"Confidence":97.42484283447266,
"Name":"Parking"
},
{
"Confidence":97.42484283447266,
"Name":"Parking Lot"
},
{
"Confidence":91.53300476074219,
"Name":"Automobile"
},
{
"Confidence":91.53300476074219,
"Name":"Car"
},
{
"Confidence":91.53300476074219,
"Name":"Vehicle"
},
{
"Confidence":76.85114288330078,
"Name":"Intersection"
},
{
"Confidence":76.85114288330078,
"Name":"Road"
},
{
"Confidence":76.21503448486328,
"Name":"Boardwalk"
},
{
"Confidence":76.21503448486328,
"Name":"Path"
},
{
"Confidence":76.21503448486328,
"Name":"Pavement"
},
{
"Confidence":76.21503448486328,
"Name":"Sidewalk"
},
{
"Confidence":76.21503448486328,
"Name":"Walkway"
},
{
"Confidence":66.71541595458984,
"Name":"Building"
},
{
"Confidence":62.04711151123047,
"Name":"Coupe"
},
{
"Confidence":62.04711151123047,
"Name":"Sports Car"
},
{
"Confidence":61.98909378051758,
"Name":"City"
},
{
"Confidence":61.98909378051758,
"Name":"Downtown"
},
{
"Confidence":61.98909378051758,
"Name":"Urban"
},
{
"Confidence":60.978023529052734,
"Name":"Neighborhood"
},
{
"Confidence":60.978023529052734,
"Name":"Town"
},
{
"Confidence":59.22066116333008,
"Name":"Sedan"
},
{
"Confidence":56.48063278198242,
"Name":"Street"
},
{
"Confidence":54.235477447509766,
"Name":"Housing"
},
{
"Confidence":53.85226058959961,
"Name":"Metropolis"
},
{
"Confidence":52.001792907714844,
"Name":"Office Building"
},
{
"Confidence":51.325313568115234,
"Name":"Suv"
},
{
"Confidence":51.26075744628906,
"Name":"Apartment Building"
},
{
"Confidence":51.26075744628906,
"Name":"High Rise"
},
{
"Confidence":50.68067932128906,
"Name":"Pedestrian"
},
{
"Confidence":50.59548568725586,
"Name":"Freeway"
},
{
"Confidence":50.568580627441406,
"Name":"Bumper"
}
]
}
```
Para obter mais informações, consulte [Como o Amazon Rekognition funciona](how-it-works.md).
## Detecte objetos e cenas em uma imagem que você fornece
Você pode fazer upload de uma imagem de sua propriedade ou fornecer o URL de uma imagem como entrada no console do Amazon Rekognition. O Amazon Rekognition retorna o objeto e as cenas, as pontuações de confiança de cada objeto e a cena que ele detecta na imagem que você fornece.
**nota**
A imagem deve ter menos de 5 MB e ser do formato JPEG ou PNG.
**Para detectar objetos e cenas em uma imagem fornecida por você**
1. Abra o console do Amazon Rekognition em. [https://console.aws.amazon.com/rekognition/](https://console.aws.amazon.com/rekognition/)
1. Escolha **Detecção de rótulos**.
1. Execute um destes procedimentos:
+ Carregue uma imagem – escolha **Upload**, vá até o local onde você armazenou a imagem e selecione-a.
+ Use uma URL – digite a URL na caixa de texto e escolha **Go**.
1. Exiba a pontuação de confiança de cada rótulo detectado no painel **Labels \$1 Confidence**.
Para obter mais opções de análise de imagem, consulte [Como trabalhar com imagens](images.md).
## Detecte objetos e pessoas em um vídeo que você fornece
Você pode fazer upload de um vídeo que você fornece como entrada no console do Amazon Rekognition. O Amazon Rekognition retorna as pessoas, objetos e rótulos detectados no vídeo.
**nota**
O vídeo de demonstração não deve ter mais de um minuto ou mais de 30 MB. Ele deve estar em formato de MP4 arquivo e codificado usando o codec H.264.
**Para detectar objetos e pessoas em um vídeo, forneça**
1. Abra o console do Amazon Rekognition em. [https://console.aws.amazon.com/rekognition/](https://console.aws.amazon.com/rekognition/)
1. Escolha **Análise de vídeo armazenado** na barra de navegação.
1. Em **Escolha uma amostra ou faça upload de sua própria**, selecione **Seu próprio vídeo** no menu suspenso.
1. Arraste e solte seu vídeo ou selecione-o no local onde você o armazenou.
Para obter mais opções de análise de vídeo, consulte [Trabalhar com operações de análise de vídeo armazenado](video.md) ou [Trabalhando com eventos de streaming de vídeo](streaming-video.md).
# Exercício 2: Analisar faces em uma imagem (console)
Esta seção mostra como usar o console do Amazon Rekognition para detectar faces e analisar atributos faciais em uma imagem. Quando você fornece uma imagem que contém uma face como entrada, o serviço detecta a face na imagem, analisa os atributos faciais e retorna uma pontuação de confiança percentual para a face e os atributos faciais detectados na imagem. Para obter mais informações, consulte [Como o Amazon Rekognition funciona](how-it-works.md).
Por exemplo, se você escolher a seguinte imagem de amostra como entrada, o Amazon Rekognition a detecta como um rosto e retorna pontuações de confiança para a face e os atributos faciais detectados.
![\[Mulher sorridente, usando óculos escuros, dirigindo um carro antigo amarelo com a estrada livre à frente.\]](http://docs.aws.amazon.com/pt_br/rekognition/latest/dg/images/sample-detect-faces.png)
A tabela a seguir mostra a resposta de amostra.
![\[Jovem sorridente, usando óculos escuros e parecendo feliz, com valores de confiança para rótulos.\]](http://docs.aws.amazon.com/pt_br/rekognition/latest/dg/images/detect-faces-confidence-score.png)
Se houver várias faces na imagem de entrada, o Rekognition detectará até 100 faces na imagem. Toda face detectada é marcada com um quadrado. Quando você clica na área marcada com um quadrado em uma face, o Rekognition exibe a pontuação de confiança dessa face e seus atributos detectados no painel **Faces \$1 Confiança**.
## Analise faces em uma imagem que você fornece
Você pode fazer upload de sua própria imagem ou fornecer o URL da imagem no console do Amazon Rekognition.
**nota**
A imagem deve ter menos de 5 MB e ser do formato JPEG ou PNG.
**Para analisar uma face em uma imagem fornecida por você**
1. Abra o console do Amazon Rekognition em. [https://console.aws.amazon.com/rekognition/](https://console.aws.amazon.com/rekognition/)
1. Escolha **Facial analysis**.
1. Execute um destes procedimentos:
+ Carregue uma imagem – escolha **Upload**, vá até o local onde você armazenou a imagem e selecione-a.
+ Use uma URL – digite a URL na caixa de texto e escolha **Go**.
1. Exiba a pontuação de confiança de uma das faces detectadas e seus traços faciais no painel **Faces \$1 Confidence** pane.
1. Se houver várias faces na imagem, escolha uma das outras faces para ver os atributos e as pontuações.
# Exercício 3: Compare faces em imagens (console)
Esta seção mostra como usar o console do Amazon Rekognition para comparar faces em um conjunto de imagens com várias faces. Quando você especifica uma imagem de **face de referência** (origem) e uma imagem de **Comparação de faces** (de destino), o Rekognition compara a maior face na imagem de origem (ou seja, a face de referência) com até 100 faces detectadas na imagem de destino (ou seja, as faces de comparação) e, em seguida, descobre até que ponto a face na fonte corresponde às faces na imagem de destino. A pontuação da semelhança de cada comparação é exibida no painel **Results**.
Se a imagem de destino contiver várias faces, o Rekognition combina a face na imagem de origem com até 100 faces detectadas na imagem de destino e, em seguida, atribui uma pontuação de similaridade a cada correspondência.
Se a imagem de origem contiver várias faces, o serviço detectará a maior na imagem de origem e a usará na comparação com cada face detectada na imagem de destino.
Para obter mais informações, consulte [Comparanda faces em imagens](faces-comparefaces.md).
Por exemplo, com a imagem de amostra mostrada à esquerda como imagem de origem e a imagem de amostra à direita como imagem de destino, o Rekognition detecta a face na imagem de origem, a compara com cada face detectada na imagem alvo e exibe uma pontuação de similaridade para cada par.
![\[Meninas rindo e se abraçando, com uma garota no centro e uma comparação mostrando os mesmos rostos detectados.\]](http://docs.aws.amazon.com/pt_br/rekognition/latest/dg/images/sample-compare-faces.png)
A tabela a seguir mostra as faces detectadas na imagem de destino e a pontuação de similaridade para cada face.
![\[Três conjuntos de imagens faciais com pontuações de similaridade: 92% de similaridade para o primeiro par, 0% para o segundo e terceiro pares.\]](http://docs.aws.amazon.com/pt_br/rekognition/latest/dg/images/sample-compare-faces-score.png)
## Compare faces em uma imagem que você fornece
Você pode enviar suas próprias imagens de origem e destino para o Rekognition para comparar as faces nas imagens ou especificar um URL para a localização das imagens.
**nota**
A imagem deve ter menos de 5 MB e ser do formato JPEG ou PNG.
**Para comparar faces nas imagens**
1. Abra o console do Amazon Rekognition em. [https://console.aws.amazon.com/rekognition/](https://console.aws.amazon.com/rekognition/)
1. Escolha **Face comparison**.
1. Para a imagem de origem, faça o seguinte:
+ Carregar uma imagem – escolha **Upload** à esquerda, vá até o local onde você armazenou a imagem de origem e selecione a imagem.
+ Usar uma URL – digite a URL da imagem de origem na caixa de texto e escolha **Go**.
1. Para a imagem de destino, faça o seguinte:
+ Carregar uma imagem – escolha **Upload** à direita, vá até o local onde você armazenou a imagem de origem e selecione a imagem.
+ Usar uma URL – digite a URL da imagem de origem na caixa de texto e escolha **Go**.
1. O Rekognition combina a maior face em sua imagem de origem com até 100 faces na imagem de destino e, em seguida, exibe a pontuação de similaridade de cada par no painel **Resultados**.
# Exercício 4: Ver métricas agregadas (console)
O painel de métricas do Amazon Rekognition mostra gráficos de atividades para um agregado de métricas individuais do Rekognition durante um período de tempo especificado. Por exemplo, a métrica agregada `SuccessfulRequestCount` mostra o número total de solicitações bem-sucedidas para todas as operações da API Rekognition nos últimos sete dias.
A tabela a seguir lista os gráficos exibidos no painel de métricas do Rekognition e a métrica correspondente do Rekognition. Para obter mais informações, consulte [CloudWatch métricas para Rekognition](rekognition-monitoring.md#cloudwatch-metricsdim).
| Gráfico | Métrica agregada |
| --- | --- |
| Chamadas bem-sucedidas | SuccessfulRequestCount |
| Erros de cliente | UserErrorCount |
| Erros de servidor | ServerErrorCount |
| Limitados | ThrottledCount |
| Rótulos detectados | DetectedLabelCount |
| Faces detectadas | DetectedFaceCount |
Cada gráfico mostra dados de métrica agregada coletados por um período especificado. A contagem total de dados de métrica agregada para o período também é exibida. Para ver métricas de chamadas à API individuais, escolha o link abaixo de cada gráfico.
Para permitir que os usuários acessem o painel de métricas do Rekognition, certifique-se de que o usuário tenha as permissões apropriadas e do Rekognition. CloudWatch Por exemplo, um usuário com permissões de política gerenciada `AmazonRekognitionReadOnlyAccess` e `CloudWatchReadOnlyAccess` pode ver o painel de métricas. Caso um usuário não tenha as permissões obrigatórias, quando o usuário abre o painel de métricas, nenhum gráfico é exibido. Para obter mais informações, consulte [Gerenciamento de identidade e acesso para o Amazon Rekognition](security-iam.md).
Para obter mais informações sobre o monitoramento do Rekognition com, consulte. CloudWatch [Monitorando o Rekognition com a Amazon CloudWatch](rekognition-monitoring.md)
**Para ver métricas agregadas (console)**
1. Abra o console do Amazon Rekognition em. [https://console.aws.amazon.com/rekognition/](https://console.aws.amazon.com/rekognition/)
1. No painel de navegação, selecione **Métricas**.
1. Na lista suspensa, selecione o período cuja métrica você deseja ver.
1. Para atualizar os gráficos, escolha o botão **Refresh**.
1. Para ver CloudWatch métricas detalhadas de uma métrica agregada específica, escolha **Ver detalhes CloudWatch** abaixo do gráfico métrico.