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

# 删除人工循环
<a name="a2i-delete-human-loop"></a>

当您删除人工循环时，其状态更改为 `Deleting`。删除人工循环后，工作人员不再可以执行相关的人工审核任务。在以下任一情况下，您可能需要删除人工循环：
+ 用于生成工作人员用户界面的工作人员任务模板没有正确呈现或未按预期运行。
+ 单个数据对象被意外多次发送给工作人员。
+ 您不再需要通过人工审核数据对象。

如果人工循环的状态是 `InProgress`，您必须在删除人工循环之前停止它。当您停止人工循环时，在停止期间状态会变为 `Stopping`。当状态更改为 `Stopped` 时，您可以删除人工循环。

如果工作人员已在处理某个任务而您要停止关联的人工循环，则该任务将继续可用，直到完成或过期。只要工作人员仍在处理一项任务，您的人工循环的状态就是 `Stopping`。在完成这些任务后，结果将存储在人工审核工作流定义中指定的 Amazon S3 存储桶 URI 位置。如果工作人员在没有提交工作的情况下离开任务，则该任务将停止，工作人员无法返回任务。如果还没有工作人员开始处理任务，则会立即停止该任务。

如果您删除用于创建人工循环的 Amazon 帐户，则该帐户会自动停止并删除。

## 人工循环数据留存和删除
<a name="a2i-delete-human-loop-data-retention"></a>

当工作人员完成人工审核任务时，结果将存储在 Amazon S3 输出存储桶中，这是您在用于创建人工循环的人工审核工作流中指定的存储桶。删除或停止人工循环不会从 S3 存储桶中删除任何工作人员的回应。

此外，出于以下原因，Amazon A2I 会在内部暂时存储人工循环输入和输出数据：
+ 如果您配置人工循环，以便将单个数据对象发送给多个工作人员进行审核，那么直到所有工作人员均完成审核任务，Amazon A2I 才会将输出数据写入 S3 存储桶。Amazon A2I 在内部存储部分答案（来自单个工作人员的答案），以便以将完整结果写入 S3 存储桶。
+ 如果您报告了低质量的人工审核结果，Amazon A2I 可以调查并回应您的问题。
+ 对于输出 S3 存储桶（在用于创建人工循环的人工审核工作流中指定），如果您失去对其的访问权限或者将其删除，并且任务已经发送给一个或多个工作人员，Amazon A2I 需要一个地方来临时存储人工审核结果。

如果人工循环状态更改为以下状态之一，在 30 天后，Amazon A2I 将在内部删除此数据：`Deleted`、`Stopped` 或者 `Completed`。换而言之，在人工循环已完成、已停止或已删除的 30 天后，将会删除数据。此外，如果您关闭用于创建关联人机循环的 Amazon 账户，则这些数据将在 30 天后删除。

## 使用控制台或 Amazon A2I API 停止和删除流定义
<a name="a2i-delete-human-loop-how-to"></a>

您可以在 Augmented AI 控制台中或使用 SageMaker API 来停止和删除人工循环。当人工循环被删除后，状态变为 `Deleted`。

**删除人工循环（控制台）**

