Amazon Fraud Detector は、2025 年 11 月 7 日をもって新規顧客に公開されなくなりました。Amazon Fraud Detector と同様の機能については、Amazon SageMaker、AutoGluon、および を参照してください AWS WAF。

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

# チュートリアル: Amazon Fraud Detector コンソールの使用を開始する
<a name="get-started-console"></a>

このチュートリアルは 2 つの部分で構成されています。最初のパートでは、不正検出モデルを構築、トレーニング、デプロイする方法について説明します。2 番目のパートでは、モデルを使用してリアルタイムで不正予測を生成する方法について説明します。モデルは、S3 バケットにアップロードしたサンプルデータファイルを使用してトレーニングされます。このチュートリアルの最後に、次のアクションを実行します。
+ Amazon Fraud Detector モデルの構築とトレーニング
+ リアルタイムの不正予測を生成する

**重要**  
続行する前に、「」の指示に従っていることを確認してください。 [サンプルデータセットを取得してアップロードする](step-1-get-s3-data.md)

# パート A: Amazon Fraud Detector モデルの構築、トレーニング、デプロイ
<a name="part-a"></a>

パート A では、ビジネスユースケースの定義、イベントの定義、モデルの構築、モデルのトレーニング、モデルのパフォーマンスの評価、モデルのデプロイを行います。

