Configura un motor

En esta página, se explican brevemente los conceptos detrás de la configuración de un motor.

Fuentes admitidas para los hiperparámetros

Cuando configuras un motor, puedes seleccionar la fuente de los hiperparámetros que se usan para crear un modelo. Se admiten las siguientes fuentes:

  • Ajuste automático: La IA contra el lavado de dinero ajusta los hiperparámetros cuando creas un recurso EngineConfig (comportamiento predeterminado)
  • Heredar: Hereda hiperparámetros de una configuración de motor anterior que se creó con una versión anterior del motor dentro de la misma versión de ajuste. Este parámetro de configuración te permite evitar tener que volver a ajustar cada vez que adoptas una nueva versión del motor de modelo.

Cuándo ajustar o heredar

En las siguientes secciones, se describe cuándo debes seleccionar el ajuste automático y cuándo debes heredar los hiperparámetros de una configuración de motor anterior.

Cuándo ajustar

Tienes la opción de ajustar cada nueva configuración del motor y, si tienes dudas, siempre debes realizar ajustes para obtener los mejores resultados de rendimiento. Consulta la sección Cómo ajustar un motor para obtener más información.

Para obtener el mejor rendimiento, debes considerar el ajuste del motor cuando ocurre alguna de las siguientes situaciones:

  • Realizarás cambios significativos en la lógica del conjunto de datos. Por ejemplo, cuando cambia cualquiera de los siguientes cambios:
    • La lógica por la que se propagan los campos
    • La selección de los campos RECOMMENDED que se propagan
    • La lógica o la selección de datos que se proporcionan en la tabla PartySupplementaryData
  • Estás a punto de que un motor entrene un modelo para una región nueva.

Cuándo heredar los hiperparámetros

Para ahorrar tiempo y costos cuando adoptas una nueva versión de motor, puedes heredar hiperparámetros de un motor anterior con la misma versión de ajuste. Consulta la sección Cómo adoptar una versión de motor sin volver a ajustar.

Las versiones del motor con la versión de ajuste v003 y las versiones del motor lanzadas antes del 22/02/2024 no admiten la herencia de hiperparámetros, pero se pueden usar como una fuente de hiperparámetros.

Cómo ajustar un motor

Para activar el ajuste, consulta Crea y administra configuraciones de motores.

En particular, debes seleccionar lo siguiente:

  • Los datos que se usarán para el ajuste del motor son los siguientes:

    Especifica un conjunto de datos y una hora de finalización dentro del período del conjunto de datos.

    El ajuste del motor usa etiquetas y funciones basadas en meses calendario completos hasta, sin incluir, el mes de la hora de finalización seleccionada. Para obtener más información, consulta Intervalos de tiempo del conjunto de datos.

  • La versión del motor que se usará para el ajuste del motor:

    Selecciona una versión de motor que coincida con la línea de negocio (venta minorista o comercial) para la que usarás los modelos asociados.

  • El volumen de investigaciones que esperas en función de los modelos:

    Especifica partyInvestigationsPerPeriodHint. Esto se usa en el ajuste, el entrenamiento y las pruebas retrospectivas del motor para garantizar que la IA contra el lavado de dinero entregue el rendimiento con el volumen de investigación mensual.

Resultado del ajuste del motor

El ajuste del motor genera un recurso EngineConfig, que se puede usar para crear un Recurso de modelo.

Los metadatos de configuración del motor contienen las siguientes métricas. En particular, estas métricas te muestran lo siguiente:

  • Mejora de rendimiento esperada por el ajuste del motor en comparación con el uso de los hiperparámetros predeterminados

  • Cualquier cambio grande en las familias de atributos que admita el conjunto de datos (entre el ajuste del motor, el entrenamiento, la evaluación y la predicción)

Nombre de la métrica Descripción de la métrica Ejemplo de valor de métrica
ExpectedRecallPreTuning Métrica de recuperación medida en un conjunto de prueba cuando se usan hiperparámetros predeterminados de la versión del motor.

Esta medición de recuperación supone la cantidad de investigaciones por mes que se especifica en partyInvestigationsPerPeriodHint. 

{
  "recallValues": [
    {
      "partyInvestigationsPerPeriod": 5000,
      "recallValue": 0.72,
      "scoreThreshold": 0.42,
    },
  ],
}
ExpectedRecallPostTuning Métrica de recuperación medida en un conjunto de prueba cuando se usan hiperparámetros ajustados.

Esta medición de recuperación supone la cantidad de investigaciones por mes que se especifica en partyInvestigationsPerPeriodHint. 

{
  "recallValues": [
    {
      "partyInvestigationsPerPeriod": 5000,
      "recallValue": 0.80,
      "scoreThreshold": 0.43,
    },
  ],
}
Falta

Porcentaje de los valores faltantes entre todos los atributos de cada familia de atributos.

Idealmente, todas las familias de atributos de IA contra el lavado de dinero deberían tener un valor de Falta cercano a 0. Pueden ocurrir excepciones cuando los datos subyacentes de esas familias de atributos no están disponibles para la integración.

Un cambio significativo en este valor para cualquier familia de atributos entre el ajuste, el entrenamiento, la evaluación y la predicción puede indicar incoherencia en los conjuntos de datos usados. 

{
  "featureFamilies": [
    {
      "featureFamily": "unusual_wire_credit_activity",
      "missingnessValue": 0.00,
    },
    ...
    ...
    {
      "featureFamily": "party_supplementary_data_id_3",
      "missingnessValue": 0.45,
    },
  ],
}

Cómo adoptar una versión de motor sin reajustar

Para volver a usar hiperparámetros de una configuración de motor anterior, consulta la sección Crea una configuración de motor que herede hiperparámetros (en la página Crea y administra configuraciones de motores). En particular, debes seleccionar lo siguiente:

  • Tipo de fuente de hiperparámetros: Selecciona INHERITED como hyperparameterSourceType. Si no especificas el tipo de fuente, el tipo de fuente del hiperparámetro se establece en TUNING para permitir la retrocompatibilidad.
  • Fuente del hiperparámetro: especifica el nombre completo del recurso de la configuración del motor de origen en el objeto hyperparameterSource. Los resultados de la configuración del motor de origen se usan para la nueva configuración del motor. La configuración del motor de origen debe haberse creado con una versión anterior del motor dentro de la misma versión del motor de ajuste que usas ahora.
  • Versión del motor que se usará en la configuración del motor: Selecciona una versión del motor que coincida con la línea de negocios (venta minorista o comercial) de los modelos que quieres usar. Esta línea de negocio debe coincidir con la línea de negocio en la configuración del motor que usas como fuente de hiperparámetros.

Resultado y linaje al heredar

Cuando se heredan los hiperparámetros de otra versión del motor, se crea un recurso EngineConfig que se puede usar para crear un recurso de modelo con los hiperparámetros de la configuración del motor de origen.

En el caso del linaje, los siguientes campos del recurso EngineConfig se configuran de la siguiente manera cuando se heredan hiperparámetros de otra configuración del motor:

  • hyperparameterSourceType: INHERITED
  • hyperparameterSource: Es la configuración del motor que se usa como fuente del hiperparámetro.
  • tuning: Es el objeto tuning original, que incluye la referencia al conjunto de datos que se usó para el ajuste original del motor (primaryDataset) y la hora más reciente a partir de la cual se usaron los datos a fin de generar atributos de entrenamiento (endTime).
  • performanceTarget: Es el objeto performanceTarget original, incluido el volumen de investigaciones esperado en función de los modelos especificados (partyInvestigationsPerPeriodHint).
  • Metadatos de la configuración del motor del ajuste original del motor