翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# カスタムモデレーションのアダプターのチュートリアル
このチュートリアルでは、Rekognition コンソールを使用してアダプターを作成、トレーニング、評価、使用、管理する方法について説明します。 AWS SDK でアダプターを作成、使用、管理するには、「」を参照してください[CLI と SDKs AWS を使用したアダプターの管理](managing-adapters.md)。
アダプターを使用すると、Rekognition の API オペレーションの精度を高め、モデルの動作を自分のニーズやユースケースに合わせてカスタマイズできます。このチュートリアルでアダプターを作成すると、[DetectModerationLabels](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectModerationLabels.html) などのオペレーションで独自のイメージを分析するときにこれを使用できます。また、アダプターを再トレーニングして今後の改善に役立てることができます。
このチュートリアルでは以下の方法を学びます。
+ Rekognition コンソールを使用してプロジェクトを作成する。
+ トレーニングデータに注釈を付ける。
+ トレーニングデータセットに基づきアダプターをトレーニングする。
+ アダプターのパフォーマンスをレビューする。
+ アダプターをイメージ解析に使用する。
## 前提条件
このチュートリアルを始める前に、「[アダプターの作成と使用](creating-and-using-adapters.md)」を読むことをお勧めします。
アダプターを作成するときは、Rekognition コンソールのツールを使用すると、プロジェクトを作成し、イメージをアップロードして注釈を付け、それらのイメージに基づいてアダプターをトレーニングできます。開始するには、[プロジェクトの作成およびアダプターのトレーニング](#using-adapters-tutorial-annotation)を参照してください。
あるいは、Rekognition のコンソールまたは API を使用してイメージの予測を取得し、その予測を検証してから、それらの予測に基づいてアダプターを学習することもできます。開始するには、[アダプターの一括分析、予測検証、トレーニング](#using-adapters-tuorial-annotation-bulk-analysis)を参照してください。
## イメージの注釈
イメージには、Rekognition コンソールでイメージにラベルを付けることで注釈を付けることができます。また、Rekognition の一括分析を使用してイメージに注釈を付け、その後で正しくラベルが付いていることを確認することもできます。注釈を付けるには、次のいずれかのトピックを選択します。
**Topics**
+ [プロジェクトの作成およびアダプターのトレーニング](#using-adapters-tutorial-annotation)
+ [アダプターの一括分析、予測検証、トレーニング](#using-adapters-tuorial-annotation-bulk-analysis)
### プロジェクトの作成およびアダプターのトレーニング
Rekognition コンソールを使用してイメージに注釈を付けて、アダプターをトレーニングするには、以下のステップを実行します。
**プロジェクトの作成**
アダプターをトレーニングまたは使用するときは、先に、アダプターを含めるプロジェクトを作成する必要があります。また、アダプターのトレーニングに使用するイメージも提供する必要があります。プロジェクト、アダプター、イメージデータセットを作成するには
1. AWS マネジメントコンソールにサインインし、https://console.aws.amazon.com/rekognition/ で Rekognition コンソールを開きます。
1. 左側のペインで、**[カスタムモデレーション]** を選択します。Rekognition カスタムモデレーションのランディングページが開きます。
![\[Rekognition のカスタムモデレーションインターフェイス。ファインチューニングされた既存のアダプターはなく、新しいプロジェクトの作成または検索オプションがある。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/adapters-1-landing-page.png)
1. カスタムモデレーションのランディングページにはすべてのプロジェクトとアダプターのリストが表示されています。また、アダプターを作成するボタンもあります。**[プロジェクトを作成]** を選択し、新規プロジェクトとアダプターを作成します。
1. アダプターを作成するのが初めてである場合は、画面上で、プロジェクトとアダプターに関連するファイルを保存する、Amazon S3 バケットを作成するように指示されます。**[Amazon S3 バケットを作成]** を選択します。
1. 次のページで、**アダプター名**と**プロジェクト名**を入力します。必要に応じてアダプターの説明も入力します。
![\[プロジェクト名、アダプター名、オプションのアダプターの説明など、プロジェクトの詳細を入力するためのフォーム。マニフェストファイルまたは S3 バケットからトレーニング画像データセットをインポートするためのオプション。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/adapters-2-project-details.png)
1. このステップでは、アダプターのイメージも提供します。**[コンピュータからイメージをインポート]**、**[マニフェストファイルをインポート]**、**[Amazon S3 バケットからイメージをインポート]** のいずれかを選択できます。Amazon S3 バケットからイメージをインポートする場合は、トレーニングイメージを含むバケットとフォルダへのパスを指定します。コンピュータからイメージを直接アップロードする場合は、一度にアップロードできるイメージの数が最大 30 であることにご注意ください。注釈を含むマニフェストファイルを使用する場合は、以下で説明するイメージ注釈の手順は飛ばして、「[アダプターのパフォーマンスのレビュー](#using-adapters-tutorial-performance)」セクションに進みます。
1. **[テストデータセットの詳細]** セクションで、**[自動分割]** を選択して Rekognition に適切な割合のイメージをテストデータとして自動選択させるか、**[マニフェストファイルを手動でインポート]** を選択します。
1. この情報を入力したら、**[プロジェクトを作成]** を選択します。
**アダプターのトレーニング**
注釈の付いていないイメージでアダプターをトレーニングするには
1. アダプターを含むプロジェクトを選択し、**[イメージにラベルを割り当てる]** オプションを選択します。
1. **[イメージにラベルを割り当てる]** ページには、トレーニングイメージとしてアップロードされたイメージがすべて表示されています。これらのイメージは、左側にある 2 つの属性選択パネルを使って、ラベル付き/ラベルなしのステータス、およびラベルカテゴリ別に、フィルタリングできます。トレーニングデータセットにイメージを追加するときは、**[画像を追加]** を選択します。
![\[画像ラベル付けインターフェイス。手順、アダプターの詳細、空の画像パネルが表示されている。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/adapters-4-assign-labels-to-images.png)
1. トレーニングデータセットにイメージを追加したら、必ず、ラベルを使ってイメージに注釈を付けます。イメージをアップロードすると、[画像にラベルを割り当てる] ページが更新され、アップロードしたイメージが表示されます。画面上で、Rekognition のモデレーションでサポートされているラベルのドロップダウンリストからイメージに適したラベルを選択するように指示されます。ラベルは複数選べます。
1. トレーニングデータ内のすべてのイメージにラベルを付けるまで、この作業を続けます。
1. すべてのデータにラベルを付けたら、**[トレーニングを開始]** を選択してモデルのトレーニングを開始し、アダプターを作成します。
![\[2 つの画像が表示されたインターフェイス。明示的なヌード、挑発的な内容、暴力、ヘイトシンボル、アルコール、薬物、タバコなどのカテゴリにラベルを割り当てるためのオプションがある。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/adapters-5-labels-images-blurred.png)
1. トレーニングプロセスを開始する前に、必要に応じてアダプターに**タグ**を追加できます。アダプターにカスタム暗号化キーを提供するか、KMS AWS キーを使用することもできます。必要なタグを追加し、暗号化をカスタマイズしたら、**[アダプターをトレーニング]** をクリックしてアダプターのトレーニングプロセスを開始します。
1. アダプターのトレーニングが完了するまで待機します。トレーニングが完了すると、アダプターの作成が完了したことの通知が届きます。
アダプターのステータスが [トレーニング完了] に変わったら、アダプターのメトリクスをレビューできます。
### アダプターの一括分析、予測検証、トレーニング
Rekognition のコンテンツモデレーションモデルによる一括分析予測を検証して次の手順を実行し、アダプターをトレーニングします。
Rekognition のコンテンツモデレーションモデルによる予測を検証してアダプターをトレーニングするには、以下を行う必要があります。
1. イメージの一括分析を実行します。
1. イメージについて返された予測を検証します。
イメージの予測は、Rekognition のベースモデル、または作成済みのアダプターを使用して一括分析を実行することで取得できます。
**イメージの一括分析を実行**
検証した予測に基づいてアダプターをトレーニングするには、最初に、一括分析ジョブを実行して、Rekognition のベースモデルまたは任意のアダプターを使用してイメージのバッチを分析する必要があります。一括分析ジョブを実行するには
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/rekognition/](https://console.aws.amazon.com/rekognition/) で Amazon Rekognition コンソールを開きます。
1. 左側のペインで **[一括分析]** を選択します。[一括分析] のランディングページが表示されます。**[一括分析を開始]** を選択します。一括分析機能の概要に、画像のアップロード、分析の待機、結果の確認の手順が表示されており、オプションでモデル予測を検証する手順も示されています。基本モデルを使用したコンテンツモデレーションの最近の一括分析ジョブが一覧表示されます。
![\[一括分析機能の概要。基本モデルを使用したコンテンツモデレーションのワークフローが示され、最近の一括分析ジョブが一覧表示されている。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/BA-1-create-bulk-analysis.png)
1. アダプターを作成するのが初めてである場合は、画面上で、プロジェクトとアダプターに関連するファイルを保存する、Amazon Simple Storage Service バケットを作成するように指示されます。**[Amazon S3 バケットを作成]** を選択します。
1. **[アダプターを選択する]** ドロップダウンメニューから、一括分析に使用するアダプターを選択します。アダプターを選択しない場合は、デフォルトでベースモデルが使用されます。このチュートリアルでは、アダプターを選択しません。
![\[一括分析機能のインターフェイス。Rekognition の機能やアダプターの選択、ジョブ名の設定、ラベルの最小信頼度しきい値の指定を行うためのドロップダウンメニューが表示されている。一部のフィールドは必須となっている。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/BA-2-bulk-analysis-job.png)
1. **[一括分析ジョブ名]** フィールドに、一括分析ジョブの名前を入力します。
1. **[最小信頼度しきい値]** の値を選択します。選択した信頼度しきい値を下回るラベル予測は返されません。選択した最小信頼度しきい値を下回る信頼度しきい値は、後ほどモデルのパフォーマンスを評価するときに、調整できませんのでご注意ください。
1. このステップでは、一括分析で分析するイメージも提供します。これらのイメージはアダプターのトレーニングにも使用できます。**[コンピュータからイメージをアップロード]** または **[Amazon S3 バケットからイメージをインポート]** のいずれかを選択できます。Amazon S3 バケットからドキュメントをインポートする場合は、トレーニングイメージを含むバケットとフォルダへのパスを指定します。コンピュータからドキュメントを直接アップロードする場合は、一度にアップロードできるイメージの数が最大 50 であることにご注意ください。
1. この情報を入力したら、**[分析を開始する]** を選択します。Rekognition のベースモデルを使用した解析プロセスが開始します。
1. 一括分析ジョブのステータスは、一括分析のメインページにある、ジョブの一括分析ステータスから確認できます。一括分析のステータスが「成功」に変わったら、分析の結果をレビューできます。
![\[一括分析のジョブ一覧。「Evaluation 01」という名前のジョブが表示され、そのステータスが「成功」となっている。Content moderation Recognition API と基本モデルが使用されているのがわかる。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/BA-3-bulk-analysis-status.png)
1. **[一括分析ジョブ]** のリストの中から、作成した分析を選択します。
1. 一括分析の詳細ページでは、アップロードしたイメージに対して Rekognition のベースモデルが行った予測を確認できます。
1. ベースモデルのパフォーマンスをレビューします。イメージにラベルを割り当てるときにアダプターに必要になる信頼度しきい値は、信頼度しきい値のスライダーを使って変更できます。信頼度しきい値を変更すると、フラグ付きのインスタンスとフラグなしのインスタンスの数が変わります。[ラベルカテゴリ] のパネルには、Rekognition が認識する最上位のカテゴリが表示されます。このリストでカテゴリを選択すると、そのラベルが割り当てられているすべてのイメージを表示できます。
![\[一括分析の棒グラフ。さまざまなラベルでフラグ付けされた画像の数が示されている。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/BA-4-bulk-analysis-complete.png)
**予測の検証**
Rekognition のベースモデルまたは選択したアダプターの精度をレビューしてその精度を高めるには、検証ワークフローを使用します。
1. ベースモデルのパフォーマンスのレビューを終えたら、予測を検証する必要があります。予測を修正することで、アダプターをトレーニングできます。[一括分析] ページの上部にある **[予測を検証]** をクリックします。
![\[偽陽性率と偽陰性率を計算するための予測の検証、または精度を向上させるためのカスタムモデレーションアダプターのトレーニングを求めるパネル。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/BA-6-start-verification.png)
1. [予測を検証] ページには、Rekognition のベースモデルまたは選択したアダプターに提供したすべてのイメージが、各イメージの予測ラベルと共に表示されます。イメージの下にあるボタンを使って、それぞれの予測が正しいか間違っているかを検証します。予測が間違っている場合は [X] を、正しい場合はチェックマークをクリックします。アダプターをトレーニングするには、1 つのラベルで 20 件以上の偽陽性予測と 50 件の偽陰性予測を検証する必要があります。検証する予測の数が多ければ多いほど、アダプターのパフォーマンスは向上します。
![\[アルコール飲料を手にする人を描写する 3 つの画像。画像ラベルに対する「Alcohol」カテゴリ予測を説明するために使用されている。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/BA-7-verify-predictions-1.png)
予測を検証すると、イメージの下のテキストが変わり、検証した予測の種類が表示されます。イメージを検証できたら、**[画像にラベルを割り当てる]** メニューを使ってイメージにラベルを追加することもできます。選択した信頼度しきい値で、モデルによりフラグの付いた/付いてないイメージを確認したり、カテゴリ別にイメージをフィルタリングしたりできます。
![\[アルコールに対するコンテンツのモデレーションの 3 つの例が示されている画像。ラベルを適用するためのメニューが表示されている。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/BA-8-verify-predictions-2.png)
1. 検証の必要な予測をすべて検証すると、[検証] ページの **[ラベルごとのパフォーマンス]** のセクションに、検証した予測に関する統計が表示されます。これらの統計は、[一括分析の詳細] ページに戻って確認することもできます。
![\[コンテンツモデレーションの検証ページ。「Explicit Nudity」、「Suggestive」、「Alcohol」のラベルの偽陽性率が示され、信頼度しきい値が 50% と表示されている。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/BA-8.5-predictions-stats.png)
1. **[ラベルごとのパフォーマンス]** に関する統計に問題がなければ、**[予測を検証]** ページに戻って、**[アダプターをトレーニング]** をクリックし、アダプターのトレーニングを開始します。
![\[ジョブの詳細を示す [予測を検証] ページ。ジョブの名前、作成日、モデルバージョン、入力と出力の場所が表示されている。[アダプターをトレーニング] ボタンがある。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/BA-9-train-adapter.png)
1. [アダプターをトレーニング] ページでは、プロジェクトを作成するか、既存のプロジェクトを選択するように指示されます。プロジェクトと、そのプロジェクトに含まれるアダプターの名前を入力します。テストイメージのソースも指定する必要があります。イメージを指定するときは、[自動分割] を選択して Rekognition でトレーニングデータの一部をテストイメージとして自動的に使用するか、マニフェストファイルを手動で指定できます。推奨の方法は、[自動分割] を使用することです。
![\[新しいアダプタープロジェクトを作成するためのインターフェイス。プロジェクト名、アダプター名、アダプターの説明を入力するフィールドがある。さらに、テストデータソースを指定するフィールド、データを自動分割するかマニフェストファイルをインポートするかのオプションがある。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/BA-10-train-adapter-project.png)
1. 必要なタグと、デフォルト AWS KMS キーを使用しない場合は AWS キーを指定します。**[自動更新]** は有効のままにしておくことが推奨されます。
1. **[アダプターをトレーニング]** をクリックします。
![\[アダプターの構成設定。タグの追加、データ暗号化、信頼度しきい値、自動更新のオプションがある。アダプターはこのインターフェイスからトレーニングできる。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/BA-11-train-adapter.png)
1. カスタムモデレーションのランディングページでアダプターのステータスが [トレーニングの完了] に変わったら、アダプターのパフォーマンスをレビューできます。詳細については「[アダプターのパフォーマンスのレビュー](#using-adapters-tutorial-performance)」を参照してください。
## アダプターのパフォーマンスのレビュー
アダプターのパフォーマンスをレビューするには
1. コンソールを使用すると、カスタムモデレーションのランディングページにある [プロジェクト] タブで、プロジェクトに関連付けられているアダプターのステータスを確認できます。カスタムモデレーションのランディングページに移動します。
![\[カスタムモデレーションのランディングページ。モデレーションプロジェクトのリストが表示され、詳細情報として、ステータス、アダプター ID、入力データの場所、基本モデルバージョン、作成日、ステータスメッセージなどが示されている。プロジェクトを作成、削除、再開できるボタンがある。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/adapters-7-status-alt.png)
1. レビューするアダプターをこのリストの中から選びます。次の [アダプターの詳細] ページには、アダプターのさまざまなメトリクスが表示されます。
![\[アダプターのパフォーマンスメトリクス。「Suggestive」や「Alcohol」などのさまざまなラベルカテゴリについて、偽陽性が 25% 向上、偽陰性が 24% 減少が示されている。Ground Truth 真陽性、基本モデル、アダプター偽陰性に関するデータも表示されている。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/adapters-8.5-new-performance-review.png)
1. **[しきい値]** パネルでは、イメージにラベルを割り当てるときにアダプターに必要になる最小信頼度しきい値を変更できます。信頼度しきい値を変更すると、フラグ付きのインスタンスとフラグなしのインスタンスの数が変わります。選択したカテゴリのメトリクスは、ラベルカテゴリでフィルタリングして確認することもできます。選択したしきい値を設定します。
1. [アダプターのパフォーマンス] のパネルでメトリクスを調べることにより、テストデータに基づきアダプターのパフォーマンスを評価できます。これらのメトリクスは、アダプターの抽出を、テストセットの「グラウンドトゥルース」の注釈と比較することにより、算出されます。
[アダプターのパフォーマンス] パネルには、作成したアダプターの偽陽性の改善と偽陰性の改善が表示されます。[ラベルごとのパフォーマンス] タブでは、各ラベルカテゴリのアダプターと、ベースモデルのパフォーマンスを比較できます。ベースモデルとアダプターの両方による偽陽性予測および偽陰性予測の数が、ラベルカテゴリ別に階層化されて表示されます。これらのメトリクスをレビューすることで、改善が必要な場所を特定できます。これらのメトリクスの詳細については、「[アダプターの評価と改善](using-adapters-evaluating-improving.md)」を参照してください。
パフォーマンスを改善するには、より多くのトレーニングイメージを収集し、プロジェクト内で新しいアダプターを作成します。カスタムモデレーションのランディングページに戻りプロジェクトに新しいアダプターを作成するだけで、アダプターのトレーニング対象となるトレーニングイメージがさらに増えます。今度は、**[新規プロジェクトを作成]** ではなく **[既存のプロジェクトオプションに追加]** を選択し、**[プロジェクト名]** ドロップダウンメニューから、新しいアダプターの作成先となるプロジェクトを選択します。前回と同じように、イメージに注釈を付けるか、注釈付きのマニフェストファイルを提供します。
![\[新しいコンテンツモデレーションアダプターの作成または既存のプロジェクトへの追加のためのインターフェイス。アダプターとプロジェクトに名前を付けるためのオプションがある。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/adapters-9-create-new-adapter.png)
## アダプターの使用
アダプターを作成したら、そのアダプターを [DetectModerationLabels](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectModerationLabels.html) などのサポートされている Rekognition オペレーションに提供できます。アダプターで推論を実行するために使用できるコードサンプルを表示するには、「アダプターを使用する」タブを選択します。ここでは、CLI AWS と Python の両方のコードサンプルを確認できます。また、アダプターを作成したオペレーションに関する、ドキュメントの各セクションを参照し、その他のコードサンプル、セットアップ手順、サンプル JSON を確認することもできます。
![\[テストデータ、トレーニングデータ、出力データの場所が示されたインターフェイス。対応する S3 URL フィールドが表示されている。アダプターを使用するためのオプション、トレーニング画像とタグを表示するためのオプションがある。トレーニング済みアダプターを使用するための ID のほか、AWS CLI コマンドと Python コードのサンプルなど、アダプターの詳細にアクセスするためのオプションもある。\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/images/adapters-12-use-adapter.png)
## アダプターとプロジェクトの削除
アダプターを個別に削除することも、プロジェクトを削除することもできます。プロジェクト自体を削除するときは、先に、それに関連付けられたアダプターを削除する必要があります。
1. プロジェクトに関連付けられたアダプターを削除するには、そのアダプターを選択し、**[削除]** をクリックします。
1. プロジェクトを削除するには、削除するプロジェクトを選択して **[削除]** をクリックします。