翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ヒューマンループの監視と管理
<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` に変わったときに警告します。このイベント配信は少なくとも 1 回保証されます。つまり、ヒューマンループが終了したときに作成されたすべてのイベントが EventBridge に正常に配信されます。

次の手順を使用して、Amazon A2I ランタイム API を使用してヒューマンループをモニタリングおよび管理する方法を学習します。Amazon A2I がどのように Amazon EventBridge と統合されているのかについては、「[Amazon Augmented AI Amazon CloudWatch Events で を使用する](a2i-cloudwatch-events.md)」を参照してください。

**出力データを確認するには:**

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` への後続の呼び出しで入力として使用し、ヒューマンループの次のページを確認します。