## ステップ 1: ビジネスユースケースを選択する
<a name="choose-business-use-case"></a>
+ このステップでは、**データモデルエクスプローラー**を使用して、ビジネスユースケースを Amazon Fraud Detector でサポートされている不正検出モデルタイプと一致させます。データモデルエクスプローラーは、Amazon Fraud Detector コンソールと統合されたツールで、ビジネスユースケースの不正検出モデルの作成とトレーニングに使用するモデルタイプを推奨します。データモデルエクスプローラーは、データセットに含める必要がある必須、推奨、およびオプションのデータ要素に関するインサイトも提供します。データセットは、不正検出モデルの作成とトレーニングに使用されます。

  このチュートリアルでは、ビジネスユースケースは新しいアカウント登録です。ビジネスユースケースを指定すると、データモデルエクスプローラーは不正検出モデルを作成するためのモデルタイプを推奨し、データセットの作成に必要なデータ要素のリストも提供します。新しいアカウント登録のデータを含むサンプルデータセットを既にアップロードしているため、新しいデータセットを作成する必要はありません。

  1. [AWS マネジメントコンソール](https://console.aws.amazon.com/)を開き、アカウントにサインインします。Amazon Fraud Detector に移動します。

  1. 左側のナビゲーションペインで、**データモデルエクスプローラー**を選択します。

  1. **「データモデルエクスプローラー**」ページの**「ビジネスユースケース**」で、**「新規アカウントの不正**」を選択します。

  1. Amazon Fraud Detector は、選択したビジネスユースケースの不正検出モデルを作成するために使用する推奨モデルタイプを表示します。モデルタイプは、Amazon Fraud Detector が不正検出モデルのトレーニングに使用するアルゴリズム、エンリッチメント、変換を定義します。

     推奨されるモデルタイプを書き留めます。これは、後でモデルを作成するときに必要になります。

  1. **データモデルインサイト**ペインは、不正検出モデルの作成とトレーニングに必要な必須データ要素と推奨データ要素に関するインサイトを提供します。

     ダウンロードしたサンプルデータセットを確認し、必須データ要素と推奨データ要素がすべてテーブルにリストされていることを確認します。

     後で特定のビジネスユースケースのモデルを作成するときに、提供されたインサイトを使用してデータセットを作成します。

## ステップ 2: イベントタイプを作成する
<a name="define-event"></a>
+ このステップでは、不正を評価するビジネスアクティビティ (イベント) を定義します。イベントを定義するには、データセット内の変数、イベントを開始するエンティティ、イベントを分類するラベルを設定します。このチュートリアルでは、アカウント登録イベントを定義します。

  1. [AWS マネジメントコンソール](https://console.aws.amazon.com/)を開き、アカウントにサインインします。Amazon Fraud Detector に移動します。

  1. 左側のナビゲーションペインで [**イベント**] を選択します。

  1. **イベントタイプ**ページで、**作成**を選択します。

  1. **イベントタイプの詳細**で、イベントタイプ名`sample_registration`として を入力し、オプションでイベントの説明を入力します。

  1. Entity で****、**Create entity** を選択します。

  1. **エンティティの作成**ページで、エンティティタイプ名`sample_customer`として を入力します。必要に応じて、エンティティタイプの説明を入力します。

  1. [**エンティティの作成**] を選択します。

  1. **「イベント変数****」の「このイベントの変数を定義する方法を選択する**」で、**「トレーニングデータセットから変数を選択する**」を選択します。

  1. **IAM ロール** で、**IAM ロールの作成** を選択します。

  1. **「IAM ロールの作成**」ページで、サンプルデータをアップロードした S3 バケットの名前を入力し、**「ロールの作成**」を選択します。

  1. **データの場所**で、サンプルデータへのパスを入力します。これは、サンプルデータをアップロードした後に保存した`S3 URI`パスです。パスは に似ています`S3://your-bucket-name/example dataset filename.csv`。

  1. **アップロード** を選択します。

     Amazon Fraud Detector は、サンプルデータファイルからヘッダーを抽出し、変数タイプにマッピングします。マッピングはコンソールに表示されます。

  1. **ラベル - オプション****で、ラベル** で新しい**ラベルを作成する** を選択します。

  1. **ラベルの作成**ページで、名前`fraud`として を入力します。このラベルは、サンプルデータセットの不正なアカウント登録を表す値に対応します。

  1. [**ラベルの作成**] を選択します。

  1. 2 番目のラベルを作成し、名前`legit`として を入力します。このラベルは、サンプルデータセットの正当なアカウント登録を表す値に対応します。

  1. [**イベントタイプの作成**] を選択します。

## ステップ 3: モデルを作成する
<a name="step-3-create-new-ml-model"></a>

1. **「モデル**」ページで**「モデルの追加**」を選択し、**「モデルの作成**」を選択します。

1. **ステップ 1 – モデルの詳細を定義する**には、モデル名`sample_fraud_detection_model`として を入力します。必要に応じて、モデルの説明を追加します。

1. [**モデルタイプ**] では、**オンライン不正インサイト**モデルを選択します。

1. **イベントタイプ**で sample**\$1registration** を選択します。これは、ステップ 1 で作成したイベントタイプです。

1. **履歴イベントデータ**では、

   1. **イベントデータソース**で、**S3 に保存されているイベントデータ**を選択します。

   1. **IAM ロール**の場合は、ステップ 1 で作成したロールを選択します。

   1. **トレーニングデータの場所**で、サンプルデータファイルへの S3 URI パスを入力します。

1. [**次へ**] を選択します。

## ステップ 4: モデルをトレーニングする
<a name="step-4-training-data-assign-perms"></a>

1. [**モデル入力**] で、すべてのチェックボックスをオンのままにします。デフォルトでは、Amazon Fraud Detector は履歴イベントデータセットのすべての変数をモデル入力として使用します。

1. **ラベル分類**では、**不正ラベル**はサンプルデータセット内の**不正**イベントを表す値に対応するため、不正ラベルでは不正を選択します。**正当なラベル**の場合、このラベルはサンプルデータセット内の正当なイベントを表す値に対応するため、**正当**を選択します。

1. **ラベルなしイベント処理**の場合、このサンプルデータセットの**ラベルなしイベントを無視**するのデフォルト選択のままにします。

1. [**次へ**] を選択します。

1. 確認後、[**モデルの作成とトレーニング**] を選択します。Amazon Fraud Detector はモデルを作成し、モデルの新しいバージョンのトレーニングを開始します。

   **モデルバージョン**では、**「ステータス**」列にモデルトレーニングのステータスが表示されます。サンプルデータセットを使用するモデルトレーニングの完了には約 45 分かかります。モデルトレーニングが完了すると、ステータスは**デプロイ準備完了**に変わります。

# ステップ 5: モデルのパフォーマンスを確認する
<a name="step-6-review-trained-model-performance"></a>

Amazon Fraud Detector を使用する上で重要なステップは、モデルスコアとパフォーマンスメトリクスを使用してモデルの精度を評価することです。モデルトレーニングが完了すると、Amazon Fraud Detector はモデルのトレーニングに使用されなかったデータの 15% を使用してモデルのパフォーマンスを検証し、モデルのパフォーマンススコアやその他のパフォーマンスメトリクスを生成します。

1. モデルのパフォーマンスを表示するには、

   1. Amazon Fraud Detector コンソールの左のナビゲーションペインで、[**モデル**] を選択します。

   1. **モデル**ページで、トレーニングしたモデル (**sample\$1fraud\$1detection\$1model**) を選択し、**1.0** を選択します。これは、モデルで作成された Amazon Fraud Detector のバージョンです。

1. Amazon Fraud Detector がこのモデルに対して生成した**モデルパフォーマンス**の全体的なスコアとその他すべてのメトリクスを確認します。

   このページのモデルパフォーマンススコアとパフォーマンスメトリクスの詳細については、[モデルスコア](model-scores.md)「」および「」を参照してください[モデルパフォーマンスメトリクス](training-performance-metrics.md)。

   トレーニング済みのすべての Amazon Fraud Detector モデルには、このチュートリアルでモデルに表示されるパフォーマンスメトリクスと同様の実際の不正検出パフォーマンスメトリクスがあることが期待できます。

# ステップ 6: モデルをデプロイする
<a name="get-started-deploy-model"></a>

トレーニング済みモデルのパフォーマンスメトリクスを確認し、不正予測を生成する準備ができたら、モデルをデプロイできます。

1. Amazon Fraud Detector コンソールの左側のナビゲーションペインで、**モデル**を選択します。

1. **モデル**ページで sample**\$1fraud\$1detection\$1model** を選択し、デプロイする特定のモデルバージョンを選択します。このチュートリアルでは、**1.0** を選択します。

1. [**モデルバージョン**] ページで、[**アクション**] を選択してから、**モデルバージョンのデプロイ**] をクリックします。

1. **モデルバージョン**では、 **ステータス**にデプロイのステータスが表示されます。デプロイが完了すると、ステータスは**アクティブ**に変わります。これは、モデルバージョンがアクティブ化され、不正予測を生成できることを示します。「」に進み[パート B: 不正予測を生成する](part-b.md)、不正予測を生成するステップを完了します。

# パート B: 不正予測を生成する
<a name="part-b"></a>

不正予測は、ビジネスアクティビティ (イベント) の不正の評価です。Amazon Fraud Detector は、ディテクターを使用して不正予測を生成します。ディテクターには、不正について評価する特定のイベントのモデルやルールなどの検出ロジックが含まれています。検出ロジックはルールを使用して、モデルに関連付けられたデータの解釈方法を Amazon Fraud Detector に指示します。このチュートリアルでは、前にアップロードしたアカウント登録サンプルデータセットを使用して、アカウント登録イベントを評価します。

パート A では、モデルの作成、トレーニング、およびデプロイを行いました。パート B では、`sample_registration`イベントタイプのディテクターを構築し、デプロイされたモデルを追加し、ルールとルール実行順序を作成し、不正予測の生成に使用するディテクターのバージョンを作成してアクティブ化します。

## ステップ 1: ディテクターを構築する
<a name="step-1-create-app"></a>

**ディテクターを作成するには**

1. Amazon Fraud Detector コンソールの左のナビゲーションペインで、[**ディテクター**] をクリックします。

1. [**ディテクターの作成**] を選択します。

1. **ディテクターの詳細の定義**ページで、ディテクター名`sample_detector`に と入力します。必要に応じて、 などのディテクターの説明を入力します`my sample fraud detector`。

1. **イベントタイプ**で sample**\$1registration** を選択します。これは、このチュートリアルのパート A で作成したイベントです。

1. [**次へ**] を選択します。

## ステップ 2: モデルを追加する
<a name="add-model-detector"></a>

このチュートリアルのパート A を完了した場合、ディテクターに追加できる Amazon Fraud Detector モデルが既にある可能性があります。モデルをまだ作成していない場合は、パート A に移動し、モデルを作成、トレーニング、デプロイするステップを完了してから、パート B に進みます。

1. **モデルの追加 - オプション**で、**モデルの追加**を選択します。

1. **モデルの追加**ページの**モデルの選択**で、前にデプロイした Amazon Fraud Detector モデル名を選択します。**バージョンを選択** で、デプロイされたモデルのモデルバージョンを選択します。

1. [**モデルの追加**] を選択します。

1. [**次へ**] を選択します。

## ステップ 3: ルールを追加する
<a name="add-rules-to-detector"></a>

ルールは、不正予測を評価するときにモデルパフォーマンススコアを解釈する方法を Amazon Fraud Detector に指示する条件です。このチュートリアルでは、、`high_fraud_risk`、 `medium_fraud_risk`の 3 つのルールを作成します`low_fraud_risk`。

1. 「ルール**の追加**」ページの**「ルールの定義**」で、ルール名`high_fraud_risk`に**「説明 - オプション**」で、ルールの説明**This rule captures events with a high ML model score**として「」と入力します。

1. [**式**] で、Amazon Fraud Detector 簡易ルール式言語を使用して、次のルール式を入力します。

   `$sample_fraud_detection_model_insightscore > 900`

1. [**結果**] では、[**新しい結果の作成**] を選択します。結果は、不正予測の結果であり、評価中にルールが一致した場合に返されます。

1. [**新しい結果の作成**] には、結果名として「`verify_customer`」と入力します。必要に応じて説明に説明を入力します。

1. [**結果の保存**] を選択します。

1. [**ルールの追加**] を選択して、ルール検証チェッカーを実行し、ルールを保存します。作成後、Amazon Fraud Detector はルールをディテクターで使用できるようにします。

1. [**別のルールの追加**] を選択してから、[**ルールの作成**] タブをクリックします。

1. このプロセスをさらに 2 回繰り返して、次のルールの詳細を使用して `medium_fraud_risk` と `low_fraud_risk` ルールを作成します。
   + medium\$1fraud\$1risk

     ルール名: `medium_fraud_risk`

     結果: `review`

     式:

     `$sample_fraud_detection_model_insightscore <= 900 and`

     `$sample_fraud_detection_model_insightscore > 700`
   + low\$1fraud\$1risk

     ルール名: `low_fraud_risk`

     結果: `approve`

     式:

     `$sample_fraud_detection_model_insightscore <= 700`

   これらの値は、このチュートリアルで使用される例です。独自のディテクターのルールを作成するときは、モデルとユースケースに適した値を使用します。

1. すべてのルールを追加したら、[**次へ**] を選択します。

   ルールの作成と記述の詳細については、「[Rules](rules.md)」および「[ルール言語リファレンス](rule-language-reference.md)」を参照してください。

## ステップ 4: ルールの実行とルールの順序を設定する
<a name="get-start-define-rule-order"></a>

ディテクターに含まれるルールのルール実行モードによって、定義したすべてのルールが評価されるか、最初に一致したルールでルール評価が停止されるかが決まります。また、ルールの順序によって、ルールを実行する順序が決まります。

デフォルトのルール実行モードは `FIRST_MATCHED` です。

**最初の一致**  
最初の一致のルール実行モードは、定義されたルールの順序に基づいて、最初の一致ルールの結果を返します。`FIRST_MATCHED` を指定した場合、Amazon Fraud Detector はルールを順番に評価し、最初に一致したルールで停止します。Amazon Fraud Detector は、その 1 つのルールの結果を示します。  
ルールを実行する順序は、結果として生じる不正予測の結果に影響を与える可能性があります。ルールを作成したら、以下の手順に従って、ルールの順序を変更して必要な順序で実行します。  
`high_fraud_risk` ルールがまだルールリストの上部にない場合は、**「順序**」を選択し、**「1**」を選択します。これにより、`high_fraud_risk` が一番上に移動します。  
このプロセスを繰り返して、`medium_fraud_risk` ルールが 2 番目の位置に来て、`low_fraud_risk` ルールが 3 番目の位置に来るようにします。

**すべての一致**  
すべての一致ルール実行モードは、ルールの順序に関係なく、一致したすべてのルールの結果を返します。`ALL_MATCHED` を指定した場合、Amazon Fraud Detector はすべてのルールを評価し、一致したすべてのルールの結果を返します。

このチュートリアル`FIRST_MATCHED`で を選択し、次**へ** を選択します。

# ステップ 5: ディテクターバージョンを確認して作成する
<a name="get-start-review-and-create-detector-version"></a>

ディテクターバージョンは、不正予測の生成に使用される特定のモデルとルールを定義します。

1. **確認と作成**ページで、設定したディテクターの詳細、モデル、ルールを確認します。何らかの変更を加える必要がある場合は、対応するセクションの隣にある [**編集**] をクリックします。

1. [**ディテクターの作成**] を選択します。ディテクターの作成後、ディテクターの最初のバージョンが `Draft` ステータスで Detector バージョンテーブルに表示されます。

   **ドラフト**バージョンを使用して Detector をテストします。

# ステップ 6: ディテクターバージョンをテストしてアクティブ化する
<a name="step-6-eval-event-get-outcome"></a>

Amazon Fraud Detector コンソールでは、テスト**の実行機能を備えたモックデータを使用してディテクターのロジックをテスト**できます。このチュートリアルでは、サンプルデータセットのアカウント登録データを使用できます。

1. [**ディテクターバージョンの詳細**] ページの下部にある [**テストの実行**] までスクロールします。

1. **イベントメタデータ**には、イベントが発生した時刻のタイムスタンプを入力し、イベントを実行するエンティティの一意の識別子を入力します。このチュートリアルでは、タイムスタンプの日付ピッカーから日付を選択し、エンティティ ID に「1234」と入力します。

1. **イベント変数**に、テストする変数値を入力します。このチュートリアルでは、 フィールド`ip_address`と `email_address`フィールドのみが必要です。これは、Amazon Fraud Detector モデルのトレーニングに使用される入力であるためです。次のサンプル値を使用できます。これは、推奨される変数名を使用したことを前提としています。
   + ip\$1address: `205.251.233.178`
   + email\$1address: `johndoe@exampledomain.com`

1. [**テストの実行**] を選択します。

1. Amazon Fraud Detector は、ルール実行モードに基づいて不正予測の結果を返します。ルール実行モードが の場合`FIRST_MATCHED`、返される結果は一致した最初のルールに対応します。最初のルールは、優先度が最も高いルールです。true と評価された場合、一致します。ルール実行モードが の場合`ALL_MATCHED`、返される結果は一致したすべてのルールに対応します。つまり、それらはすべて true と評価されます。Amazon Fraud Detector は、ディテクターに追加されたモデルのモデルスコアも返します。

   入力を変更し、いくつかのテストを実行して、さまざまな結果を確認できます。テストにはサンプルデータセットの *ip\$1address* と *email\$1address* の値を使用し、結果が期待どおりであるかどうかを確認できます。

1. ディテクターの動作に満足したら、 から `Draft`に昇格します`Active`。これにより、ディテクターをリアルタイムの不正検出で使用できるようになります。

   [**ディテクターバージョンの詳細**] ページで、[**アクション**]、[**発行**]、[**バージョンの発行**] の順に選択します。これにより、ディテクターのステータスが**ドラフト**から**アクティブに変更されます。**

   この時点で、モデルと関連するディテクターロジックは、Amazon Fraud Detector `GetEventPrediction` API を使用してオンラインアクティビティをリアルタイムで評価できます。CSV 入力ファイルと `CreateBatchPredictionJob` API を使用して、オフラインでイベントを評価することもできます。不正予測の詳細については、「」を参照してください。 [不正予測](getting-fraud-predictions.md)

このチュートリアルを完了すると、次のことが実行されました。
+ Amazon S3 にイベントデータセットの例をアップロードしました。
+ サンプルデータセットを使用して Amazon Fraud Detector 不正検出モデルを作成し、トレーニングしました。
+ Amazon Fraud Detector が生成したモデルパフォーマンススコアおよびその他のパフォーマンスメトリクスを表示しました。
+ 不正検出モデルをデプロイしました。
+ ディテクターを作成し、デプロイされたモデルを追加しました。
+ ディテクターにルール、ルール実行順序、および結果を追加しました。
+ 異なる入力を提供し、ルールとルール実行順序が期待どおりに機能するかどうかをチェックして、ディテクターをテストしました。
+ ディテクターを発行してアクティブ化しました。