1. 导航到增强型 AI 控制台，网址为[https://console.aws.amazon.com/a2i/](https://console.amazonaws.cn/a2i)。

1. 在导航窗格中的 **Augmented AI** 部分下，选择**人工审核工作流**。

1. 对于要删除的人工循环，选择创建该循环所用人工审核工作流的带有超链接的名称。

1. 在页面底部的**人工循环**部分中，选择要停止和删除的人工循环。

1. 如果人工循环状态为 `Completed`、`Stopped` 或 `Failed`，请选择**删除**。

   如果人工循环的**状态**为 `InProgress`，请选择**停止**。当状态更改为**已停止**时，选择**删除**。

**删除人工循环 (API)**

1. 使用 Augmented AI 运行时系统 API 操作 `[DescribeHumanLoop](https://docs.amazonaws.cn/augmented-ai/2019-11-07/APIReference/API_DescribeHumanLoop.html)` 检查人工循环的状态。请参阅下表中的使用此操作的示例。

------
#### [ 适用于 Python (Boto3) 的 Amazon SDK ]

   以下示例使用适用于 Python 的 SDK (Boto3) 来描述名为的人类循环。*example-human-loop*有关更多信息，请参阅《Amazon SDK for Python (Boto) API 参考》**中的 [describe\$1human\$1loop](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker-a2i-runtime.html#AugmentedAIRuntime.Client.describe_human_loop)。

   ```
   import boto3
   
   a2i_runtime_client = boto3.client('sagemaker-a2i-runtime')
   response = a2i_runtime_client.describe_human_loop(HumanLoopName='example-human-loop')
   human_loop_status = response['HumanLoopStatus']
   print(f'example-human-loop status is: {human_loop_status}')
   ```

------
#### [ Amazon CLI ]

   以下示例使用 Amazon CLI 来描述名为的人工循环*example-human-loop*。有关更多信息，请参阅《[Amazon CLI 命令参考](https://docs.amazonaws.cn/cli/latest/reference/)》**中的 [describe-human-loop](https://docs.amazonaws.cn/cli/latest/reference/sagemaker-a2i-runtime/describe-human-loop.html)。

   ```
   $ aws sagemaker-a2i-runtime describe-human-loop --human-loop-name 'example-human-loop'
   ```

------

1. 如果流定义状态为 `Completed`、`Stopped` 或 `Failed`，则使用 Augmented AI 运行时系统 API 操作 `[DeleteHumanLoop](https://docs.amazonaws.cn/augmented-ai/2019-11-07/APIReference/API_DeleteHumanLoop.html)` 删除流定义。

------
#### [ 适用于 Python (Boto3) 的 Amazon SDK ]

   以下示例使用适用于 Python 的 SDK (Boto3) 删除名为的人工循环。*example-human-loop*有关更多信息，请参阅《Amazon SDK for Python (Boto) API 参考》**中的 [delete\$1human\$1loop](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker-a2i-runtime.html#AugmentedAIRuntime.Client.delete_human_loop)。

   ```
   import boto3
   
   a2i_runtime_client = boto3.client('sagemaker-a2i-runtime')
   response = a2i_runtime_client.delete_human_loop(HumanLoopName='example-human-loop')
   ```

------
#### [ Amazon CLI ]

   以下示例使用 Amazon CLI 删除名为的人工循环*example-human-loop*。有关更多信息，请参阅《[Amazon CLI 命令参考](https://docs.amazonaws.cn/cli/latest/reference/)》**中的 [delete-human-loop](https://docs.amazonaws.cn/cli/latest/reference/sagemaker-a2i-runtime/delete-human-loop.html)。

   ```
   $ aws sagemaker-a2i-runtime delete-human-loop --human-loop-name 'example-human-loop'
   ```

------

   如果人工循环状态为 `InProgress`，则使用 `[StopHumanLoop](https://docs.amazonaws.cn/augmented-ai/2019-11-07/APIReference/API_StopHumanLoop.html)` 停止人工循环，然后使用 `DeleteHumanLoop` 进行删除。

------
#### [ 适用于 Python (Boto3) 的 Amazon SDK ]

   以下示例使用适用于 Python 的 SDK (Boto3) 来描述名为的人类循环。*example-human-loop*有关更多信息，请参阅《Amazon SDK for Python (Boto) API 参考》**中的 [stop\$1human\$1loop](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker-a2i-runtime.html#AugmentedAIRuntime.Client.stop_human_loop)。

   ```
   import boto3
   
   a2i_runtime_client = boto3.client('sagemaker-a2i-runtime')
   response = a2i_runtime_client.stop_human_loop(HumanLoopName='example-human-loop')
   ```

------
#### [ Amazon CLI ]

   以下示例使用 Amazon CLI 来描述名为的人工循环*example-human-loop*。有关更多信息，请参阅《[Amazon CLI 命令参考](https://docs.amazonaws.cn/cli/latest/reference/)》**中的 [stop-human-loop](https://docs.amazonaws.cn/cli/latest/reference/sagemaker-a2i-runtime/stop-human-loop.html)。

   ```
   $ aws sagemaker-a2i-runtime stop-human-loop --human-loop-name 'example-human-loop'
   ```

------