自 2025 年 11 月 7 日起，Amazon Fraud Detector 不再向新客戶開放。對於類似 Amazon Fraud Detector 的功能，請探索 Amazon SageMaker、AutoGluon 和 AWS WAF。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 批次預測
<a name="batch-predictions"></a>

您可以使用 Amazon Fraud Detector 中的*批次預測*任務，取得一組不需要即時評分的事件預測。例如，您可以建立批次預測任務來執行離線proof-of-concept，或回溯性評估每小時、每日或每週的事件風險。

您可以使用 [Amazon Fraud Detector 主控台](https://console.aws.amazon.com/frauddetector)建立批次預測任務，或使用 AWS 命令列界面 (AWS CLI) 或其中一個 Amazon Fraud Detector SDKs 呼叫 [CreateBatchPredictionJob](https://docs.aws.amazon.com/frauddetector/latest/api/API_CreateBatchPredictionJob.html) API 操作。

**Topics**
+ [批次預測的運作方式](#how-batch-predictions-works)
+ [輸入和輸出檔案](#input-and-output-files)
+ [取得批次預測](#getting-batch-predictions)
+ [IAM 角色指引](#guidance-iam-roles)
+ [使用 取得批次詐騙預測 適用於 Python (Boto3) 的 AWS SDK](#get-a-batch-fraud-prediction-using-the-aws-python-sdk)

## 批次預測的運作方式
<a name="how-batch-predictions-works"></a>

`CreateBatchPredictionJob` API 操作使用指定的偵測器版本，根據位於 Amazon S3 儲存貯體的輸入 CSV 檔案中提供的資料進行預測。API 接著會將產生的 CSV 檔案傳回至 S3 儲存貯體。

批次預測任務會以與 `GetEventPrediction`操作相同的方式計算模型分數和預測結果。與 類似`GetEventPrediction`，若要建立批次預測任務，您必須先建立事件類型、選擇性地訓練模型，然後建立偵測器版本來評估批次任務中的事件。

批次預測任務評估的事件風險分數定價與 `GetEventPrediction` API 建立的分數定價相同。如需詳細資訊，請參閱 [Amazon Fraud Detector 定價](https://aws.amazon.com/fraud-detector/pricing/)。

您一次只能執行一個批次預測任務。

## 輸入和輸出檔案
<a name="input-and-output-files"></a>

 輸入 CSV 檔案應包含符合與所選偵測器版本相關聯之事件類型的標頭。輸入資料檔案的大小上限為 1GB。事件數量會根據您的事件大小而有所不同。

Amazon Fraud Detector 會在與輸入檔案相同的儲存貯體中建立輸出檔案，除非您為輸出資料指定不同的位置。輸出檔案包含來自輸入檔案的原始資料和下列附加資料欄：
+ `MODEL_SCORES` — 詳細說明與所選偵測器版本相關聯之每個模型的事件模型分數。
+ `OUTCOMES` — 詳細說明所選偵測器版本及其規則評估的事件結果。
+ `STATUS` — 指出事件是否已成功評估。如果事件未成功評估，此欄會顯示失敗的原因代碼。
+ ` RULE_RESULTS` — 根據規則執行模式比對的所有規則清單。

## 取得批次預測
<a name="getting-batch-predictions"></a>

下列步驟假設您已建立事件類型、使用該事件類型訓練模型 （選用），以及為該事件類型建立偵測器版本。

**取得批次預測**

1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/frauddetector](https://console.aws.amazon.com/frauddetector) 的 Amazon Fraud Detector 主控台。

1. 在 Amazon Fraud Detector 主控台的左側導覽窗格中，選擇**批次預測**，然後選擇**新批次預測**。

1. 在**任務名稱**中，指定批次預測任務的名稱。如果您未指定名稱，Amazon Fraud Detector 會隨機產生任務名稱。

1. 在**偵測器**中，選擇此批次預測的偵測器。

1. 在**偵測器版本**中，選擇此批次預測的偵測器版本。您可以選擇任何狀態的偵測器版本。如果您的偵測器具有處於 `Active` 狀態的偵測器版本，則會自動選取該版本，但您也可以視需要變更此選項。

1. 在 **IAM 角色**中，選擇或建立具有輸入和輸出 Amazon S3 儲存貯體讀取和寫入存取權的角色。如需詳細資訊，請參閱[IAM 角色指引](#guidance-iam-roles)。

   若要取得批次預測，呼叫 `CreateBatchPredictionJob`操作的 IAM 角色必須具有輸入 S3 儲存貯體的讀取許可，並將許可寫入輸出 S3 儲存貯體。如需儲存貯體許可的詳細資訊，請參閱《*Amazon S3 使用者指南*》中的[使用者政策範例](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-policies-s3.html)。

1. 在**輸入資料位置**中，指定輸入資料的 Amazon S3 位置。如果您希望輸出檔案位於不同的 S3 儲存貯體中，請選取**分開資料位置進行輸出**，並提供輸出資料的 Amazon S3 位置。

1. （選用） 為您的批次預測任務建立標籤。

1. 選擇 **開始使用**。

   Amazon Fraud Detector 會建立批次預測任務，且任務的狀態為 `In progress`。批次預測任務處理時間會根據事件數量和偵測器版本組態而有所不同。

若要停止進行中的批次預測任務，請前往批次預測任務詳細資訊頁面，選擇**動作**，然後選擇**停止批次預測**。如果您停止批次預測任務，您將不會收到任務的任何結果。

當批次預測任務的狀態變更為 時`Complete`，您可以從指定的輸出 Amazon S3 儲存貯體擷取任務的輸出。輸出檔案名稱的格式為 `batch prediction job name_file creation timestamp_output.csv`。例如，來自名為 之任務的輸出檔案`mybatchjob`為 `mybatchjob_ 1611170650_output.csv`。

若要搜尋批次預測任務評估的特定事件，請在 Amazon Fraud Detector 主控台的左側導覽窗格中，選擇**搜尋過去的預測**。

若要刪除已完成的批次預測任務，請前往批次預測任務詳細資訊頁面，選擇**動作**，然後選擇**刪除批次預測**。

## IAM 角色指引
<a name="guidance-iam-roles"></a>

若要取得批次預測，呼叫 [CreateBatchPredictionJob](https://docs.aws.amazon.com/frauddetector/latest/api/API_CreateBatchPredictionJob.html) 操作的 IAM 角色必須具有輸入 S3 儲存貯體的讀取許可，並將許可寫入輸出 S3 儲存貯體。如需儲存貯體許可的詳細資訊，請參閱《Amazon S3 使用者指南》中的使用者政策範例。在 Amazon Fraud Detector 主控台上，您有三個選項可選取批次預測的 IAM 角色：

1. 在建立新的批次預測任務時建立角色。

1. 選取您先前在 Amazon Fraud Detector 主控台中建立的現有 IAM 角色。在執行此步驟之前，請務必將 `S3:PutObject` 許可新增至角色。

1. 為先前建立的 IAM 角色輸入自訂 ARN。

如果您收到與 IAM 角色相關的錯誤，請確認下列事項：

1. 您的 Amazon S3 輸入和輸出儲存貯體與偵測器位於相同的區域。

1. 您使用的 IAM 角色具有輸入 S3 儲存貯體的 `s3:GetObject` 許可，以及輸出 S3 儲存貯體的 `s3:PutObject`許可。

1. 您使用的 IAM 角色具有服務主體 的信任政策`frauddetector.amazonaws.com`。

## 使用 取得批次詐騙預測 適用於 Python (Boto3) 的 AWS SDK
<a name="get-a-batch-fraud-prediction-using-the-aws-python-sdk"></a>

下列範例顯示 [CreateBatchPredictionJob](https://docs.aws.amazon.com/frauddetector/latest/api/API_CreateBatchPredictionJob.html) API 的範例請求。批次預測任務必須包含下列現有資源：偵測器、偵測器版本和事件類型名稱。下列範例假設您已建立事件類型 `sample_registration`、偵測器 `sample_detector`和偵測器版本 `1`。

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

fraudDetector.create_batch_prediction_job (
   jobId = 'sample_batch',
   inputPath = 's3://bucket_name/input_file_name.csv',
   outputPath = 's3://bucket_name/',
   eventTypeName = 'sample_registration',
   detectorName = 'sample_detector',
   detectorVersion = '1',
   iamRoleArn = 'arn:aws:iam::**:role/service-role/AmazonFraudDetector-DataAccessRole-**'
)
```