Model Evaluations - Get

Service:

Azure AI Services

API-versie:

2023-04-01-preview

Informatie ophalen over een specifieke modelevaluatie.

Geretourneerde statuscodes:

• 200: De bewerking is voltooid.
• 400: Het verzoek is onjuist ingedeeld.
• 404: Er is geen modelevaluatie met de opgegeven naam gevonden.

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

URI-parameters

Name	In	Vereist	Type	Description
evaluationName	path	True	string	De naam van de modelevaluatie die u wilt ophalen. Regex-patroon: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
name	path	True	string	De naam van het model waarvoor u de evaluatie wilt ophalen. Regex-patroon: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
api-version	query	True	string	Aangevraagde API-versie.

Antwoorden

Name	Type	Description
200 OK	ModelEvaluation	Geslaagd
Other Status Codes	ErrorResponse	Fout Kopteksten x-ms-error-code: string

Voorbeelden

ModelEvaluations_Get

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:

200

{
  "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"
  }
}

Definities

Name	Description
ErrorResponse	Antwoord geretourneerd wanneer er een fout optreedt.
ErrorResponseDetails	Foutinformatie.
ErrorResponseInnerError	Gedetailleerde fout.
ModelEvaluation	Beschrijft een evaluatieuitvoering voor het evalueren van de nauwkeurigheid van een model met behulp van een testset.
ModelEvaluationParameters	Parameters voor het opgeven van hoe een model wordt geëvalueerd.
ModelEvaluationState	Alleen-lezen. De huidige status van de evaluatieuitvoering.
ModelPerformance	Metrische prestatiegegevens voor een aangepast getraind model.
ModelTagPerformance	Metrische prestatiegegevens voor elke tag die wordt herkend door een aangepast getraind model.

ErrorResponse

Antwoord geretourneerd wanneer er een fout optreedt.

Name	Type	Description
error	ErrorResponseDetails	Foutinformatie.

ErrorResponseDetails

Foutinformatie.

Name	Type	Description
code	string	Foutcode.
details	ErrorResponseDetails[]	Lijst met gedetailleerde fouten.
innererror	ErrorResponseInnerError	Gedetailleerde fout.
message	string	Foutmelding.
target	string	Doel van de fout.

ErrorResponseInnerError

Gedetailleerde fout.

Name	Type	Description
code	string	Foutcode.
innererror	ErrorResponseInnerError	Gedetailleerde fout.
message	string	Foutmelding.

ModelEvaluation

Beschrijft een evaluatieuitvoering voor het evalueren van de nauwkeurigheid van een model met behulp van een testset.

Name	Type	Description
createdDateTime	string	Alleen-lezen. De datum en tijd waarop de evaluatieuitvoering voor het eerst is gemaakt, in UTC.
error	ErrorResponseDetails	Foutinformatie.
evaluationParameters	ModelEvaluationParameters	Parameters voor het opgeven van hoe een model wordt geëvalueerd.
modelName	string	Alleen-lezen. Het model dat moet worden geëvalueerd.
modelPerformance	ModelPerformance	Metrische prestatiegegevens voor een aangepast getraind model.
name	string	Alleen-lezen. De naam die wordt gebruikt om de evaluatieuitvoering uniek te identificeren.
status	ModelEvaluationState	Alleen-lezen. De huidige status van de evaluatieuitvoering.
updatedDateTime	string	Alleen-lezen. De datum en tijd waarop de evaluatieuitvoering voor het laatst is bijgewerkt, in UTC.

ModelEvaluationParameters

Parameters voor het opgeven van hoe een model wordt geëvalueerd.

Name	Type	Description
testDatasetName	string	De naam van de gegevensset die wordt gebruikt voor het testen.

ModelEvaluationState

Alleen-lezen. De huidige status van de evaluatieuitvoering.

Name	Type	Description
failed	string
notStarted	string
running	string
succeeded	string

ModelPerformance

Metrische prestatiegegevens voor een aangepast getraind model.

Name	Type	Description
accuracyTop1	number	Alleen-lezen. Voor classificatiemodellen met meerdere klassen. Het aandeel testmonsters waarbij de grondwaarheidsklasse overeenkomt met de voorspelde klasse.
accuracyTop5	number	Alleen-lezen. Voor classificatiemodellen met meerdere klassen. Het aandeel testmonsters waarbij de klasse ground truth zich in de top vijf voorspelde klassen bevindt.
averagePrecision	number	Alleen-lezen. Dit is een meting van de prestaties van het model en geeft een overzicht van de precisie en relevante overeenkomsten bij verschillende betrouwbaarheidsdrempels.
calibrationECE	number	Alleen-lezen. Voor classificatiemodellen met meerdere klassen. Verwachte kalibratiefout.
meanAveragePrecision30	number	Alleen-lezen. Voor objectdetectiemodellen. Gemiddelde precisie bij een drempelwaarde van 30%.
meanAveragePrecision50	number	Alleen-lezen. Voor objectdetectiemodellen. Gemiddelde gemiddelde precisie bij een drempelwaarde van 50%.
meanAveragePrecision75	number	Alleen-lezen. Voor objectdetectiemodellen. Gemiddelde gemiddelde precisie bij een drempelwaarde van 75%.
tagPerformance	<string,  ModelTagPerformance>	Alleen-lezen. Metrische prestatiegegevens voor elke tag die door het model wordt herkend.

ModelTagPerformance

Metrische prestatiegegevens voor elke tag die wordt herkend door een aangepast getraind model.

Name	Type	Description
accuracy	number	Alleen-lezen. Voor modellen met meerdere klassen. Labelnauwkeurigheid.
averagePrecision50	number	Alleen-lezen. Voor objectdetectiemodellen. Gemiddelde precisie bij een drempelwaarde van 50%.