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

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

# ディテクターの作成
<a name="create-a-detector"></a>

ディテクターを作成するには、既に定義したイベントタイプを指定します。オプションで、Amazon Fraud Detector によってトレーニングおよびデプロイ済みのモデルを追加できます。モデルを追加する場合は、ルールの作成時に Amazon Fraud Detector によって生成されたモデルスコアをルール式で使用できます (例: `$model score < 90`)。

 Amazon Fraud Detector コンソール、[PutDetector](https://docs.aws.amazon.com//frauddetector/latest/api/API_PutDetector.html) API、[put-detector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/frauddetector/put-detector.html) コマンド、または AWS SDK を使用してディテクターを作成できます。API、コマンド、または SDK を使用してディテクターを作成している場合は、ディテクターを作成した後、「」の手順に従います[ディテクターバージョンの作成](create-a-detector-version.md)。

## Amazon Fraud Detector コンソールでディテクターを作成する
<a name="create-detector-console"></a>

この例では、イベントタイプを作成し、不正予測に使用するモデルバージョンを作成してデプロイしていることを前提としています。

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

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

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

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

1. **イベントタイプ** で、不正予測用に作成したイベントタイプを選択します。

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

### ステップ 2: デプロイされたモデルバージョンを追加する
<a name="add-deployed-model-console"></a>

1. これはオプションのステップであることに注意してください。ディテクターにモデルを追加する必要はありません。このステップをスキップするには、**[Next]** (次へ) を選択します。

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

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

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

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

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

ルールは、不正予測の評価時に変数値を解釈する方法を Amazon Fraud Detector に指示する条件です。この例では、モデルスコアを変数値として使用して 、`medium_fraud_risk`、 の `high_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-console"></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-console"></a>

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

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

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

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

## を使用してディテクターを作成する AWS SDK for Python (Boto3)
<a name="create-a-detector-using-the-aws-python-sdk"></a>

次の例は、`PutDetector` API のサンプルリクエストです。ディテクターは、ディテクターバージョンのコンテナとして機能します。`PutDetector` API は、ディテクターが評価するイベントタイプを指定します。次の例では、イベントタイプ `sample_registration` を作成したと想定しています。

```
import boto3
fraudDetector = boto3.client('frauddetector')

fraudDetector.put_detector (
detectorId = 'sample_detector',
eventTypeName = 'sample_registration'
)
```