Configurer un moteur

Cette page présente brièvement les concepts de base de la configuration d'un moteur.

Sources compatibles pour les hyperparamètres

Lorsque vous configurez un moteur, vous pouvez sélectionner la source des hyperparamètres utilisés pour créer un modèle. Les sources suivantes sont acceptées:

  • Réglage automatique: l'IA AML règle les hyperparamètres lorsque vous créez une ressource EngineConfig (comportement par défaut).
  • Hériter: hériter des hyperparamètres d'une configuration de moteur précédente créée avec une version antérieure du moteur dans la même version de réglage. Ce paramètre vous permet d'éviter de réajuster chaque fois que vous adoptez une nouvelle version du moteur de modèle.

Quand effectuer un réglage ou un héritage

Les sections suivantes indiquent quand sélectionner le réglage automatique et quand hériter des hyperparamètres d'une configuration de moteur précédente.

Quand effectuer un réglage ?

Vous pouvez ajuster chaque nouvelle configuration de moteur. En cas de doute, vous devez toujours optimiser pour obtenir les meilleures performances possibles. Pour en savoir plus, consultez la section Comment régler un moteur.

Pour des performances optimales, vous devez envisager d'optimiser le moteur dans les cas suivants:

  • Vous apportez des modifications importantes à la logique de l'ensemble de données. Par exemple, lorsque l'un des éléments suivants change :
    • Logique de remplissage des champs
    • Sélection des champs RECOMMANDÉS renseignés
    • Logique ou sélection des données fournies dans la table PartySupplementaryData
  • Vous allez demander à un moteur d'entraîner un modèle pour une nouvelle région.

Quand hériter des hyperparamètres

Pour gagner du temps et réduire les coûts lors de l'adoption d'une nouvelle version de moteur, vous pouvez hériter des hyperparamètres d'un moteur précédent utilisant la même version de réglage. Consultez la section Adopter une version de moteur sans réajuster.

Les versions de moteur avec la version de réglage v003 et les versions de moteur publiées avant le 22 février 2024 ne sont pas compatibles avec l'héritage des hyperparamètres, mais ces versions peuvent être utilisées comme source d'hyperparamètres.

Régler un moteur

Pour déclencher l'optimisation, consultez Créer et gérer des configurations de moteur.

Vous devez notamment sélectionner les éléments suivants:

  • Données à utiliser pour le réglage du moteur:

    Spécifiez un ensemble de données et une heure de fin comprise dans la période de l'ensemble de données.

    L'ajustement du moteur utilise des libellés et des fonctionnalités basés sur des mois calendaires complets jusqu'au mois de la date de fin sélectionnée, mais sans l'inclure. Pour en savoir plus, consultez la section Périodes temporelles des ensembles de données.

  • Version du moteur à utiliser pour le réglage du moteur:

    Sélectionnez une version de moteur correspondant au secteur d'activité (commerce ou commerce) pour lequel vous utiliserez les modèles associés.

  • Le volume d'investigations que vous prévoyez en fonction des modèles:

    Spécifiez partyInvestigationsPerPeriodHint. Cela permet d'ajuster le moteur, d'entraîner et de tester en arrière-plan l'IA de lutte contre le blanchiment d'argent afin de s'assurer qu'elle offre des performances adaptées à votre volume d'investigations mensuel.

Sortie du réglage du moteur

Le réglage du moteur génère une ressource EngineConfig, qui peut être utilisée pour créer une ressource de modèle.

Les métadonnées de configuration du moteur contiennent les métriques suivantes. Plus précisément, ces métriques vous indiquent les éléments suivants:

  • Gain de performances attendu grâce au réglage du moteur par rapport à l'utilisation des hyperparamètres par défaut

  • Mesures pouvant être utilisées pour évaluer la cohérence de l'ensemble de données (par exemple, en comparant les valeurs de manque des familles d'éléments géographiques de différentes opérations)

