Model Evaluations - List

Service:

Azure AI Services

Version d'API:

2023-04-01-preview

Obtenez la liste des évaluations disponibles pour un modèle.

Codes d’état retournés :

• 200 : Opération terminée avec succès.
• 400 : La demande a été mal formée.

GET /models/{name}/evaluations?api-version=2023-04-01-preview

Avec des paramètres facultatifs:

GET /models/{name}/evaluations?skip={skip}&top={top}&api-version=2023-04-01-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
name	path	True	string	Nom du modèle pour lequel obtenir des évaluations. Modèle d’expression régulière: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
api-version	query	True	string	Version de l’API demandée.
skip	query		integer int32	Nombre d’évaluations à ignorer.
top	query		integer int32	Nombre d’évaluations à retourner après avoir ignoré. La valeur maximale autorisée est 30.

Réponses

Nom	Type	Description
200 OK	ModelEvaluationApiModelCollectionApiModel	Succès
Other Status Codes	ErrorResponse	Error En-têtes x-ms-error-code: string

Exemples

ModelEvaluations_List

Exemple de requête

HTTP

GET /models/my_model_name/evaluations?api-version=2023-04-01-preview

Exemple de réponse

Code d’état:

200

{
  "value": [
    {
      "name": "my_evaluation_name",
      "modelName": "my_model_name",
      "createdDateTime": "2023-01-13T20:46:22.127Z",
      "updatedDateTime": "2023-01-13T20:46:22.127Z",
      "status": "notStarted",
      "evaluationParameters": {
        "testDatasetName": "my_test_dataset_name"
      }
    }
  ]
}

Définitions

Nom	Description
ErrorResponse	Réponse retournée lorsqu’une erreur se produit.
ErrorResponseDetails	Informations sur l’erreur.
ErrorResponseInnerError	Erreur détaillée.
ModelEvaluation	Décrit une exécution d’évaluation pour évaluer la précision d’un modèle à l’aide d’un jeu de test.
ModelEvaluationApiModelCollectionApiModel	Contient un tableau de résultats qui peuvent être paginés.
ModelEvaluationParameters	Paramètres permettant de spécifier la façon dont un modèle est évalué.
ModelEvaluationState	Lecture seule. État actuel de l’exécution de l’évaluation.
ModelPerformance	Métriques de performances pour un modèle entraîné personnalisé.
ModelTagPerformance	Métriques de performances pour chaque balise reconnue par un modèle entraîné personnalisé.

ErrorResponse

Réponse retournée lorsqu’une erreur se produit.

Nom	Type	Description
error	ErrorResponseDetails	Informations sur l’erreur.

ErrorResponseDetails

Informations sur l’erreur.

Nom	Type	Description
code	string	Code d’erreur.
details	ErrorResponseDetails[]	Liste des erreurs détaillées.
innererror	ErrorResponseInnerError	Erreur détaillée.
message	string	Message d’erreur.
target	string	Cible de l’erreur.

ErrorResponseInnerError

Erreur détaillée.

Nom	Type	Description
code	string	Code d’erreur.
innererror	ErrorResponseInnerError	Erreur détaillée.
message	string	Message d’erreur.

ModelEvaluation

Décrit une exécution d’évaluation pour évaluer la précision d’un modèle à l’aide d’un jeu de test.

Nom	Type	Description
createdDateTime	string	Lecture seule. Date et heure de création de l’exécution d’évaluation, en UTC.
error	ErrorResponseDetails	Informations sur l’erreur.
evaluationParameters	ModelEvaluationParameters	Paramètres permettant de spécifier la façon dont un modèle est évalué.
modelName	string	Lecture seule. Modèle à évaluer.
modelPerformance	ModelPerformance	Métriques de performances pour un modèle entraîné personnalisé.
name	string	Lecture seule. Nom utilisé pour identifier de manière unique l’exécution d’évaluation.
status	ModelEvaluationState	Lecture seule. État actuel de l’exécution de l’évaluation.
updatedDateTime	string	Lecture seule. Date et heure de la dernière mise à jour de l’exécution de l’évaluation, en UTC.

ModelEvaluationApiModelCollectionApiModel

Contient un tableau de résultats qui peuvent être paginés.

Nom	Type	Description
nextLink	string	Un lien vers l’ensemble suivant de résultats paginés, s’il existe d’autres résultats disponibles ; pas présent dans le cas contraire.
value	ModelEvaluation[]	Tableau de résultats.

ModelEvaluationParameters

Paramètres permettant de spécifier la façon dont un modèle est évalué.

Nom	Type	Description
testDatasetName	string	Nom du jeu de données utilisé pour le test.

ModelEvaluationState

Lecture seule. État actuel de l’exécution de l’évaluation.

Nom	Type	Description
failed	string
notStarted	string
running	string
succeeded	string

ModelPerformance

Métriques de performances pour un modèle entraîné personnalisé.

Nom	Type	Description
accuracyTop1	number	Lecture seule. Pour les modèles de classification multiclasse. Proportion d’échantillons de test où la classe de vérité de base correspond à la classe prédite.
accuracyTop5	number	Lecture seule. Pour les modèles de classification multiclasse. Proportion d’échantillons de test où la classe de vérité au sol se trouve dans les cinq premières classes prédites.
averagePrecision	number	Lecture seule. Mesure des performances du modèle, elle résume la précision et le rappel à différents seuils de confiance.
calibrationECE	number	Lecture seule. Pour les modèles de classification multiclasse. Erreur d’étalonnage attendue.
meanAveragePrecision30	number	Lecture seule. Pour les modèles de détection d’objets. Précision moyenne moyenne à un seuil de 30 %.
meanAveragePrecision50	number	Lecture seule. Pour les modèles de détection d’objets. Précision moyenne moyenne à un seuil de 50 %.
meanAveragePrecision75	number	Lecture seule. Pour les modèles de détection d’objets. Précision moyenne moyenne à un seuil de 75 %.
tagPerformance	<string,  ModelTagPerformance>	Lecture seule. Métriques de performances pour chaque balise reconnue par le modèle.

ModelTagPerformance

Métriques de performances pour chaque balise reconnue par un modèle entraîné personnalisé.

Nom	Type	Description
accuracy	number	Lecture seule. Pour les modèles multiclasses. Précision des étiquettes.
averagePrecision50	number	Lecture seule. Pour les modèles de détection d’objets. Précision moyenne à un seuil de 50 %.