Configurer un moteur

Cette page traite brièvement des concepts liés à la configuration d'un moteur.

Sources acceptées pour les hyperparamètres

Lors de la configuration d'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éritez les 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 d'avoir à réajuster chaque fois que vous adoptez une nouvelle version de moteur de modèles.

Quand régler ou hériter

Les sections suivantes expliquent dans quels cas sélectionner le réglage automatique ou 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 ajuster afin d'obtenir les meilleures performances possibles. Pour en savoir plus, consultez la section Régler un moteur.

Pour des performances optimales, vous devez envisager d'ajuster 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
    • La logique ou la sélection des données fournies dans la table PartySupplementaryData.
  • Un moteur va 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 reréglage.

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 déclencher le réglage, 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 dans la plage de dates de l'ensemble de données.

    Le réglage du moteur utilise des libellés et des fonctionnalités basés 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 Plages de temps associées à l'ensemble 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.

  • Volume d'investigations que vous attendez d'après les modèles:

    Spécifiez partyInvestigationsPerPeriodHint. Cette approche est utilisée par le réglage du moteur, l'entraînement et les tests en arrière-plan pour garantir que l'AML basée sur l'IA offre des performances adaptées à votre volume d'investigations 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 ce qui suit:

  • Gain de performances attendu grâce au réglage du 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'enquêtes 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'enquêtes par mois spécifié dans partyInvestigationsPerPeriodHint.

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

Part des valeurs manquantes pour toutes les caractéristiques de chaque famille de caractéristiques.

Idéalement, le champ "Manquant" de toutes les familles de caractéristiques d'IA de l'AML doit être proche de 0. Des exceptions peuvent se produire lorsque les données sous-jacentes à ces familles de caractéristiques ne sont pas disponibles pour l'intégration.

Un changement significatif de cette valeur pour une famille de caractéristiques entre le réglage, l'entraînement, l'évaluation et la prédiction peut indiquer des incohérences 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 du moteur sans reréglage

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 d'hyperparamètres de la page Créer et gérer des configurations de moteur. Vous devez en particulier sélectionner les éléments suivants:

  • Hyperparameter source type (Type de source de l'hyperparamètre) : sélectionnez INHERITED comme hyperparameterSourceType. Si vous ne spécifiez pas le type de source, celui-ci 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 de moteur de réglage que vous utilisez maintenant.
  • Version du moteur à utiliser pour la configuration du moteur:sélectionnez une version du moteur correspondant à votre secteur d'activité (commerce ou professionnel) pour les modèles que vous souhaitez utiliser. Ce secteur d'activité doit correspondre à celui défini dans la configuration du moteur que vous utilisez comme source d'hyperparamètres.

Sortie et traçabilité lors de l'héritage

L'héritage des hyperparamètres d'une autre version du 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 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 le dernier moment à partir duquel les données ont été utilisées pour générer des caractéristiques 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 des réglages de moteur d'origine