Model Evaluations - Create

Referentie

Service:: Azure AI Services

API-versie:: 2023-04-01-preview

Evalueer een bestaand model.

Statuscodes geretourneerd:

201: De bewerking is voltooid.
400: De aanvraag is onjuist gevormd.
409: Er bestaat al een evaluatie met de opgegeven naam.

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

URI-parameters

Name	In	Vereist	Type	Description
evaluationName	path	True	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Een naam die kan worden gebruikt om de evaluatie uniek te identificeren nadat deze is gemaakt.
name	path	True	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	De naam van het model dat moet worden geëvalueerd.
api-version	query	True	string	Aangevraagde API-versie.

Aanvraagbody

Media Types: "application/json-patch+json"

Name	Vereist	Type	Description
evaluationParameters	True	ModelEvaluationParameters	Parameters voor het opgeven van hoe een model wordt geëvalueerd.
createdDateTime		string (date-time)	Alleen-lezen. De datum en tijd waarop de evaluatieuitvoering voor het eerst is gemaakt, in UTC.
error		ErrorResponseDetails	Foutinformatie.
modelName		string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Alleen-lezen. Het model dat moet worden geëvalueerd.
modelPerformance		ModelPerformance	Metrische prestatiegegevens voor een aangepast getraind model.
name		string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	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 (date-time)	Alleen-lezen. De datum en tijd waarop de evaluatieuitvoering voor het laatst is bijgewerkt, in UTC.

Antwoorden

Name	Type	Description
201 Created	ModelEvaluation	Gemaakt
Other Status Codes	ErrorResponse	Fout Kopteksten x-ms-error-code: string

Name

Type

Description

201 Created

ModelEvaluation

Gemaakt

Other Status Codes

ErrorResponse

Fout

Kopteksten

x-ms-error-code: string

Voorbeelden

ModelEvaluations_Create

Voorbeeldaanvraag

HTTP

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

{
  "evaluationParameters": {
    "testDatasetName": "my_test_dataset_name"
  }
}

Voorbeeldrespons

Statuscode:: 201

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

Object

Antwoord geretourneerd wanneer er een fout optreedt.

Name	Type	Description
error	ErrorResponseDetails	Foutinformatie.

ErrorResponseDetails

Object

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

Object

Gedetailleerde fout.

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

ModelEvaluation

Object

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

Name	Type	Description
createdDateTime	string (date-time)	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 maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Alleen-lezen. Het model dat moet worden geëvalueerd.
modelPerformance	ModelPerformance	Metrische prestatiegegevens voor een aangepast getraind model.
name	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	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 (date-time)	Alleen-lezen. De datum en tijd waarop de evaluatieuitvoering voor het laatst is bijgewerkt, in UTC.

ModelEvaluationParameters

Object

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

Name	Type	Description
testDatasetName	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	De naam van de gegevensset die wordt gebruikt voor het testen.

ModelEvaluationState

Inventarisatie

Alleen-lezen. De huidige status van de evaluatieuitvoering.

Waarde	Description
failed
notStarted
running
succeeded

ModelPerformance

Object

Metrische prestatiegegevens voor een aangepast getraind model.

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

ModelTagPerformance

Object

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

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

Delen via

Model Evaluations - Create

URI-parameters

Aanvraagbody

Antwoorden

Voorbeelden

ModelEvaluations_Create

Voorbeeldaanvraag

Voorbeeldrespons

Definities

ErrorResponse

ErrorResponseDetails

ErrorResponseInnerError

ModelEvaluation

ModelEvaluationParameters

ModelEvaluationState

ModelPerformance

ModelTagPerformance

Aanvullende resources