Des prédictions par lots

Vous pouvez utiliser une tâche de prévision par lots dans Amazon Fraud Detector pour obtenir des prévisions pour un ensemble d'événements qui ne nécessitent pas de notation en temps réel. Par exemple, vous pouvez créer une tâche de prévision par lots pour effectuer une tâche hors ligne proof-of-concept ou pour évaluer rétrospectivement le risque d'événements sur une base horaire, quotidienne ou hebdomadaire.

Vous pouvez créer une tâche de prédiction par lots à l'aide de la console Amazon Fraud Detector ou en appelant l'opération d'CreateBatchPredictionJobAPI à l'aide de l'interface de ligne de AWS commande (AWSCLI) ou de l'un des kits SDK Amazon Fraud Detector.

Comment fonctionnent les prédictions par lots

L'opération d'CreateBatchPredictionJobAPI utilise une version de détecteur spécifiée pour effectuer des prédictions sur la base des données fournies dans un fichier CSV d'entrée situé dans un compartiment Amazon S3. L'API renvoie ensuite le fichier ACL dans un compartiment S3.

Les tâches de prédiction Batch calculent les scores du modèle et les résultats des prévisions de la même manière que l'GetEventPredictionopération. De la même manièreGetEventPrediction, pour créer une tâche de prévision par lots, vous devez d'abord créer un type d'événement, éventuellement entraîner un modèle, puis créer une version de détecteur qui évalue les événements de votre travail par lots.

Le prix des scores de risque d'événement évalués par des tâches de prédiction par lots est le même que celui des scores créés par l'GetEventPredictionAPI. Pour en savoir plus, consultez la tarification d'Amazon Fraud Detector.

Vous ne pouvez exécuter qu'une seule tâche de prédiction par lots à la fois.

Fichiers d'entrée et de sortie

Le fichier CSV d'entrée doit contenir des en-têtes correspondant au type d'événement associé à la version du détecteur sélectionnée. Taille maximale du fichier de données en entrée est de 1 Go. Le nombre d'événements varie en fonction de la taille de votre événement.

Amazon Fraud Detector crée le fichier de sortie dans le même compartiment que le fichier d'entrée, sauf si vous spécifiez un emplacement distinct pour les données de sortie. Le fichier de sortie contient les données d'origine du fichier d'entrée et les colonnes ajoutées suivantes :

• MODEL_SCORES— Détaille les scores du modèle pour l'événement à partir de chaque modèle associé à la version de détecteur sélectionnée.

• OUTCOMES— Détaille les résultats de l'événement tels qu'évalués par la version du détecteur sélectionnée et ses règles.

• STATUS— Indique si l'événement a été évalué avec succès. Si l'événement n'a pas été évalué correctement, cette colonne affiche le code de raison de l'échec.

• RULE_RESULTS— Liste de toutes les règles correspondantes, en fonction du mode d'exécution des règles.

Obtenir des prévisions par lots

Les étapes suivantes supposent que vous avez déjà créé un type d'événement, entraîné un modèle à l'aide de ce type d'événement (facultatif) et créé une version de détecteur pour ce type d'événement.

Pour une prévision par lots

1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon Fraud Detector Detecket à l'adresse https://console.aws.amazon.com/frauddetector.

2. Dans le volet de navigation de gauche de la console Amazon Fraud Detector, choisissez Prédictions Batch, puis sélectionnez Nouvelle prédiction par lots.

3. Dans Nom de la Job, spécifiez le nom de votre tâche de prédiction par lots. Si vous ne spécifiez pas de nom, Amazon Fraud Detector génère un nom de tâche de manière aléatoire.

4. Dans Detector, choisissez le détecteur pour cette prédiction par lots.

5. Dans Version Detector, choisissez la version du détecteur pour cette prédiction par lots. Vous pouvez choisir une version du détecteur dans n'importe quel statut. Si l'Activeétat de votre détecteur est associé à une version de détecteur, cette version est automatiquement sélectionnée, mais vous pouvez également modifier cette sélection si nécessaire.

