Amazon Fraud Detector ya no estará disponible para nuevos clientes a partir del 7 de noviembre de 2025. Para obtener capacidades similares a las de Amazon Fraud Detector SageMaker AutoGluon, explore Amazon y AWS WAF.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Almacene los datos de los eventos mediante la importación por lotes
Con la función de importación por lotes, puede cargar de forma rápida y sencilla grandes conjuntos de datos históricos de eventos en Amazon Fraud Detector mediante la consola, la API o el AWS SDK. Para utilizar la importación por lotes, cree un archivo de entrada en formato CSV que contenga todos los datos de sus eventos, cargue el archivo CSV en el bucket de Amazon S3 e inicie un trabajo de importación. Amazon Fraud Detector primero valida los datos en función del tipo de evento y, a continuación, importa automáticamente todo el conjunto de datos. Una vez importados los datos, están listos para usarse para entrenar nuevos modelos o para volver a entrenar modelos existentes.
Archivos de entrada y salida
El archivo CSV de entrada debe contener encabezados que coincidan con las variables definidas en el tipo de evento asociado, además de cuatro variables obligatorias. Para obtener más información, consulte Prepare los datos del evento para su almacenamiento. El tamaño máximo del archivo de datos de entrada es de 20 gigabytes (GB), es decir, unos 50 millones de eventos. La cantidad de eventos variará según el tamaño de tu evento. Si el trabajo de importación se realizó correctamente, el archivo de salida está vacío. Si la importación no se realizó correctamente, el archivo de salida contiene los registros de errores.
Crea un archivo CSV
Amazon Fraud Detector importa datos únicamente de archivos en formato de valores separados por comas (CSV). La primera fila del archivo CSV debe contener encabezados de columna que coincidan exactamente con las variables definidas en el tipo de evento asociado, además de cuatro variables obligatorias: EVENT_ID, EVENT_TIMESTAMP, ENTITY_ID y ENTITY_TYPE. Opcionalmente, también puedes incluir EVENT_LABEL y LABEL_TIMESTAMP (se requiere LABEL_TIMESTAMP si se incluye EVENT_LABEL).
Defina las variables obligatorias
Las variables obligatorias se consideran metadatos de eventos y deben especificarse en mayúsculas. Los metadatos de los eventos se incluyen automáticamente para el entrenamiento del modelo. En la siguiente tabla se enumeran las variables obligatorias, la descripción de cada variable y el formato requerido para la variable.
| Name | Description (Descripción) | Requisitos |
|---|---|---|
|
EVENT_ID |
Un identificador para el evento. Por ejemplo, si tu evento es una transacción en línea, el EVENT_ID puede ser el número de referencia de la transacción que se proporcionó a tu cliente. |
|
|
EVENT_TIMESTAMP |
La marca de tiempo en la que ocurrió el evento. La marca de tiempo debe estar en la norma ISO 8601 en UTC. |
|
|
ENTITY_ID |
Un identificador de la entidad que realiza el evento. |
|
|
ENTITY_TYPE |
La entidad que lleva a cabo el evento, como un comerciante o un cliente |
ENTITY_TYPE es obligatorio para los trabajos de importación por lotes |
|
EVENT_LABEL |
Clasifica el evento como o |
EVENT_LABEL es obligatorio si se incluye LABEL_TIMESTAMP |
|
LABEL_TIMESTAMP |
La marca de tiempo en la que se rellenó o actualizó por última vez la etiqueta del evento |
|
Cargue un archivo CSV a Amazon S3 para importarlo por lotes
Tras crear un archivo CSV con sus datos, cárguelo en su bucket de Amazon Simple Storage Service (Amazon S3).
Para subir datos de eventos a un bucket de Amazon S3
Inicie sesión en la consola de Amazon S3 Consola de administración de AWS y ábrala en https://console.aws.amazon.com/s3/
. -
Elija Create bucket (Crear bucket).
Se abrirá el asistente Crear bucket (Crear bucket).
-
En Nombre del depósito, introduzca un DNS-compliant nombre para el depósito.
El nombre del bucket debe:
-
Ser único en todo Amazon S3.
-
Tener entre 3 y 63 caracteres.
-
No contiene caracteres en mayúsculas.
-
Comenzar por una letra minúscula o un número.
Una vez que haya creado el bucket, no podrá modificar su nombre. Para obtener información sobre cómo asignar nombres a los cubos, consulte las reglas de nomenclatura de los cubos en la guía del usuario de Amazon Simple Storage Service.
importante
Evite incluir información confidencial, como números de cuenta, en el nombre del bucket. El nombre del bucket será visible en las URL que señalan a los objetos almacenados en él.
-
-
En Región, elija la AWS región en la que desea que resida el bucket. Debes seleccionar la misma región en la que utilizas Amazon Fraud Detector, es decir, EE.UU. Este (Norte de Virginia), EE.UU. Este (Ohio), EE.UU. Oeste (Oregón), Europa (Irlanda), Asia Pacífico (Singapur) o Asia Pacífico (Sídney).
-
En Configuración del bucket para Block Public Access, elija la configuración de Block Public Access que desee aplicar al bucket.
Le recomendamos que deje todos los ajustes activados. Para obtener más información sobre cómo bloquear el acceso público, consulte Bloquear el acceso público a su almacenamiento de Amazon S3 en la Guía del usuario de Amazon Simple Storage Service.
-
Elija Crear bucket.
Sube el archivo de datos de entrenamiento a tu bucket de Amazon S3. Anote la ruta de ubicación de Amazon S3 para su archivo de entrenamiento (por ejemplo, s3://bucketname/object.csv).
Importe por lotes los datos de los eventos en la consola de Amazon Fraud Detector
Puede importar fácilmente una gran cantidad de conjuntos de datos de eventos en la consola de Amazon Fraud Detector mediante la CreateBatchImportJob API o el SDK de AWS. Antes de continuar, asegúrese de haber seguido las instrucciones para preparar su conjunto de datos como un archivo CSV. Asegúrese de haber subido también el archivo CSV a un bucket de Amazon S3.
Uso de la consola de Amazon Fraud Detector
Para importar por lotes los datos de los eventos en la consola
-
Abra la consola de AWS, inicie sesión en su cuenta y navegue hasta Amazon Fraud Detector.
-
En el panel de navegación izquierdo, elija Events.
-
Elija el tipo de evento.
-
Selecciona la pestaña Eventos almacenados.
-
En el panel de detalles de los eventos almacenados, asegúrese de que la ingesta de eventos esté ACTIVADA.
-
En el panel Importar datos de eventos, seleccione Nueva importación.
-
En la página de importación de nuevos eventos, proporcione la siguiente información:
-
[Recomendado] Deje habilitada la validación inteligente de datos para este conjunto de datos; ahora, establezca la configuración predeterminada.
-
Para el rol de IAM para los datos, seleccione el rol de IAM que creó para el bucket de Amazon S3 que contiene el archivo CSV que planea importar.
-
Para la ubicación de los datos de entrada, introduzca la ubicación de S3 en la que tiene el archivo CSV.
-
Si desea especificar una ubicación independiente para almacenar los resultados de la importación, haga clic en el botón Separar la ubicación de datos para las entradas y los resultados e introduzca una ubicación válida para el bucket de Amazon S3.
importante
Asegúrese de que el rol de IAM que ha seleccionado tenga permisos de lectura para el bucket de Amazon S3 de entrada y permisos de escritura para el bucket de Amazon S3 de salida.
-
-
Elija Iniciar.
-
La columna Estado del panel de datos de eventos de importación muestra el estado de su trabajo de validación e importación. El encabezado de la parte superior proporciona una descripción detallada del estado, ya que el conjunto de datos pasa primero por la validación y, a continuación, por la importación.
-
Siga las instrucciones proporcionadas paraSupervise el progreso del trabajo de validación e importación de conjuntos de datos.
Supervise el progreso del trabajo de validación e importación de conjuntos de datos
Si utiliza la consola de Amazon Fraud Detector para realizar un trabajo de importación por lotes, de forma predeterminada, Amazon Fraud Detector valida su conjunto de datos antes de la importación. Puede supervisar el progreso y el estado de los trabajos de validación e importación en la página de importación de nuevos eventos de la consola de Amazon Fraud Detector. En la parte superior de la página aparece un banner con una breve descripción de los resultados de la validación y del estado del trabajo de importación. En función de los resultados de la validación y del estado de tu trabajo de importación, es posible que tengas que tomar medidas para garantizar que la validación e importación del conjunto de datos se realicen correctamente.
La siguiente tabla proporciona detalles de las acciones que debes tomar en función del resultado de las operaciones de validación e importación.
| Mensaje de banner | Status | Qué significa | ¿Qué debo hacer |
|---|---|---|---|
| La validación de datos ha comenzado | La validación está en curso | SDV ha empezado a validar su conjunto de datos | Espere a que cambie el estado |
| La validación de los datos no puede continuar debido a errores en el conjunto de datos. Corrija los errores en su archivo de datos e inicie un nuevo trabajo de importación. Consulte el informe de validación para obtener más información | Fallo en la validación | El SDV identificó problemas en su archivo de datos. Estos problemas deben solucionarse para importar correctamente su conjunto de datos. | En el panel Importar datos de eventos, seleccione el identificador del trabajo y consulte el informe de validación. Siga las recomendaciones del informe para corregir todos los errores de la lista. Para obtener más información, consulte Uso del informe de validación. |
| Se ha iniciado la importación de datos. La validación se completó correctamente | Importación en curso | Su conjunto de datos pasó la validación. La AFD ha empezado a importar su conjunto de datos | Espere a que cambie el estado |
| La validación se completó con advertencias. Se ha iniciado la importación de datos | Importación en curso | Algunos de los datos de su conjunto de datos no se validaron. Sin embargo, los datos que han pasado la validación cumplen con los requisitos mínimos de tamaño de datos para la importación. | Supervise el mensaje del banner y espere a que cambie el estado |
| Sus datos se importaron parcialmente. Algunos de los datos no se validaron y no se importaron. Consulte el informe de validación para obtener más información. | Importado. El estado muestra un icono de advertencia. | Algunos de los datos del archivo de datos que no se validaron no se importaron. Se importó el resto de los datos que pasaron la validación. | En el panel Importar datos de eventos, seleccione el identificador del trabajo y consulte el informe de validación. Siga las recomendaciones de la tabla de advertencias a nivel de datos para abordar las advertencias enumeradas. No es necesario abordar todas las advertencias. Sin embargo, asegúrate de que tu conjunto de datos contenga más del 50% de datos que hayan pasado la validación para que la importación se realice correctamente. Una vez que hayas abordado las advertencias, inicia un nuevo trabajo de importación. Para obtener más información, consulte Uso del informe de validación. |
| La importación de datos falló debido a un error de procesamiento. Inicie un nuevo trabajo de importación de datos | Error al importar | La importación falló debido a un error transitorio en tiempo de ejecución | Inicie un nuevo trabajo de importación |
| Los datos se importaron correctamente | Importado | Tanto la validación como la importación se completaron correctamente | Seleccione el identificador de trabajo de su trabajo de importación para ver los detalles y, a continuación, continúe con la formación del modelo |
nota
Recomendamos esperar 10 minutos después de que el conjunto de datos se haya importado correctamente a Amazon Fraud Detector para garantizar que el sistema los haya incorporado por completo.
Informe de validación de datos inteligentes
La validación inteligente de datos crea un informe de validación una vez finalizada la validación. El informe de validación proporciona detalles de todos los problemas que el SDV ha identificado en su conjunto de datos, con sugerencias de acciones para solucionar los problemas más impactantes. Puedes usar el informe de validación para determinar cuáles son los problemas, dónde se encuentran en el conjunto de datos, su gravedad y cómo solucionarlos. El informe de validación se crea incluso cuando la validación se completa correctamente. En este caso, puede ver el informe para ver si hay algún problema en la lista y, si lo hay, decidir si quiere solucionar alguno de ellos.
nota
La versión actual de SDV escanea tu conjunto de datos en busca de problemas que puedan provocar un error en la importación por lotes. Si la validación y la importación por lotes se realizan correctamente, es posible que tu conjunto de datos siga teniendo problemas que podrían provocar un error en el entrenamiento del modelo. Te recomendamos que consultes tu informe de validación aunque la validación y la importación se hayan realizado correctamente, y que resuelvas cualquier problema que aparezca en el informe para que la capacitación del modelo se lleve a cabo correctamente. Una vez resueltos los problemas, cree un nuevo trabajo de importación por lotes.
Acceder al informe de validación
Puede acceder al informe de validación en cualquier momento una vez finalizada la validación mediante una de las siguientes opciones:
-
Una vez finalizada la validación y mientras el trabajo de importación esté en curso, en el encabezado superior, selecciona Ver informe de validación.
-
Una vez finalizado el trabajo de importación, en el panel de datos de eventos de importación, elija el ID de trabajo del trabajo de importación que acaba de completarse.
Uso del informe de validación
La página del informe de validación de tu trabajo de importación proporciona los detalles de este trabajo de importación, una lista de errores críticos, si se encuentran, una lista de advertencias sobre eventos específicos (filas) en tu conjunto de datos, si los encuentras, y un breve resumen del conjunto de datos que incluye información como los valores que no son válidos y los valores que faltan para cada variable.
-
Importar detalles del trabajo
Proporciona detalles del trabajo de importación. Si el trabajo de importación ha fallado o el conjunto de datos se ha importado parcialmente, seleccione Ir al archivo de resultados para ver los registros de errores de los eventos que no se pudieron importar.
-
Errores críticos
Proporciona detalles de los problemas más impactantes de su conjunto de datos identificados por SDV. Todos los problemas que aparecen en este panel son críticos y debes solucionarlos antes de continuar con la importación. Si intenta importar el conjunto de datos sin abordar los problemas críticos, es posible que el trabajo de importación falle.
Para abordar los problemas críticos, sigue las recomendaciones que se proporcionan para cada advertencia. Cuando haya solucionado todos los problemas enumerados en el panel de errores críticos, cree un nuevo trabajo de importación por lotes.
-
Advertencias a nivel de datos
Proporciona un resumen de las advertencias de eventos específicos (filas) de su conjunto de datos. Si el panel de advertencias a nivel de datos está lleno, algunos de los eventos del conjunto de datos no se validaron y no se importaron.
Para cada advertencia, la columna Descripción muestra el número de eventos relacionados con el problema. Además, los identificadores de eventos de ejemplo proporcionan una lista parcial de ejemplos de identificadores de eventos que puedes usar como punto de partida para localizar el resto de los eventos que tienen el problema. Usa la recomendación proporcionada en la advertencia para solucionar el problema. Utilice también los registros de errores del archivo de salida para obtener información adicional sobre el problema. Los registros de errores se generan para todos los eventos en los que no se pudo importar por lotes. Para acceder a los registros de errores, en el panel de detalles del trabajo de importación, seleccione Ir al archivo de resultados.
nota
Si más del 50% de los eventos (filas) de su conjunto de datos no se validaron, el trabajo de importación también fallará. En este caso, debes corregir los datos antes de iniciar un nuevo trabajo de importación.
-
Resumen del conjunto de datos
Proporciona un resumen del informe de validación de su conjunto de datos. Si la columna Número de advertencias muestra más de 0 advertencias, decide si necesitas corregir esas advertencias. Si la columna Número de advertencias muestra ceros, continúa entrenando tu modelo.
Importe datos de eventos por lotes con el AWS SDK para Python (Boto3)
El siguiente ejemplo muestra un ejemplo de solicitud de API. CreateBatchImportJob Un trabajo de importación por lotes debe incluir un jobID, un inputPath, un outputPath, un evento y un iam. TypeName RoleArn El jobID no puede contener el mismo ID de un trabajo anterior, a menos que el trabajo exista en estado CREATE_FAILED. Las rutas InputPath y OutputPath deben ser rutas S3 válidas. Puede optar por no especificar el nombre del archivo en OutputPath; sin embargo, tendrá que proporcionar una ubicación válida para el bucket de S3. El evento TypeName y el iam deben existir. RoleArn El rol de IAM debe conceder permisos de lectura para el bucket de Amazon S3 de entrada y permisos de escritura para el bucket de Amazon S3 de salida.
import boto3 fraudDetector = boto3.client('frauddetector') fraudDetector.create_batch_import_job ( jobId = 'sample_batch_import', inputPath = 's3://bucket_name/input_file_name.csv', outputPath = 's3://bucket_name/', eventTypeName = 'sample_registration', iamRoleArn: 'arn:aws:iam::************:role/service-role/AmazonFraudDetector-DataAccessRole-*************' )
Cancela el trabajo de importación por lotes
Puede cancelar un trabajo de importación por lotes en curso en cualquier momento en la consola de Amazon Fraud Detector, mediante la CancelBatchImportJob API o el AWS SDK.
Para cancelar un trabajo de importación por lotes en la consola,
-
Abra la consola de AWS, inicie sesión en su cuenta y navegue hasta Amazon Fraud Detector.
-
En el panel de navegación izquierdo, elija Events.
-
Elija el tipo de evento.
-
Selecciona la pestaña Eventos almacenados.
-
En el panel Importar datos de eventos, elige el identificador de un trabajo de importación en curso que quieras cancelar.
-
En la página del trabajo del evento, haga clic en Acciones y seleccione Cancelar la importación de eventos.
-
Seleccione Detener la importación de eventos para cancelar el trabajo de importación por lotes.
Cancelar un trabajo de importación por lotes con el AWS SDK para Python (Boto3)
El siguiente ejemplo muestra un ejemplo de solicitud para la API. CancelBatchImportJob El trabajo de cancelación de importación debe incluir el identificador de un trabajo de importación por lotes en curso.
import boto3 fraudDetector = boto3.client('frauddetector') fraudDetector.cancel_batch_import_job ( jobId = 'sample_batch' )