Model Evaluations - Get

Riferimento

Servizio:: Azure AI Services

Versione API:: 2023-04-01-preview

Ottenere informazioni su una valutazione del modello specifica.

Codici di stato restituiti:

200: Operazione completata correttamente.
400: La richiesta non è riuscita.
404: non è stata trovata una valutazione del modello con il nome specificato.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione

evaluationName

path

True

string

Nome della valutazione del modello da ottenere.

Criterio di espressione regolare: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$

name

path

True

string

Nome del modello per cui ottenere la valutazione.

Criterio di espressione regolare: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$

api-version

query

True

string

Versione dell'API richiesta.

Risposte

Nome

Tipo

Descrizione

200 OK

ModelEvaluation

Operazione completata

Other Status Codes

Errore

Intestazioni

x-ms-error-code: string

Esempio

ModelEvaluations_Get

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 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"
  }
}

Definizioni

Nome	Descrizione
ErrorResponse	Risposta restituita quando si verifica un errore.
ErrorResponseDetails	Informazioni sugli errori.
ErrorResponseInnerError	Errore dettagliato.
ModelEvaluation	Descrive un'esecuzione di valutazione per valutare l'accuratezza di un modello usando un set di test.
ModelEvaluationParameters	Parametri per specificare la modalità di valutazione di un modello.
ModelEvaluationState	Sola lettura. Stato corrente dell'esecuzione della valutazione.
ModelPerformance	Metriche delle prestazioni per un modello con training personalizzato.
ModelTagPerformance	Metriche delle prestazioni per ogni tag riconosciuto da un modello con training personalizzato.

ErrorResponse

Risposta restituita quando si verifica un errore.

Nome	Tipo	Descrizione
error	ErrorResponseDetails	Informazioni sugli errori.

ErrorResponseDetails

Informazioni sugli errori.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	ErrorResponseDetails[]	Elenco degli errori dettagliati.
innererror	ErrorResponseInnerError	Errore dettagliato.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponseInnerError

Errore dettagliato.

Nome	Tipo	Descrizione
code	string	Codice di errore.
innererror	ErrorResponseInnerError	Errore dettagliato.
message	string	Messaggio di errore.

ModelEvaluation

Descrive un'esecuzione di valutazione per valutare l'accuratezza di un modello usando un set di test.

Nome	Tipo	Descrizione
createdDateTime	string	Sola lettura. Data e ora in cui è stata creata per la prima volta l'esecuzione della valutazione, in formato UTC.
error	ErrorResponseDetails	Informazioni sugli errori.
evaluationParameters	ModelEvaluationParameters	Parametri per specificare la modalità di valutazione di un modello.
modelName	string	Sola lettura. Modello da valutare.
modelPerformance	ModelPerformance	Metriche delle prestazioni per un modello con training personalizzato.
name	string	Sola lettura. Nome utilizzato per identificare in modo univoco l'esecuzione della valutazione.
status	ModelEvaluationState	Sola lettura. Stato corrente dell'esecuzione della valutazione.
updatedDateTime	string	Sola lettura. Data e ora dell'ultimo aggiornamento dell'esecuzione della valutazione, in formato UTC.

ModelEvaluationParameters

Parametri per specificare la modalità di valutazione di un modello.

Nome	Tipo	Descrizione
testDatasetName	string	Nome del set di dati usato per il test.

ModelEvaluationState

Sola lettura. Stato corrente dell'esecuzione della valutazione.

Nome	Tipo	Descrizione
failed	string
notStarted	string
running	string
succeeded	string

ModelPerformance

Metriche delle prestazioni per un modello con training personalizzato.

Nome	Tipo	Descrizione
accuracyTop1	number	Sola lettura. Per i modelli di classificazione multiclasse. Percentuale di campioni di test in cui la classe di verità di base corrisponde alla classe stimata.
accuracyTop5	number	Sola lettura. Per i modelli di classificazione multiclasse. Percentuale di campioni di test in cui la classe di verità del terreno è nelle prime cinque classi stimate.
averagePrecision	number	Sola lettura. Una misura delle prestazioni del modello riepiloga la precisione e il richiamo a soglie di confidenza diverse.
calibrationECE	number	Sola lettura. Per i modelli di classificazione multiclasse. Errore di calibrazione previsto.
meanAveragePrecision30	number	Sola lettura. Per i modelli di rilevamento oggetti. Precisione media media a una soglia del 30%.
meanAveragePrecision50	number	Sola lettura. Per i modelli di rilevamento oggetti. Precisione media media a una soglia del 50%.
meanAveragePrecision75	number	Sola lettura. Per i modelli di rilevamento oggetti. Precisione media media in corrispondenza di una soglia del 75%.
tagPerformance	<string, ModelTagPerformance>	Sola lettura. Metriche delle prestazioni per ogni tag riconosciuto dal modello.

ModelTagPerformance

Metriche delle prestazioni per ogni tag riconosciuto da un modello con training personalizzato.

Nome	Tipo	Descrizione
accuracy	number	Sola lettura. Per i modelli multiclasse. Accuratezza dei tag.
averagePrecision50	number	Sola lettura. Per i modelli di rilevamento oggetti. Precisione media a una soglia del 50%.