Nom de la métrique Description de la métrique Exemple de valeur de métrique
ExpectedRecallPreTuning Métrique de rappel mesurée sur un ensemble de test lorsque vous utilisez les hyperparamètres par défaut de la version du moteur.

Cette mesure de rappel suppose que le nombre d'enquêtes par mois est spécifié dans partyInvestigationsPerPeriodHint. 

{
  "recallValues": [
    {
      "partyInvestigationsPerPeriod": 5000,
      "recallValue": 0.72,
      "scoreThreshold": 0.42,
    },
  ],
}
ExpectedRecallPostTuning Métrique de rappel mesurée sur un ensemble de test lorsque vous utilisez des hyperparamètres ajustés.

Cette mesure de rappel suppose le nombre d'enquêtes par mois spécifié dans partyInvestigationsPerPeriodHint. 

{
  "recallValues": [
    {
      "partyInvestigationsPerPeriod": 5000,
      "recallValue": 0.80,
      "scoreThreshold": 0.43,
    },
  ],
}
Données manquantes

Pourcentage de valeurs manquantes pour toutes les entités de chaque famille d'entités.

Dans l'idéal, toutes les familles de fonctionnalités d'IA AML doivent avoir un taux de données manquantes proche de 0. Des exceptions peuvent se produire lorsque les données sous-jacentes à ces familles d'éléments ne sont pas disponibles pour l'intégration.

Un changement significatif de cette valeur pour une famille de fonctionnalités entre le réglage, l'entraînement, l'évaluation et la prédiction peut indiquer une incohérence dans les ensembles de données utilisés. 

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

Adopter une version de moteur sans réajuster

Pour réutiliser les hyperparamètres d'une configuration de moteur précédente, consultez la section Créer une configuration de moteur qui hérite des hyperparamètres (sur la page Créer et gérer des configurations de moteur). Vous devez notamment sélectionner les éléments suivants:

  • Type de source d'hyperparamètre:sélectionnez INHERITED comme hyperparameterSourceType. Si vous ne spécifiez pas le type de source, le type de source de l'hyperparamètre est défini sur TUNING pour permettre la rétrocompatibilité.
  • Source d'hyperparamètre:spécifiez le nom de ressource complet de la configuration du moteur source dans l'objet hyperparameterSource. Les sorties de la configuration du moteur source sont utilisées pour la nouvelle configuration du moteur. La configuration du moteur source doit avoir été créée avec une version antérieure du moteur dans la même version du moteur de réglage que celle que vous utilisez actuellement.
  • Version du moteur à utiliser pour la configuration du moteur:sélectionnez une version de moteur correspondant au secteur d'activité (commerce ou commerce) des modèles que vous souhaitez utiliser. Si vous héritez d'hyperparamètres, le secteur d'activité doit correspondre à celui utilisé pour la source d'hyperparamètres.

Sortie et lignée lors de l'héritage

L'héritage des hyperparamètres d'une autre version de moteur crée une ressource EngineConfig qui peut être utilisée pour créer une ressource Model à l'aide des hyperparamètres de la configuration du moteur source.

Pour la lignée, les champs suivants de la ressource EngineConfig sont définis comme suit lors de l'héritage des hyperparamètres d'une autre configuration de moteur:

  • hyperparameterSourceType : INHERITED
  • hyperparameterSource: configuration du moteur utilisée comme source d'hyperparamètres
  • tuning: objet tuning d'origine, y compris la référence à l'ensemble de données utilisé pour le réglage du moteur d'origine (primaryDataset) et la dernière date à partir de laquelle les données ont été utilisées pour générer des fonctionnalités d'entraînement (endTime)
  • performanceTarget: objet performanceTarget d'origine, y compris le volume d'investigations attendu en fonction des modèles spécifiés (partyInvestigationsPerPeriodHint)
  • Métadonnées de configuration du moteur issues du réglage d'origine du moteur