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á.
# Gerenciando adaptadores com a AWS CLI e SDKs
O Rekognition permite que você use vários recursos que utilizam modelos de visão computacional pré-treinados. Com esses modelos, você pode realizar tarefas como detecção de rótulos e moderação de conteúdo. Você também pode personalizar esses determinados modelos usando um adaptador.
Você pode usar a criação e o gerenciamento de projetos do Rekognition APIs (como e [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion.html)) para criar [CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject.html)e treinar adaptadores. As páginas a seguir descrevem como usar as operações de API para criar, treinar e gerenciar seus adaptadores usando o AWS console, o AWS SDK escolhido ou a CLI AWS .
Depois de treinar um adaptador, você pode usá-lo ao executar a inferência com os recursos compatíveis. Atualmente, há suporte para adaptadores ao usar o recurso de moderação de conteúdo.
Ao treinar um adaptador usando um AWS SDK, você deve fornecer seus rótulos verdadeiros (anotações de imagem) na forma de um arquivo de manifesto. Como alternativa, você pode usar o Console do Rekognition para criar e treinar um adaptador.
**nota**
Os adaptadores não podem ser copiados. Apenas as versões do projeto Rekognition Custom Labels podem ser copiadas.
**Topics**
+ [Status do adaptador](#managing-adapters-project-versions-statuses)
+ [Criação de um projeto](managing-adapters-create-project.md)
+ [Descrevendo projetos](managing-adapters-describe-projects.md)
+ [Excluir um projeto](managing-adapters-delete-project.md)
+ [Criando uma versão do projeto](managing-adapters-create-project-version.md)
+ [Descrevendo uma versão do projeto](managing-adapters-describe-project.md)
+ [Excluindo uma versão do projeto](managing-adapters-delete-project-version.md)
## Status do adaptador
O adaptador de moderação personalizado (versões de projetos) pode estar em um dos seguintes status:
+ TRAINING\$1IN\$1PROGRESS: o adaptador está em processo de treinamento nos arquivos que você forneceu como documentos de treinamento.
+ TRAINING\$1COMPLETED: o adaptador concluiu com êxito o treinamento e está pronto para que você analise seu desempenho.
+ TRAINING\$1FAILED: o adaptador falhou ao concluir seu treinamento por algum motivo. Consulte o arquivo de manifesto de saída e o resumo do manifesto de saída para obter informações sobre a causa da falha.
+ DELETING: o adaptador está em processo de ser excluído.
+ DEPRECATED: o adaptador foi treinado em uma versão mais antiga do modelo básico de moderação de conteúdo. Está em um período de carência e expirará dentro de 60 a 90 dias após o lançamento da nova versão do modelo básico. Durante o período de carência, você ainda pode usar o adaptador para inferência [DetectModerationLabels](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectModerationLabels.html)ou operações de [StartMediaAnalysisJob](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartMediaAnalysisJob.html)API. Consulte o console de moderação personalizado para saber a data de validade dos seus adaptadores.
+ EXPIRADO - O adaptador foi treinado em uma versão mais antiga do modelo básico de moderação de conteúdo e não pode mais ser usado para obter resultados personalizados com as operações da StartMediaAnalysisJob API DetectModerationLabels ou da API. Se um adaptador expirado for especificado em uma solicitação de inferência, ele será ignorado e a resposta será retornada da versão mais recente do modelo básico de moderação personalizada.
# Criação de um projeto
Com a [CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject.html)operação, você pode criar um projeto que conterá um adaptador para as operações de detecção de etiquetas do Rekognition. Um projeto é um grupo de recursos e, no caso de operações de detecção de rótulos DetectModerationLabels, como, um projeto permite armazenar adaptadores que podem ser usados para personalizar o modelo básico do Rekognition. Ao invocar CreateProject, você fornece o nome do projeto que deseja criar para o ProjectName argumento.
Para criar um projeto com o AWS console:
+ Faça login no Console do Rekognition
+ Clique em **Moderação personalizada**
+ Escolha **Criar projeto**
+ Selecione **Criar um novo projeto** ou **Adicionar a um projeto existente**
+ Adicione um **Nome do Projeto**
+ Adicione um **Nome do adaptador**
+ Adicione uma descrição, se desejar
+ Escolha como você deseja importar suas imagens de treinamento: arquivo de manifesto, do bucket do S3 ou do seu computador
+ Escolha se você deseja dividir automaticamente seus dados de treinamento ou importar um arquivo de manifesto
+ Selecione se você deseja ou não que o projeto seja atualizado automaticamente
+ Clique em **Criar projeto**
Para criar um projeto com a AWS CLI e o SDK:
1. Se você ainda não tiver feito isso, instale e configure a AWS CLI e o. AWS SDKs Para obter mais informações, consulte [Etapa 2: configurar o AWS CLI e AWS SDKs](setup-awscli-sdk.md).
1. Use o código a seguir para criar um projeto:
------
#### [ CLI ]
```
# Request
# Creating Content Moderation Project
aws rekognition create-project \
--project-name "project-name" \
--feature CONTENT_MODERATION \
--auto-update ENABLED
--profile profile-name
```
------
# Descrevendo projetos
Você pode usar a [DescribeProjects](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjects.html)API para obter informações sobre seus projetos, incluindo informações sobre todos os adaptadores associados a um projeto.
Para descrever projetos com a AWS CLI e o SDK:
1. Se você ainda não tiver feito isso, instale e configure a AWS CLI e o. AWS SDKs Para obter mais informações, consulte [Etapa 2: configurar o AWS CLI e AWS SDKs](setup-awscli-sdk.md).
1. Use o código a seguir para descrever um projeto:
------
#### [ CLI ]
```
# Request
# Getting CONTENT_MODERATION project details
aws rekognition describe-projects \
--features CONTENT_MODERATION
--profile profile-name
```
------
# Excluir um projeto
Você pode excluir um projeto usando o console do Rekognition ou chamando a API. [DeleteProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProject.html) Para excluir um projeto, primeiro você deve excluir cada um dos adaptadores associados. Um projeto ou modelo excluído não pode ser excluído.
Para excluir um projeto com o AWS console:
+ Faça login no Console do Rekognition.
+ Clique em **Moderação personalizada**.
+ Você deve excluir cada adaptador associado ao seu projeto antes de excluir o projeto em si. Exclua todos os adaptadores associados ao projeto selecionando o adaptador e, em seguida, selecionando **Excluir**.
+ Selecione o projeto e, em seguida, selecione o botão **Excluir**.
Para excluir um projeto com a AWS CLI e o SDK:
1. Se você ainda não tiver feito isso, instale e configure a AWS CLI e o. AWS SDKs Para obter mais informações, consulte [Etapa 2: configurar o AWS CLI e AWS SDKs](setup-awscli-sdk.md).
1. Use o código a seguir para excluir um projeto:
------
#### [ CLI ]
```
aws rekognition delete-project
--project-arn project_arn \
--profile profile-name
```
------
# Criando uma versão do projeto
Você pode treinar um adaptador para implantação usando a [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion.html)operação. CreateProjectVersion primeiro cria uma nova versão de um adaptador associado a um projeto e, em seguida, começa a treinar o adaptador. A resposta de CreateProjectVersion é um Amazon Resource Name (ARN) para a versão do modelo. O treinamento demora um pouco para ser concluído. Você pode obter o status atual ligando DescribeProjectVersions. Ao treinar um modelo, o Rekognition usa os conjuntos de dados de treinamento e teste associados ao projeto. Você cria conjuntos de dados usando o console. Para obter mais informações, consulte a seção sobre conjuntos de dados.
Para criar uma versão do projeto com o console do Rekognition:
+ Faça login no console do AWS Rekognition
+ Clique em Moderação personalizada
+ Selecione um projeto.
+ Na página "Detalhes do projeto", escolha **Criar adaptador**
+ Na página "Criar um projeto", preencha os detalhes necessários para Detalhes do projeto, imagens de treinamento e imagens de teste e selecione **Criar projeto** .
+ Na página "Atribuir rótulos às imagens", adicione rótulos às suas imagens e, ao terminar, selecione **Iniciar treinamento **
Para criar uma versão do projeto com a AWS CLI e o SDK:
1. Se você ainda não tiver feito isso, instale e configure a AWS CLI e o. AWS SDKs Para obter mais informações, consulte [Etapa 2: configurar o AWS CLI e AWS SDKs](setup-awscli-sdk.md).
1. Use o código a seguir para criar uma versão do projeto:
------
#### [ CLI ]
```
# Request
aws rekognition create-project-version \
--project-arn project-arn \
--training-data '{Assets=[GroundTruthManifest={S3Object="amzn-s3-demo-source-bucket",Name="manifest.json"}]}' \
--output-config S3Bucket=amzn-s3-demo-destination-bucket,S3KeyPrefix=my-results \
--feature-config "ContentModeration={ConfidenceThreshold=70}"
--profile profile-name
```
------
# Descrevendo uma versão do projeto
Você pode listar e descrever os adaptadores associados a um projeto usando a [DescribeProjectVersions](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjectVersions.html)operação. Você pode especificar até 10 versões do modelo em ProjectVersionArns. Se você não especificar um valor, as descrições de todas as versões do modelo no projeto serão retornadas.
Para descrever uma versão do projeto com a AWS CLI e o SDK:
1. Se você ainda não tiver feito isso, instale e configure a AWS CLI e o. AWS SDKs Para obter mais informações, consulte [Etapa 2: configurar o AWS CLI e AWS SDKs](setup-awscli-sdk.md).
1. Use o código a seguir para descrever uma versão do projeto:
------
#### [ CLI ]
```
aws rekognition describe-project-versions
--project-arn project_arn \
--version-names [versions]
```
------
# Excluindo uma versão do projeto
Você pode excluir um adaptador Rekognition associado a um projeto usando a operação. [DeleteProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProjectVersion.html) Você não pode excluir um adaptador se ele estiver em execução ou em treinamento. Para verificar o status de um adaptador, chame a DescribeProjectVersions operação e verifique o campo Status retornado por ela. Para interromper uma chamada de adaptador em execução StopProjectVersion. Se o modelo estiver treinando, espere até que ele termine o treinamento para excluí-lo. Você deve excluir cada adaptador associado ao seu projeto antes de excluir o projeto em si.
Para excluir uma versão do projeto com o console do Rekognition:
+ Faça login no Console do Rekognition
+ Clique em Moderação personalizada
+ Na guia Projetos, você pode ver todos os seus projetos e adaptadores associados. Selecione um adaptador e, em seguida, selecione **Excluir**.
Para excluir uma versão do projeto com a AWS CLI e o SDK:
1. Se você ainda não tiver feito isso, instale e configure a AWS CLI e o. AWS SDKs Para obter mais informações, consulte [Etapa 2: configurar o AWS CLI e AWS SDKs](setup-awscli-sdk.md).
1. Use o código a seguir para excluir uma versão do projeto:
------
#### [ CLI ]
```
# Request
aws rekognition delete-project-version
--project-version-arn model_arn \
--profile profile-name
```
------