本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 刪除人工循環
當您刪除人工循環時，狀態會變更為 `Deleting`。刪除人工循環時，相關聯的人工審核任務將無法再供工作者使用。在下列其中一種情況下，您可能想要刪除人工循環：
+ 用來產生工作者使用者介面的工作者任務範本未正確呈現，或無法正常運作。
+ 單一資料物件意外傳送給工作者多次。
+ 您不再需要人工審核的資料物件。
如果人工循環的狀態是 `InProgress`，則必須在刪除人工循環之前停止該循環。當您停止人工循環時，狀態會在停止時變更為 `Stopping`。當狀態會變更為 `Stopped`，可以刪除人工循環。
如果人力工作者已經在處理任務，而當您停止相關人工循環時，則該任務仍然可用，直到完成或過期為止。只要工作人員仍在處理任務，您的人工循環的狀態為 `Stopping`。如果這些任務已完成，結果會儲存在您的人工審核工作流程所指定的 Amazon S3 儲存貯體 URI 中。如果工作者在未提交工作的情況下離開任務，則會停止工作，且工作者無法返回任務。如果沒有工作者開始處理任務，則會立即停止該工作。
如果您刪除用來建立人工循環 AWS 的帳戶，系統會自動停止並刪除該帳戶。
## 人工循環資料保留與刪除
當人力工作者完成人工審核任務時，結果會存放在您在用於建立人工循環的人工審核工作流程中指定的 Amazon S3 輸出儲存貯體中。刪除或停止人工循環並不會移除 S3 儲存貯體中的任何背景工作者答案。
此外，Amazon A2I 會暫時在內部存放人工循環輸入和輸出資料，原因如下：
+ 如果您設定人工循環，以便將單一資料物件傳送給多個工作者進行審核，則 Amazon A2I 不會將輸出資料寫入 S3 儲存貯體，直到所有工作者完成審核任務。Amazon A2I 會在內部存放部分答案 (個別工作者的答案)，以便將完整的結果寫入 S3 儲存貯體。
+ 如果您回報低品質的人工審核結果，Amazon A2I 可以調查並回應您的問題。
+ 如果您無法存取或刪除用於建立人工循環的人工審核工作流程中指定的輸出 S3 儲存貯體，且任務已傳送給一或多個工作者，Amazon A2I 需要一個暫時存放人工審核結果的位置。
Amazon A2I 會在人工循環的狀態變更為下列其中一項後 30 天內刪除此資料：`Deleted`、`Stopped` 或 `Completed`。換句話說，資料會在人工循環完成、停止或刪除 30 天後刪除。此外，如果您關閉用來建立關聯人工循環 AWS 的帳戶，則會在 30 天後刪除此資料。
## 使用主控台或 Amazon A2I API ，停止或刪除流程定義
您可以在增強版 AI 主控台或使用 SageMaker API 停止和刪除人工循環。當狀態會變更為 `Deleted`，可以刪除人工循環。
**刪除人工循環 (主控台)**
1. 導覽至增強版 AI 主控台，網址為 [https://console.aws.amazon.com/a2i/](https://console.aws.amazon.com/a2i)。
1. 在導覽窗格的**增強版 AI** 區段下，選擇**人工審核工作流程**。
1. 選擇用於建立要刪除的人工循環的人工審核工作流程的超連結名稱。
1. 在頁面底部的**人工循環**區段中，選取您要停止並刪除的人工循環。
1. 如果人工循環狀態為 `Completed`、`Stopped`、或 `Failed`，請選取**刪除**。
如果人工循環**狀態**為 `InProgress`，請選取**停止**。當狀態變更為**已停止**時，請選取**刪除**。
**刪除人工循環 (API)**
1. 使用增強版 AI 執行期 API 作業 `[DescribeHumanLoop](https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/API_DescribeHumanLoop.html)` 檢查人工循環的狀態。請參閱下表中使用此作業的範例。
------
#### [ 適用於 Python (Boto3) 的 AWS SDK ]
下列範例使用了適用於 Python 的 SDK (Boto3) 來描述名為 {{example-human-loop}} 的人工循環。有關詳細資訊，請參閱*適用於 Python 的AWS SDK (Boto) API 參考*中的 [describe\_human\_loop](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}')
```
------
#### [ AWS CLI ]
下列範例使用 AWS CLI 描述名為 {{example-human-loop}} 的人工循環。有關詳細資訊，請參閱 [describe-human-loop](https://docs.aws.amazon.com/cli/latest/reference/sagemaker-a2i-runtime/describe-human-loop.html)，位在 *[AWS CLI 命令參考](https://docs.aws.amazon.com/cli/latest/reference/)*。
```
$ aws sagemaker-a2i-runtime describe-human-loop --human-loop-name '{{example-human-loop}}'
```
------
1. 如果流程定義狀態為 `Completed`、`Stopped`、或 `Failed`，請使用增強版 AI 執行期 API 作業 `[DeleteHumanLoop](https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/API_DeleteHumanLoop.html)` 刪除流程定義。
------
#### [ 適用於 Python (Boto3) 的 AWS SDK ]
下列範例使用適用於 Python 的 SDK (Boto3) 來刪除名為 {{example-human-loop}} 的人工循環。有關詳細資訊，請參閱*適用於 Python 的AWS SDK (Boto) API 參考*中的 [delete\_human\_loop](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}}')
```
------
#### [ AWS CLI ]
下列範例使用 AWS CLI 刪除名為 {{example-human-loop}} 的人工循環。有關詳細資訊，請參閱 [delete-human-loop](https://docs.aws.amazon.com/cli/latest/reference/sagemaker-a2i-runtime/delete-human-loop.html)，在 *[AWS CLI 命令參考](https://docs.aws.amazon.com/cli/latest/reference/)*。
```
$ aws sagemaker-a2i-runtime delete-human-loop --human-loop-name '{{example-human-loop}}'
```
------
如果人工循環狀態為 `InProgress`，請使用 `[StopHumanLoop](https://docs.aws.amazon.com/augmented-ai/2019-11-07/APIReference/API_StopHumanLoop.html)` 停止使用人工循環，然後使用 `DeleteHumanLoop` 將其刪除。
------
#### [ 適用於 Python (Boto3) 的 AWS SDK ]
下列範例使用適用於 Python 的 SDK (Boto3) 來描述名為 {{example-human-loop}} 的人工循環。有關詳細資訊，請參閱*適用於 Python 的AWS SDK (Boto) API 參考*中的 [stop\_human\_loop](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}}')
```
------
#### [ AWS CLI ]
下列範例使用 AWS CLI 描述名為 {{example-human-loop}} 的人工循環。有關詳細資訊，請參閱 [stop-human-loop](https://docs.aws.amazon.com/cli/latest/reference/sagemaker-a2i-runtime/stop-human-loop.html)，在 *[AWS CLI 命令參考](https://docs.aws.amazon.com/cli/latest/reference/)*。
```
$ aws sagemaker-a2i-runtime stop-human-loop --human-loop-name '{{example-human-loop}}'
```
------