Rejoignez la communauté SIG TFX-Addons et contribuez à rendre TFX encore meilleur ! Rejoignez SIG TFX-Addons

Le composant Evaluator TFX Pipeline

Le composant de pipeline Evaluator TFX effectue une analyse approfondie des résultats d'entraînement pour vos modèles, pour vous aider à comprendre comment votre modèle fonctionne sur des sous-ensembles de vos données. L'évaluateur vous aide également à valider vos modèles exportés, en veillant à ce qu'ils soient «suffisamment bons» pour être mis en production.

Lorsque la validation est activée, l'évaluateur compare les nouveaux modèles à une référence (telle que le modèle actuellement diffusé) pour déterminer s'ils sont «assez bons» par rapport à la référence. Il le fait en évaluant les deux modèles sur un ensemble de données d'évaluation et en calculant leurs performances sur les métriques (par exemple AUC, perte). Si les métriques du nouveau modèle répondent aux critères spécifiés par le développeur par rapport au modèle de base (par exemple, l'AUC n'est pas inférieure), le modèle est "béni" (marqué comme bon), indiquant au pousseur qu'il est correct de pousser le modèle en production.

  • Consomme:
    • Une séparation eval de ExampleGen
    • Un modèle formé de Trainer
    • Un modèle auparavant béni (si validation à effectuer)
  • Émet:

Analyse du modèle Evaluator et TensorFlow

Evaluator exploite la bibliothèque d' analyse de modèle TensorFlow pour effectuer l'analyse, qui à son tour utilise Apache Beam pour un traitement évolutif.

Utilisation du composant Evaluator

Un composant de pipeline Evaluator est généralement très facile à déployer et nécessite peu de personnalisation, car la plupart du travail est effectué par le composant Evaluator TFX.

Pour configurer l'évaluateur, les informations suivantes sont nécessaires:

Si la validation doit être incluse, les informations supplémentaires suivantes sont nécessaires:

Lorsqu'elle est activée, la validation sera effectuée par rapport à toutes les mesures et tranches qui ont été définies.

Le code typique ressemble à ceci:

import tensorflow_model_analysis as tfma
...

# For TFMA evaluation

eval_config = tfma.EvalConfig(
    model_specs=[
        # This assumes a serving model with signature 'serving_default'. If
        # using estimator based EvalSavedModel, add signature_name='eval' and
        # remove the label_key. Note, if using a TFLite model, then you must set
        # model_type='tf_lite'.
        tfma.ModelSpec(label_key='<label_key>')
    ],
    metrics_specs=[
        tfma.MetricsSpec(
            # The metrics added here are in addition to those saved with the
            # model (assuming either a keras model or EvalSavedModel is used).
            # Any metrics added into the saved model (for example using
            # model.compile(..., metrics=[...]), etc) will be computed
            # automatically.
            metrics=[
                tfma.MetricConfig(class_name='ExampleCount'),
                tfma.MetricConfig(
                    class_name='BinaryAccuracy',
                    threshold=tfma.MetricThreshold(
                        value_threshold=tfma.GenericValueThreshold(
                            lower_bound={'value': 0.5}),
                        change_threshold=tfma.GenericChangeThreshold(
                            direction=tfma.MetricDirection.HIGHER_IS_BETTER,
                            absolute={'value': -1e-10})))
            ]
        )
    ],
    slicing_specs=[
        # An empty slice spec means the overall slice, i.e. the whole dataset.
        tfma.SlicingSpec(),
        # Data can be sliced along a feature column. In this case, data is
        # sliced along feature column trip_start_hour.
        tfma.SlicingSpec(feature_keys=['trip_start_hour'])
    ])

# The following component is experimental and may change in the future. This is
# required to specify the latest blessed model will be used as the baseline.
model_resolver = Resolver(
      strategy_class=dsl.experimental.LatestBlessedModelStrategy,
      model=Channel(type=Model),
      model_blessing=Channel(type=ModelBlessing)
).with_id('latest_blessed_model_resolver')

model_analyzer = Evaluator(
      examples=examples_gen.outputs['examples'],
      model=trainer.outputs['model'],
      baseline_model=model_resolver.outputs['model'],
      # Change threshold will be ignored if there is no baseline (first run).
      eval_config=eval_config)

L'évaluateur produit un EvalResult (et éventuellement un ValidationResult si la validation a été utilisée) qui peut être chargé à l'aide de TFMA . Voici un exemple de chargement des résultats dans un bloc-notes Jupyter:

import tensorflow_model_analysis as tfma

output_path = evaluator.outputs['evaluation'].get()[0].uri

# Load the evaluation results.
eval_result = tfma.load_eval_result(output_path)

# Visualize the metrics and plots using tfma.view.render_slicing_metrics,
# tfma.view.render_plot, etc.
tfma.view.render_slicing_metrics(tfma_result)
...

# Load the validation results
validation_result = tfma.load_validation_result(output_path)
if not validation_result.validation_ok:
  ...

Plus de détails sont disponibles dans la référence de l'API Evaluator .