Evaluations - Get

Riferimento

Servizio:: Azure AI Services

Versione API:: v3.2-preview.2

Ottiene la valutazione identificata dall'ID specificato.

GET {endpoint}/speechtotext/v3.2-preview.2/evaluations/{id}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://westus.api.cognitive.microsoft.com).
id	path	True	string (uuid)	Identificatore della valutazione.

Risposte

Nome	Tipo	Descrizione
200 OK	Evaluation	Va bene Intestazioni Retry-After: integer
Other Status Codes	Error	Si è verificato un errore.

Nome

Tipo

Descrizione

200 OK

Evaluation

Va bene

Intestazioni

Retry-After: integer

Other Status Codes

Error

Si è verificato un errore.

Sicurezza

Ocp-Apim-Subscription-Key

Specificare la chiave dell'account di Servizi cognitivi qui.

Tipo: apiKey
In: header

Authorization

Fornire un token di accesso dal token JWT restituito dal servizio token di sicurezza di questa area. Assicurarsi di aggiungere l'ambito di gestione al token aggiungendo la stringa di query seguente all'URL sts: ?scope=speechservicesmanagement

Tipo: apiKey
In: header

Esempio

Get a evaluation

Esempio di richiesta

HTTP

GET {endpoint}/speechtotext/v3.2-preview.2/evaluations/1c50ce42-6ab7-454f-8c39-54a752d1a5b6

Risposta di esempio

Codice di stato:: 200

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/evaluations/1c50ce42-6ab7-454f-8c39-54a752d1a5b6",
  "model1": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
  },
  "model2": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "dataset": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1"
  },
  "transcription2": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ad86d0c9-af6d-4d14-a621-c60d7d65b74f"
  },
  "transcription1": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/evaluations/00000000-0000-0000-0000-000000000000/files"
  },
  "properties": {
    "wordErrorRate2": 0.065,
    "wordErrorRate1": 0.065,
    "sentenceErrorRate2": 0.375,
    "sentenceCount2": 8,
    "wordCount2": 46,
    "correctWordCount2": 43,
    "wordSubstitutionCount2": 3,
    "wordDeletionCount2": 0,
    "wordInsertionCount2": 0,
    "sentenceErrorRate1": 0.375,
    "sentenceCount1": 8,
    "wordCount1": 46,
    "correctWordCount1": 43,
    "wordSubstitutionCount1": 3,
    "wordDeletionCount1": 0,
    "wordInsertionCount1": 0,
    "tokenErrorRate2": 0.125,
    "tokenErrorRate1": 0.125,
    "tokenCount2": 48,
    "correctTokenCount2": 42,
    "tokenSubstitutionCount2": 6,
    "tokenDeletionCount2": 0,
    "tokenInsertionCount2": 0,
    "tokenCount1": 48,
    "correctTokenCount1": 42,
    "tokenSubstitutionCount1": 6,
    "tokenDeletionCount1": 0,
    "tokenInsertionCount1": 0
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Evalution of one model against another model"
}

Definizioni

Nome	Descrizione
DetailedErrorCode	DetailedErrorCode
EntityError	EntityError
EntityReference	EntityReference
Error	Errore
ErrorCode	Codice Errore
Evaluation	Valutazione
EvaluationLinks	EvaluationLinks
EvaluationProperties	EvaluationProperties
InnerError	InnerError
Status	Stato

DetailedErrorCode

Enumerazione

DetailedErrorCode

