

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 监控和管理您的人工循环
<a name="a2i-monitor-humanloop-results"></a>

在启动人工审核循环后，您可以使用 [Amazon Augmented AI 运行时系统 API](https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/Welcome.html) 检查和管理发送到循环的任务结果。此外，Amazon A2I 与 Amazon EventBridge（也称为 Amazon CloudWatch Events）集成，可在人工审核循环状态变为 `Completed`、`Failed` 或 `Stopped` 时提醒您。此事件传送保证至少进行一次，这意味着在人工循环结束后创建的所有事件都成功传送到 EventBridge。

使用以下过程可了解如何使用 Amazon A2I 运行时系统 API 监控和管理您的人工循环。请参阅[Amazon CloudWatch Events 在 Amazon Agumented AI 中使用](a2i-cloudwatch-events.md) 以了解如何将 Amazon A2I 与 Amazon EventBridge 集成。

**检查输出数据：**

1. 通过调用 [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) 操作来检查人工循环的结果。此 API 操作的结果包含有关循环激活的原因和结果的信息。

1. 在 Amazon Simple Storage Service (Amazon S3) 中检查来自人工循环的输出数据。在指向数据的路径中，`YYYY/MM/DD/hh/mm/ss` 表示人工循环创建日期的年 (`YYYY`)、月 (`MM`) 和日 (`DD`)，以及创建时间的小时 (`hh`)、分钟 (`mm`) 和秒 (`ss`)。

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

您可以将此结构与 AWS Glue 或 Amazon Athena 集成以便对输出数据进行分区和分析。有关更多信息，请参阅[管理 AWS Glue 中用于 ETL 输出的分区](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-partitions.html)。

要了解有关 Amazon A2I 输出数据格式的更多信息，请参阅 [Amazon A2I 输出数据](a2i-output-data.md)。

**停止和删除您的人工循环：**

1. 人工循环启动后，您可以使用 `HumanLoopName`，调用 [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) 操作来停止人工循环。如果人工循环已成功停止，则服务器将发送回 HTTP 200 响应。

1. 要删除状态等于 `Failed`、`Completed` 或 `Stopped` 的人工循环，请使用 [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) 操作。

**列出人工循环：**

1. 可通过调用 [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) 操作来列出所有活动的人工循环。可以使用 `CreationTimeAfter` 和 `CreateTimeBefore` 参数按循环的创建日期筛选人工循环。

1. 如果成功，`ListHumanLoops` 在响应元素中返回 [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) 和 `NextToken` 对象。`HumanLoopSummaries` 包含有关单个人工循环的信息。例如，它列出循环的状态和（如果适用）失败原因。

   将 `NextToken` 中返回的字符串用作对 `ListHumanLoops` 的后续调用中的输入以查看下一页人工循环。