

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á.

# Monitorar e gerenciar seu loop humano
<a name="a2i-monitor-humanloop-results"></a>

Depois de iniciar um ciclo de revisão humana, você pode verificar os resultados das tarefas enviadas para o ciclo e gerenciá-lo usando a [API do Amazon Augmented AI Runtime](https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/Welcome.html). Além disso, o Amazon A2I integra-se com o Amazon EventBridge (também conhecido como Amazon CloudWatch Events) para alertá-lo quando o status de um ciclo de revisão humana muda para `Completed`, `Failed` ou `Stopped`. Essa entrega de eventos é garantida pelo menos uma vez, o que significa que todos os eventos criados quando os ciclos humanos são concluídos são entregues com sucesso ao EventBridge.

Use os procedimentos abaixo para aprender como usar a API do Amazon A2I Runtime para monitorar e gerenciar seus ciclos humanos. Consulte [Uso Amazon CloudWatch Events na Amazon Augmented AI](a2i-cloudwatch-events.md) para saber como o Amazon A2I se integra com o Amazon EventBridge.

**Como verificar os dados de saída:**

1. Verifique os resultados do seu loop humano chamando a operação [https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/API_DescribeHumanLoop.html](https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/API_DescribeHumanLoop.html). O resultado dessa operação de API contém informações sobre o motivo e o resultado da ativação do loop.

1. Verifique os dados de saída do seu loop humano no Amazon Simple Storage Service (Amazon S3). No caminho para os dados, `YYYY/MM/DD/hh/mm/ss` representa a data de criação do ciclo humano com o ano (`YYYY`), mês (`MM`) e dia (`DD`), e o horário de criação com a hora (`hh`), minuto (`mm`) e segundo (`ss`). 

   ```
   s3://customer-output-bucket-specified-in-flow-definition/flow-definition-name/YYYY/MM/DD/hh/mm/ss/human-loop-name/output.json
   ```

Você pode integrar essa estrutura com o AWS Glue ou o Amazon Athena para particionar e analisar seus dados de saída. Para obter mais informações, consulte [Gerenciar partições para a saída de ETL no AWS Glue AWS](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-partitions.html).

Para saber mais sobre o formato de dados de saída do Amazon A2I, consulte [Dados de saída do Amazon A2I](a2i-output-data.md).

**Para parar e excluir seu loop humano:**

1. Depois que um loop humano foi iniciado, você pode parar o loop humano chamando a operação [https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/API_StopHumanLoop.html](https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/API_StopHumanLoop.html) usando o `HumanLoopName`. Se um loop humano foi interrompido com êxito, o servidor retorna uma resposta HTTP 200. 

1. Para excluir um loop humano para o qual o status é igual a `Failed`, `Completed` ou `Stopped`, use a operação [https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/API_DeleteHumanLoop.html](https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/API_DeleteHumanLoop.html). 

**Como listar loops humanos:**

1. Você pode listar todos os loops humanos ativos chamando a operação [https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/API_ListHumanLoops.html](https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/API_ListHumanLoops.html). Você pode filtrar loops humanos pela data de criação do loop usando os parâmetros `CreationTimeAfter` e `CreateTimeBefore`. 

1. Se for bem sucedido, `ListHumanLoops` retorna [https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/API_HumanLoopSummary.html](https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/API_HumanLoopSummary.html) e objetos `NextToken` no elemento de resposta. `HumanLoopSummaries` contém informações sobre um único loop humano. Por exemplo, ele lista o status de um loop e, se aplicável, o motivo da falha. 

   Use a string retornada em `NextToken` como uma entrada em uma chamada subsequente para `ListHumanLoops` para ver a próxima página de loops humanos. 