Valore	Descrizione
DataImportFailed	Importazione dei dati non riuscita.
DeleteNotAllowed	Eliminazione non consentita.
DeployNotAllowed	Distribuzione non consentita.
DeployingFailedModel	Distribuzione del modello non riuscito.
EmptyRequest	Richiesta vuota.
EndpointCannotBeDefault	L'endpoint non può essere predefinito.
EndpointNotUpdatable	Endpoint non aggiornabile.
EndpointWithoutLogging	Endpoint senza registrazione.
ExceededNumberOfRecordingsUris	È stato superato il numero di URI delle registrazioni.
FailedDataset	Set di dati non riuscito.
Forbidden	Vietato.
InUseViolation	In violazione dell'uso.
InaccessibleCustomerStorage	Archiviazione dei clienti inaccessibile.
InvalidAdaptationMapping	Mapping di adattamento non valido.
InvalidBaseModel	Modello di base non valido.
InvalidCallbackUri	URI di callback non valido.
InvalidCollection	Raccolta non valida.
InvalidDataset	Set di dati non valido.
InvalidDocument	Documento non valido.
InvalidDocumentBatch	Batch di documenti non valido.
InvalidLocale	Impostazioni locali non valide.
InvalidLogDate	Data del log non valida.
InvalidLogEndTime	Ora di fine del log non valida.
InvalidLogId	ID log non valido.
InvalidLogStartTime	Ora di inizio del log non valida.
InvalidModel	Modello non valido.
InvalidModelUri	URI del modello non valido.
InvalidParameter	Parametro non valido.
InvalidParameterValue	Valore del parametro non valido.
InvalidPayload	Payload non valido.
InvalidPermissions	Autorizzazioni non valide.
InvalidPrerequisite	Prerequisito non valido.
InvalidProductId	ID prodotto non valido.
InvalidProject	Progetto non valido.
InvalidProjectKind	Tipo di progetto non valido.
InvalidRecordingsUri	URI delle registrazioni non valido.
InvalidRequestBodyFormat	Formato del corpo della richiesta non valido.
InvalidSasValidityDuration	Durata della validità della firma di accesso condiviso non valida.
InvalidSkipTokenForLogs	Token skip non valido per i log.
InvalidSourceAzureResourceId	ID risorsa di Azure di origine non valido.
InvalidSubscription	Sottoscrizione non valida.
InvalidTest	Test non valido.
InvalidTimeToLive	Tempo di vita non valido.
InvalidTopForLogs	Top non valido per i log.
InvalidTranscription	Trascrizione non valida.
InvalidWebHookEventKind	Tipo di evento web hook non valido.
MissingInputRecords	Record di input mancanti.
ModelCopyOperationExists	Esiste un'operazione di copia del modello.
ModelDeploymentNotCompleteState	Lo stato della distribuzione del modello non è completo.
ModelDeprecated	Modello deprecato.
ModelExists	Il modello esiste.
ModelMismatch	Mancata corrispondenza del modello.
ModelNotDeployable	Modello non distribuibile.
ModelVersionIncorrect	Versione del modello non corretta.
NoUtf8WithBom	Nessun utf8 con bom.
OnlyOneOfUrlsOrContainerOrDataset	Solo uno degli URL o del contenitore o del set di dati.
ProjectGenderMismatch	Mancata corrispondenza di genere del progetto.
QuotaViolation	Violazione della quota.
SingleDefaultEndpoint	Singolo endpoint predefinito.
SkuLimitsExist	Esistono limiti di SKU.
SubscriptionNotFound	Sottoscrizione non trovata.
UnexpectedError	Errore imprevisto.
UnsupportedClassBasedAdaptation	Adattamento basato su classe non supportato.
UnsupportedDelta	Delta non supportato.
UnsupportedDynamicConfiguration	Configurazione dinamica non supportata.
UnsupportedFilter	Filtro non supportato.
UnsupportedLanguageCode	Codice del linguaggio non supportato.
UnsupportedOrderBy	Ordine non supportato per.
UnsupportedPagination	Impaginazione non supportata.
UnsupportedTimeRange	Intervallo di tempo non supportato.

EntityError

Object

EntityError

Nome	Tipo	Descrizione
code	string	Codice di questo errore.
message	string	Messaggio per questo errore.

EntityReference

Object

EntityReference

Nome	Tipo	Descrizione
self	string (uri)	Posizione dell'entità a cui si fa riferimento.

Error

Object

Errore

