Configurer un moteur

Cette page présente brièvement les concepts de base 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 compatibles:

  • 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érite des hyperparamètres d'une configuration de moteur précédente qui était créé avec une version de moteur antérieure 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 une héritance

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 régler

Vous pouvez ajuster chaque nouvelle configuration de moteur. En cas de doute, vous devez toujours optimiser pour obtenir les meilleures performances. 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 selon laquelle les champs sont remplis
    • 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.

Versions du moteur avec la version de réglage v003 et versions de moteur antérieures à 22/02/2024, ne prennent pas en charge l'héritage des hyperparamètres, mais ces versions peut servir de source d'hyperparamètres.

Régler un moteur

Pour déclencher l'ajustement, 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.

    Le réglage du moteur utilise des étiquettes et des fonctionnalités basées sur des mois calendaires complets jusqu'au mois correspondant à l'heure de fin sélectionnée. 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 AML afin de s'assurer qu'elle 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. 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 de la valeur par défaut hyperparamètres

  • 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 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 lorsque vous utilisez des hyperparamètres ajusté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

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'AML basée sur l'IA devraient Manquante 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 toute famille de caractéristiques entre le réglage l'entraînement, l'évaluation et la prédiction peuvent indiquer des incohérences 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 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 le 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 des hyperparamètres est défini sur TUNING pour permettre le retour en arrière et la compatibilité avec d'autres appareils.
  • Source des hyperparamètres:spécifiez le nom complet de la ressource de la source. configuration du moteur dans l'objet hyperparameterSource. Les sorties du source sont utilisées pour la nouvelle configuration de 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 commercial) pour les modèles que vous souhaitez utiliser. Si vous héritez d'hyperparamètres, le secteur d'activité doit correspondre au secteur d'activité utilisé pour l'hyperparamètre source.

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

L'héritage des hyperparamètres d'une autre version de moteur crée un Ressource EngineConfig qui permet de créer une ressource de modèle à l'aide de les 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