Evaluations - List
Ottiene l'elenco delle valutazioni per la sottoscrizione autenticata.
GET {endpoint}/speechtotext/v3.2-preview.2/evaluations
GET {endpoint}/speechtotext/v3.2-preview.2/evaluations?skip={skip}&top={top}&filter={filter}
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). |
filter
|
query |
string |
Espressione di filtro per la selezione di un subset delle valutazioni disponibili.
|
|
skip
|
query |
integer (int32) |
Numero di set di dati che verranno ignorati. |
|
top
|
query |
integer (int32) |
Numero di set di dati che verranno inclusi dopo aver ignorato. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Va bene Intestazioni Retry-After: integer |
|
Other Status Codes |
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 all evaluations |
Get all evaluations with where status is equal to 'Running' |
Get all evaluations
Esempio di richiesta
GET {endpoint}/speechtotext/v3.2-preview.2/evaluations?skip=0&top=2
Risposta di esempio
{
"values": [
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/evaluations/a55a327b-c866-40b3-a08d-9c0945738633",
"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"
},
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/evaluations/daaa45a7-38f0-4918-87d2-bf55fec32ac5",
"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"
}
],
"@nextLink": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/evaluations/1c50ce42-6ab7-454f-8c39-54a752d1a5b6/files?skip=2&top=2"
}
Get all evaluations with where status is equal to 'Running'
Esempio di richiesta
GET {endpoint}/speechtotext/v3.2-preview.2/evaluations?skip=0&top=2&filter=status%20eq%20'Running'
Risposta di esempio
{
"values": [
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/evaluations/f85a328c-c866-40b3-a08d-9c0945738633",
"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.98,
"wordErrorRate1": 0.89,
"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 |
---|---|
Detailed |
DetailedErrorCode |
Entity |
EntityError |
Entity |
EntityReference |
Error |
Errore |
Error |
Codice Errore |
Evaluation |
Valutazione |
Evaluation |
EvaluationLinks |
Evaluation |
EvaluationProperties |
Inner |
InnerError |
Paginated |
ImpaginatiEvaluations |
Status |
Stato |
DetailedErrorCode
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
EntityError
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di questo errore. |
message |
string |
Messaggio per questo errore. |
EntityReference
EntityReference
Nome | Tipo | Descrizione |
---|---|---|
self |
string (uri) |
Posizione dell'entità a cui si fa riferimento. |
Error
Errore
Nome | Tipo | Descrizione |
---|---|---|
code |
Codice Errore |
|
details |
Error[] |
Ulteriori dettagli di supporto relativi all'errore e/o ai criteri previsti. |
innerError |
InnerError |
|
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
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
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 |
|
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 |
|
locale |
string minLength: 1 |
Impostazioni locali dei dati contenuti. |
model1 |
EntityReference |
|
model2 |
EntityReference |
|
project |
EntityReference |
|
properties |
EvaluationProperties |
|
self |
string (uri) |
Posizione dell'entità. |
status |
Stato |
|
transcription1 |
EntityReference |
|
transcription2 |
EntityReference |
EvaluationLinks
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
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. |
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 |
|
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
InnerError
Nome | Tipo | Descrizione |
---|---|---|
code |
DetailedErrorCode |
|
details |
object |
Ulteriori dettagli di supporto relativi all'errore e/o ai criteri previsti. |
innerError |
InnerError |
|
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. |
PaginatedEvaluations
ImpaginatiEvaluations
Nome | Tipo | Descrizione |
---|---|---|
@nextLink |
string (uri) |
Collegamento al set successivo di risultati impaginati se sono disponibili più entità; in caso contrario null. |
values |
Elenco di entità limitate dai parametri di query passati 'skip' e 'top' o dai relativi valori predefiniti. Quando si esegue l'iterazione di un elenco usando la paginazione e l'eliminazione di entità in parallelo, alcune entità verranno ignorate nei risultati. È consigliabile compilare un elenco nel client ed eliminarlo dopo il recupero dell'elenco completo. |
Status
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. |