Configura un motor

En esta página, se describen 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. Esta configuración te permite evitar tener que volver a ajustar cada vez que adoptas una nueva versión del motor del 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 hiperparámetros de una configuración de motor anterior.

Cuándo sintonizar

Tienes la opción de ajustar cada configuración nueva del motor y, ante la duda, siempre debes ajustarla 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 ocurra alguna de las siguientes situaciones:

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

Cuándo heredar hiperparámetros

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

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

Cómo ajustar un motor

Para activar el ajuste, consulta Crea y administra la configuración del motor.

En particular, debes seleccionar las siguientes opciones:

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

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

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

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

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

  • El volumen de investigaciones que esperas se basa en los modelos:

    Especifica partyInvestigationsPerPeriodHint. Esto se usa en el ajuste, el entrenamiento y la prueba retroactiva del motor para garantizar que la IA contra el lavado de dinero proporcione rendimiento según tu volumen de investigación mensual.

Resultado del ajuste del motor

El ajuste de 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:

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

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

Nombre de la métrica Descripción de la métrica Ejemplo de valor de la 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 de

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

Lo ideal sería que todas las familias de atributos de IA contra el lavado de dinero tengan un valor de Falta de 0. Es posible que se produzcan excepciones cuando los datos subyacentes de esas familias de funciones 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 del motor sin tener que volver a ajustarla

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 la configuración de un motor). En particular, debes seleccionar lo siguiente:

  • Tipo de fuente del hiperparámetro: Selecciona INHERITED como hyperparameterSourceType. Si no especificas el tipo de fuente, el tipo de origen 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 configuración del motor nueva. 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 estás usando 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 negocio (venta minorista o comercial) de los modelos que deseas usar. Esta línea de negocio debe coincidir con la línea de negocio de la configuración del motor que usas como fuente de hiperparámetros.

Salida y linaje cuando se hereda

Cuando se heredan hiperparámetros de otra versión de un 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.

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

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