Nome	Tipo	Descrizione
code	ErrorCode	Codice Errore Codici di errore di alto livello.
details	Error[]	Ulteriori dettagli di supporto relativi all'errore e/o ai criteri previsti.
innerError	InnerError	InnerError Nuovo formato di errore interno conforme alle linee guida dell'API Servizi cognitivi, disponibile in https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene le proprietà obbligatorie ErrorCode, message e proprietà facoltative di destinazione, dettagli(coppia chiave-valore), errore interno (che può essere annidato).
message	string	Messaggio di errore di alto livello.
target	string	Indica l'origine dell'errore. Ad esempio, si tratta di "documenti" o "ID documento" in caso di documento non valido.

ErrorCode

Enumerazione

Codice Errore

Valore	Descrizione
Conflict	Rappresentazione del codice di errore del conflitto.
Forbidden	Rappresentazione del codice di errore non consentito.
InternalCommunicationFailed	Rappresentazione del codice di errore della comunicazione interna non riuscita.
InternalServerError	Rappresentazione del codice di errore interno del server.
InvalidArgument	Rappresentazione del codice di errore dell'argomento non valido.
InvalidRequest	Rappresentazione del codice di errore della richiesta non valido.
NotAllowed	Rappresentazione del codice di errore non consentito.
NotFound	Rappresentazione del codice di errore non trovato.
PipelineError	Rappresentazione del codice di errore della pipeline.
ServiceUnavailable	Rappresentazione del codice di errore del servizio non disponibile.
TooManyRequests	Rappresentazione del codice di errore troppe richieste.
Unauthorized	Rappresentazione del codice di errore non autorizzato.
UnprocessableEntity	Rappresentazione del codice di errore dell'entità non elaborabile.
UnsupportedMediaType	Rappresentazione del codice di errore del tipo di supporto non supportato.

Evaluation

Object

Valutazione