6. Dans le rôle IAM, choisissez ou créez un rôle disposant d'un accès en lecture et en écriture à vos compartiments Amazon S3 en entrée et en sortie. Pour en savoir plus, consultez Guide sur les rôles IAM.

   Pour obtenir des prévisions par lots, le rôle IAM qui appelle l'CreateBatchPredictionJobopération doit disposer d'autorisations de lecture sur votre compartiment S3 d'entrée et d'autorisations d'écriture sur votre compartiment S3 de sortie. Pour plus d'informations sur les autorisations relatives aux compartiments, consultez des exemples de politique utilisateur dans le Guide de l'utilisateur Amazon S3.

7. Dans Emplacement des données d'entrée, spécifiez l'emplacement Amazon S3 de vos données d'entrée. Si vous souhaitez que le fichier de sortie se trouve dans un autre compartiment S3, sélectionnez Emplacement de données séparé pour la sortie et indiquez l'emplacement Amazon S3 pour vos données de sortie.

8. (Facultatif) Créez des balises pour votre tâche de prédiction par lots.

9. Sélectionnez Démarrer.

   Amazon Fraud Detector crée la tâche de prédiction par lots, et le statut de la tâche estIn progress. Les délais de traitement des tâches de prédiction par Batch varient en fonction du nombre d'événements et de la configuration de la version de votre détecteur.

Pour arrêter une tâche de prédiction par lots en cours, accédez à la page détaillée de la tâche de prédiction par lots, choisissez Actions, puis choisissez Arrêter la prédiction par lots. Si vous arrêtez une tâche de prédiction par lots, vous ne recevrez aucun résultat pour cette tâche.

Lorsque le statut de la tâche de prédiction par lots passe àComplete, vous pouvez récupérer la sortie de la tâche à partir du compartiment de sortie Amazon S3 désigné. Le nom du fichier de sortie est au formatbatch prediction job name_file creation timestamp_output.csv. Par exemple, le fichier de sortie d'une tâche nommée mybatchjob estmybatchjob_ 1611170650_output.csv.

Pour rechercher des événements spécifiques évalués par une tâche de prédiction par lots, dans le volet de navigation de gauche de la console Amazon Fraud Detector, sélectionnez Rechercher les prédictions passées.

Pour supprimer une tâche de prédiction par lots terminée, accédez à la page détaillée de la tâche de prédiction par lots, choisissez Actions, puis choisissez Supprimer la prédiction par lots.

Guide sur les rôles IAM

Pour obtenir des prévisions par lots, le rôle IAM qui appelle l'CreateBatchPredictionJobopération doit disposer d'autorisations de lecture sur votre compartiment S3 d'entrée et d'autorisations d'écriture sur votre compartiment S3 de sortie. Pour plus d'informations sur les listes ACL dans le Guide de l'utilisateur Amazon S3. Sur la console Amazon Fraud Detector, vous disposez de trois options pour sélectionner un rôle IAM pour les prévisions Batch :

1. Créez un rôle lors de la création d'une nouvelle tâche de prédiction Batch.

2. Sélectionnez un rôle IAM existant que vous avez précédemment créé dans la console Amazon Fraud Detector. Assurez-vous d'ajouter l'S3:PutObjectautorisation au rôle avant de procéder à cette étape.

3. Entrez un ARN personnalisé pour un rôle IAM créé précédemment.

Si vous recevez une erreur liée à votre rôle IAM, effectuez les vérifications suivantes :

1. Vos compartiments d'entrée et de sortie Amazon S3 se trouvent dans la même région que votre détecteur.

2. Le rôle IAM que vous utilisez possède l's3:GetObjectautorisation pour votre compartiment S3 d'entrée et l's3:PutObjectautorisation pour votre compartiment S3 de sortie.

3. Le rôle IAM que vous utilisez est associé à une politique de confiance pour le principal frauddetector.amazonaws.com de service.

Obtenez des prévisions de fraude par lots à l'aide du AWS SDK for Python (Boto3)

L'exemple suivant montre un exemple de demande pour l'CreateBatchPredictionJobAPI. Une tâche de prédiction par lots doit inclure les ressources existantes suivantes : détecteur, version du détecteur et nom du type d'événement. L'exemple suivant suppose que vous avez créé un type d'événementsample_registration, un détecteur sample_detector et une version du détecteur1.

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-**'
)