Configurer un moteur

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

Sources acceptées 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'AML basée sur l'IA règle les hyperparamètres lorsque vous créez une ressource EngineConfig (comportement par défaut)
  • Hériter: hérite des hyperparamètres d'une configuration de moteur précédente créée avec une version de moteur antérieure dans la même version de réglage. Ce paramètre vous permet d'éviter d'effectuer de nouveaux réglages chaque fois que vous adoptez une nouvelle version de moteur de modèle.

Quand régler ou hériter des paramètres

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

Quand régler

Vous avez la possibilité d'ajuster chaque nouvelle configuration de moteur et, en cas de doute, vous devez toujours optimiser les performances. Pour en savoir plus, consultez la section Régler un moteur.

Pour optimiser les performances, envisagez de régler le moteur dans les cas suivants:

  • Vous apportez des modifications importantes à la logique de l'ensemble de données. Par exemple, lorsque l'une des modifications suivantes :
    • Logique selon laquelle les champs sont remplis
    • Sélection des champs RECOMMANDÉS qui sont renseignés.
    • La logique ou la sélection des données fournies dans la table PartySupplementaryData.
  • Vous êtes sur le point d'entraîner un modèle à partir d'un moteur 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 Comment adopter une version de moteur sans avoir à effectuer de nouveaux réglages.

Les versions de moteur avec la version de réglage v003 et les versions de moteur publiées avant le 22/02/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 le réglage des déclencheurs, consultez la section 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 dans la plage de dates de l'ensemble de données.

    Le réglage du moteur utilise des étiquettes et des fonctionnalités basées sur des mois calendaires complets jusqu'au mois de l'heure de fin sélectionnée (non inclus). Pour en savoir plus, consultez la section Périodes d'utilisation des ensembles de données.

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

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

  • Le volume d'investigations que vous attendez en fonction des modèles:

    Spécifiez partyInvestigationsPerPeriodHint. Elle est utilisée par le réglage du moteur, l'entraînement et les tests rétrospectifs pour garantir que l'AML basée sur l'IA offre des performances adaptées à votre volume d'investigation mensuel.

Résultat 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. En particulier, ces métriques vous indiquent les éléments suivants:

  • Gain de performances attendu en réglant le moteur par rapport à l'utilisation des hyperparamètres par défaut

  • Toute modification importante des familles de caractéristiques prises en charge par l'ensemble de données (entre le réglage du moteur, l'entraînement, l'évaluation et la prédiction)

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 lors de l'utilisation des hyperparamètres par défaut de la version du moteur.

Cette mesure du rappel suppose le nombre d'investigations par mois 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 lors de l'utilisation d'hyperparamètres réglés.

Cette mesure du rappel suppose le nombre d'investigations par mois spécifié dans partyInvestigationsPerPeriodHint. 

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

Part des valeurs manquantes pour l'ensemble des caractéristiques de chaque famille de caractéristiques.

Idéalement, toutes les familles de fonctionnalités d'AML basée sur l'IA devraient présenter un taux de disparition proche de 0. Des exceptions peuvent se produire lorsque les données sous-jacentes de ces familles de caractéristiques ne peuvent pas être intégrées.

Une variation significative de cette valeur pour toute famille de caractéristiques 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 avoir à effectuer de nouveaux réglages

Pour réutiliser des 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 des hyperparamètres:sélectionnez INHERITED comme hyperparameterSourceType. Si vous ne spécifiez pas le type de source, le type de source d'hyperparamètres est défini sur TUNING pour permettre la rétrocompatibilité.
  • Source des hyperparamètres:spécifiez le nom complet de la ressource 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 du moteur correspondant au secteur d'activité (commerce ou commercial) des modèles que vous souhaitez utiliser. Ce secteur d'activité doit correspondre à celui indiqué dans la configuration du moteur que vous utilisez comme source d'hyperparamètres.

Résultat et traçabilité 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 de modèle à l'aide des hyperparamètres de la configuration du moteur source.

Pour la traçabilité, les champs suivants de la ressource EngineConfig sont définis comme suit en cas d'héritage d'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 l'heure à laquelle les données ont été utilisées pour générer des caractéristiques pour l'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