Nome	Tipo	Descrizione
createdDateTime	string (date-time)	Timestamp al momento della creazione dell'oggetto. Il timestamp viene codificato come formato di data e ora ISO 8601 ("AAAA-MM-GGThh:mm:ssZ", vedere https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
customProperties	object	Proprietà personalizzate di questa entità. La lunghezza massima consentita della chiave è di 64 caratteri, la lunghezza massima consentita del valore è di 256 caratteri e il numero di voci consentite è 10.
dataset	EntityReference	EntityReference
description	string	Descrizione dell'oggetto.
displayName	string minLength: 1	Nome visualizzato dell'oggetto.
lastActionDateTime	string (date-time)	Timestamp quando è stato immesso lo stato corrente. Il timestamp viene codificato come formato di data e ora ISO 8601 ("AAAA-MM-GGThh:mm:ssZ", vedere https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
links	EvaluationLinks	EvaluationLinks
locale	string minLength: 1	Impostazioni locali dei dati contenuti.
model1	EntityReference	EntityReference
model2	EntityReference	EntityReference
project	EntityReference	EntityReference
properties	EvaluationProperties	EvaluationProperties
self	string (uri)	Posizione dell'entità.
status	Status	Stato Descrivere lo stato corrente dell'API
transcription1	EntityReference	EntityReference
transcription2	EntityReference	EntityReference

EvaluationLinks

Object

EvaluationLinks

Nome	Tipo	Descrizione
files	string (uri)	Percorso in cui ottenere tutti i file di questa entità. Per altri dettagli, vedere l'operazione "Evaluations_ListFiles".

EvaluationProperties

Object

EvaluationProperties

Nome	Tipo	Descrizione
correctTokenCount1	integer (int32)	Numero di token riconosciuti correttamente da model1.
correctTokenCount2	integer (int32)	Numero di token riconosciuti correttamente da model2.
correctWordCount1	integer (int32)	Numero di parole riconosciute correttamente da model1.
correctWordCount2	integer (int32)	Numero di parole riconosciute correttamente da model2.
email	string	Indirizzo di posta elettronica a cui inviare notifiche tramite posta elettronica nel caso in cui l'operazione venga completata. Il valore verrà rimosso dopo l'invio corretto del messaggio di posta elettronica.
error	EntityError	EntityError
sentenceCount1	integer (int32)	Numero di frasi elaborate in base a model1.
sentenceCount2	integer (int32)	Numero di frasi elaborate in base a model2.
sentenceErrorRate1	number (double)	Frequenza di errore della frase di riconoscimento con model1.
sentenceErrorRate2	number (double)	Frequenza di errore della frase di riconoscimento con model2.
tokenCount1	integer (int32)	Numero di token elaborati in base a model1.
tokenCount2	integer (int32)	Numero di token elaborati in base a model2.
tokenDeletionCount1	integer (int32)	Numero di token riconosciuti in base a model1, che sono eliminazioni.
tokenDeletionCount2	integer (int32)	Numero di token riconosciuti in base a model2, che sono eliminazioni.
tokenErrorRate1	number (double)	Frequenza di errore del token di riconoscimento con model1.
tokenErrorRate2	number (double)	Frequenza di errore del token di riconoscimento con model2.
tokenInsertionCount1	integer (int32)	Numero di token riconosciuti in base a model1, che sono inserimenti.
tokenInsertionCount2	integer (int32)	Numero di token riconosciuti in base a model2, che sono inserimenti.
tokenSubstitutionCount1	integer (int32)	Numero di token riconosciuti per model1, che sono sostituzioni.
tokenSubstitutionCount2	integer (int32)	Numero di token riconosciuti per model2, che sono sostituzioni.
wordCount1	integer (int32)	Numero di parole elaborate in base a model1.
wordCount2	integer (int32)	Numero di parole elaborate in base a model2.
wordDeletionCount1	integer (int32)	Numero di parole riconosciute da model1, che sono eliminazioni.
wordDeletionCount2	integer (int32)	Numero di parole riconosciute da model2, che sono eliminazioni.
wordErrorRate1	number (double)	Frequenza di errore della parola di riconoscimento con model1.
wordErrorRate2	number (double)	Frequenza di errore della parola di riconoscimento con model2.
wordInsertionCount1	integer (int32)	Numero di parole riconosciute da model1, che sono inserimenti.
wordInsertionCount2	integer (int32)	Numero di parole riconosciute da model2, che sono inserimenti.
wordSubstitutionCount1	integer (int32)	Numero di parole riconosciute da model1, che sono sostituzioni.
wordSubstitutionCount2	integer (int32)	Numero di parole riconosciute da model2, che sono sostituzioni.

InnerError

Object

InnerError

Nome	Tipo	Descrizione
code	DetailedErrorCode	DetailedErrorCode Enumerazione dettagliata del codice di errore.
details	object	Ulteriori dettagli di supporto relativi all'errore e/o ai criteri previsti.
innerError	InnerError	InnerError Nuovo formato di errore interno conforme alle linee guida dell'API Servizi cognitivi, disponibile in https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene le proprietà obbligatorie ErrorCode, message e proprietà facoltative di destinazione, dettagli(coppia chiave-valore), errore interno (che può essere annidato).
message	string	Messaggio di errore di alto livello.
target	string	Indica l'origine dell'errore. Ad esempio, si tratta di "documenti" o "ID documento" in caso di documento non valido.

Status

Enumerazione

Stato

Valore	Descrizione
Failed	L'operazione a esecuzione prolungata non è riuscita.
NotStarted	L'operazione a esecuzione prolungata non è ancora stata avviata.
Running	L'operazione a esecuzione prolungata è attualmente in elaborazione.
Succeeded	L'operazione a esecuzione prolungata è stata completata correttamente.

Condividi tramite

Evaluations - Get

Parametri dell'URI

Risposte

Sicurezza

Ocp-Apim-Subscription-Key

Authorization

Esempio

Get a evaluation

Esempio di richiesta

Risposta di esempio

Definizioni

DetailedErrorCode

EntityError

EntityReference

Error

ErrorCode

Evaluation

EvaluationLinks

EvaluationProperties

InnerError

Status

Risorse aggiuntive