Evaluations - Create
Cria uma avaliação.
POST {endpoint}/speechtotext/v3.2-preview.2/evaluations
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
endpoint
|
path | True |
string |
Pontos de extremidade dos Serviços Cognitivos com suporte (protocolo e nome do host, por exemplo: https://westus.api.cognitive.microsoft.com). |
Corpo da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
dataset | True |
EntityReference |
|
displayName | True |
string |
O nome para exibição do objeto. |
locale | True |
string |
A localidade dos dados contidos. |
model1 | True |
EntityReference |
|
model2 | True |
EntityReference |
|
customProperties |
object |
As propriedades personalizadas dessa entidade. O comprimento máximo permitido da chave é de 64 caracteres, o comprimento máximo do valor permitido é de 256 caracteres e a contagem de entradas permitidas é de 10. |
|
description |
string |
A descrição do objeto . |
|
project |
EntityReference |
||
transcription1 |
EntityReference |
||
transcription2 |
EntityReference |
Respostas
Nome | Tipo | Description |
---|---|---|
201 Created |
A resposta contém informações sobre a entidade como conteúdo e sua localização como cabeçalho. Cabeçalhos Location: string |
|
Other Status Codes |
Ocorreu um erro. |
Segurança
Ocp-Apim-Subscription-Key
Forneça sua chave de conta de serviços cognitivos aqui.
Tipo:
apiKey
Em:
header
Authorization
Forneça um token de acesso do JWT retornado pelo STS dessa região. Adicione o escopo de gerenciamento ao token adicionando a seguinte cadeia de caracteres de consulta à URL do STS: ?scope=speechservicesmanagement
Tipo:
apiKey
Em:
header
Exemplos
Create a evaluation
Solicitação de exemplo
POST {endpoint}/speechtotext/v3.2-preview.2/evaluations
{
"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"
},
"locale": "en-US",
"displayName": "My new evaluation",
"description": "The description of the evaluation"
}
Resposta de exemplo
Location: https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/evaluations/1c50ce42-6ab7-454f-8c39-54a752d1a5b6
{
"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"
}
Definições
Nome | Description |
---|---|
Detailed |
DetailedErrorCode |
Entity |
EntityError |
Entity |
EntityReference |
Error |
Erro |
Error |
ErrorCode |
Evaluation |
Avaliação |
Evaluation |
EvaluationLinks |
Evaluation |
EvaluationProperties |
Inner |
InnerError |
Status |
Status |
DetailedErrorCode
DetailedErrorCode
Nome | Tipo | Description |
---|---|---|
DataImportFailed |
string |
Falha na importação de dados. |
DeleteNotAllowed |
string |
Excluir não é permitido. |
DeployNotAllowed |
string |
Implantação não permitida. |
DeployingFailedModel |
string |
Implantação de modelo com falha. |
EmptyRequest |
string |
Solicitação vazia. |
EndpointCannotBeDefault |
string |
O ponto de extremidade não pode ser padrão. |
EndpointNotUpdatable |
string |
Ponto de extremidade não atualizável. |
EndpointWithoutLogging |
string |
Ponto de extremidade sem registro em log. |
ExceededNumberOfRecordingsUris |
string |
Número excedido de uris de gravações. |
FailedDataset |
string |
Conjunto de dados com falha. |
Forbidden |
string |
Negado. |
InUseViolation |
string |
Violação de uso. |
InaccessibleCustomerStorage |
string |
Armazenamento inacessível do cliente. |
InvalidAdaptationMapping |
string |
Mapeamento de adaptação inválido. |
InvalidBaseModel |
string |
Modelo base inválido. |
InvalidCallbackUri |
string |
URI de retorno de chamada inválido. |
InvalidCollection |
string |
Coleção inválida. |
InvalidDataset |
string |
Conjunto de dados inválido. |
InvalidDocument |
string |
Documento inválido. |
InvalidDocumentBatch |
string |
Lote de Documentos inválido. |
InvalidLocale |
string |
Localidade inválida. |
InvalidLogDate |
string |
Data de log inválida. |
InvalidLogEndTime |
string |
Hora de término do log inválida. |
InvalidLogId |
string |
ID de log inválida. |
InvalidLogStartTime |
string |
Hora de início do log inválida. |
InvalidModel |
string |
Modelo inválido. |
InvalidModelUri |
string |
URI de modelo inválido. |
InvalidParameter |
string |
Parâmetro inválido. |
InvalidParameterValue |
string |
Valor de parâmetro inválido. |
InvalidPayload |
string |
Conteúdo inválido. |
InvalidPermissions |
string |
Permissões inválidas. |
InvalidPrerequisite |
string |
Pré-requisito inválido. |
InvalidProductId |
string |
ID do produto inválida. |
InvalidProject |
string |
Projeto inválido. |
InvalidProjectKind |
string |
Tipo de projeto inválido. |
InvalidRecordingsUri |
string |
URI de gravações inválidas. |
InvalidRequestBodyFormat |
string |
Formato do corpo da solicitação inválido. |
InvalidSasValidityDuration |
string |
Duração de validade sas inválida. |
InvalidSkipTokenForLogs |
string |
Token de ignorar inválido para logs. |
InvalidSourceAzureResourceId |
string |
ID de recurso do Azure de origem inválida. |
InvalidSubscription |
string |
Assinatura inválida. |
InvalidTest |
string |
Teste inválido. |
InvalidTimeToLive |
string |
Tempo de vida inválido. |
InvalidTopForLogs |
string |
Parte superior inválida para logs. |
InvalidTranscription |
string |
Transcrição inválida. |
InvalidWebHookEventKind |
string |
Tipo de evento de gancho da Web inválido. |
MissingInputRecords |
string |
Registros de entrada ausentes. |
ModelCopyOperationExists |
string |
A operação de cópia de modelo existe. |
ModelDeploymentNotCompleteState |
string |
O estado de implantação do modelo não é concluído. |
ModelDeprecated |
string |
Modelo preterido. |
ModelExists |
string |
O modelo existe. |
ModelMismatch |
string |
Incompatibilidade de modelo. |
ModelNotDeployable |
string |
Modelo não implantável. |
ModelVersionIncorrect |
string |
Versão do modelo incorreta. |
NoUtf8WithBom |
string |
Não utf8 com bom. |
OnlyOneOfUrlsOrContainerOrDataset |
string |
Apenas uma das URLs, contêiner ou conjunto de dados. |
ProjectGenderMismatch |
string |
Incompatibilidade de gênero do projeto. |
QuotaViolation |
string |
Violação de cota. |
SingleDefaultEndpoint |
string |
Ponto de extremidade padrão único. |
SkuLimitsExist |
string |
Existem limites de SKU. |
SubscriptionNotFound |
string |
Assinatura não encontrada. |
UnexpectedError |
string |
Erro inesperado. |
UnsupportedClassBasedAdaptation |
string |
Adaptação baseada em classe sem suporte. |
UnsupportedDelta |
string |
Delta sem suporte. |
UnsupportedDynamicConfiguration |
string |
Configuração dinâmica sem suporte. |
UnsupportedFilter |
string |
Filtro sem suporte. |
UnsupportedLanguageCode |
string |
Código de linguagem sem suporte. |
UnsupportedOrderBy |
string |
Ordem sem suporte por. |
UnsupportedPagination |
string |
Paginação sem suporte. |
UnsupportedTimeRange |
string |
Intervalo de tempo sem suporte. |
EntityError
EntityError
Nome | Tipo | Description |
---|---|---|
code |
string |
O código desse erro. |
message |
string |
A mensagem para esse erro. |
EntityReference
EntityReference
Nome | Tipo | Description |
---|---|---|
self |
string |
O local da entidade referenciada. |
Error
Erro
Nome | Tipo | Description |
---|---|---|
code |
ErrorCode |
|
details |
Error[] |
Detalhes adicionais de suporte sobre o erro e/ou as políticas esperadas. |
innerError |
InnerError |
|
message |
string |
Mensagem de erro de alto nível. |
target |
string |
A origem do erro. Por exemplo, seria "documents" ou "document id" no caso de um documento inválido. |
ErrorCode
ErrorCode
Nome | Tipo | Description |
---|---|---|
Conflict |
string |
Representando o código de erro de conflito. |
Forbidden |
string |
Representando o código de erro proibido. |
InternalCommunicationFailed |
string |
Representando o código de erro de falha de comunicação interna. |
InternalServerError |
string |
Representando o código de erro interno do servidor. |
InvalidArgument |
string |
Representando o código de erro de argumento inválido. |
InvalidRequest |
string |
Representando o código de erro de solicitação inválido. |
NotAllowed |
string |
Representando o código de erro não permitido. |
NotFound |
string |
Representando o código de erro não encontrado. |
PipelineError |
string |
Representando o código de erro do pipeline. |
ServiceUnavailable |
string |
Representando o código de erro de serviço indisponível. |
TooManyRequests |
string |
Representando o código de erro de muitas solicitações. |
Unauthorized |
string |
Representando o código de erro não autorizado. |
UnprocessableEntity |
string |
Representando o código de erro de entidade não processável. |
UnsupportedMediaType |
string |
Representando o código de erro de tipo de mídia sem suporte. |
Evaluation
Avaliação
Nome | Tipo | Description |
---|---|---|
createdDateTime |
string |
O carimbo de data/hora quando o objeto foi criado. O carimbo de data/hora é codificado como formato de data e hora ISO 8601 ("AAAA-MM-DDThh:mm:ssZ", consulte https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations). |
customProperties |
object |
As propriedades personalizadas dessa entidade. O comprimento máximo permitido da chave é de 64 caracteres, o comprimento máximo de valor permitido é de 256 caracteres e a contagem de entradas permitidas é 10. |
dataset |
EntityReference |
|
description |
string |
A descrição do objeto . |
displayName |
string |
O nome para exibição do objeto. |
lastActionDateTime |
string |
O carimbo de data/hora em que o status atual foi inserido. O carimbo de data/hora é codificado como formato de data e hora ISO 8601 ("AAAA-MM-DDThh:mm:ssZ", consulte https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations). |
links |
EvaluationLinks |
|
locale |
string |
A localidade dos dados contidos. |
model1 |
EntityReference |
|
model2 |
EntityReference |
|
project |
EntityReference |
|
properties |
EvaluationProperties |
|
self |
string |
O local dessa entidade. |
status |
Status |
|
transcription1 |
EntityReference |
|
transcription2 |
EntityReference |
EvaluationLinks
EvaluationLinks
Nome | Tipo | Description |
---|---|---|
files |
string |
O local para obter todos os arquivos dessa entidade. Confira a operação "Evaluations_ListFiles" para obter mais detalhes. |
EvaluationProperties
EvaluationProperties
Nome | Tipo | Description |
---|---|---|
correctTokenCount1 |
integer |
O número de tokens reconhecidos corretamente por model1. |
correctTokenCount2 |
integer |
O número de tokens reconhecidos corretamente por model2. |
correctWordCount1 |
integer |
O número de palavras reconhecidas corretamente por model1. |
correctWordCount2 |
integer |
O número de palavras reconhecidas corretamente pelo model2. |
string |
O endereço de email para o qual enviar notificações por email caso a operação seja concluída. O valor será removido depois de enviar o email com êxito. |
|
error |
EntityError |
|
sentenceCount1 |
integer |
O número de frases processadas por model1. |
sentenceCount2 |
integer |
O número de frases processadas por model2. |
sentenceErrorRate1 |
number |
A taxa de erro de sentença de reconhecimento com model1. |
sentenceErrorRate2 |
number |
A taxa de erro de frase de reconhecimento com model2. |
tokenCount1 |
integer |
O número de tokens processados por model1. |
tokenCount2 |
integer |
O número de tokens processados por model2. |
tokenDeletionCount1 |
integer |
O número de tokens reconhecidos por model1, que são exclusões. |
tokenDeletionCount2 |
integer |
O número de tokens reconhecidos por model2, que são exclusões. |
tokenErrorRate1 |
number |
A taxa de erro de token de reconhecimento com model1. |
tokenErrorRate2 |
number |
A taxa de erro de token de reconhecimento com model2. |
tokenInsertionCount1 |
integer |
O número de tokens reconhecidos por model1, que são inserções. |
tokenInsertionCount2 |
integer |
O número de tokens reconhecidos por model2, que são inserções. |
tokenSubstitutionCount1 |
integer |
O número de tokens reconhecidos por model1, que são substituições. |
tokenSubstitutionCount2 |
integer |
O número de tokens reconhecidos por model2, que são substituições. |
wordCount1 |
integer |
O número de palavras processadas por model1. |
wordCount2 |
integer |
O número de palavras processadas por model2. |
wordDeletionCount1 |
integer |
O número de palavras reconhecidas por model1, que são exclusões. |
wordDeletionCount2 |
integer |
O número de palavras reconhecidas por model2, que são exclusões. |
wordErrorRate1 |
number |
A palavra taxa de erro de reconhecimento com model1. |
wordErrorRate2 |
number |
A palavra taxa de erros de reconhecimento com model2. |
wordInsertionCount1 |
integer |
O número de palavras reconhecidas por model1, que são inserções. |
wordInsertionCount2 |
integer |
O número de palavras reconhecidas por model2, que são inserções. |
wordSubstitutionCount1 |
integer |
O número de palavras reconhecidas por model1, que são substituições. |
wordSubstitutionCount2 |
integer |
O número de palavras reconhecidas por model2, que são substituições. |
InnerError
InnerError
Nome | Tipo | Description |
---|---|---|
code |
DetailedErrorCode |
|
details |
object |
Detalhes adicionais de suporte sobre o erro e/ou as políticas esperadas. |
innerError |
InnerError |
|
message |
string |
Mensagem de erro de alto nível. |
target |
string |
A origem do erro. Por exemplo, seria "documents" ou "document id" no caso de um documento inválido. |
Status
Status
Nome | Tipo | Description |
---|---|---|
Failed |
string |
A operação de execução prolongada falhou. |
NotStarted |
string |
A operação de execução prolongada ainda não foi iniciada. |
Running |
string |
A operação de execução prolongada está sendo processada no momento. |
Succeeded |
string |
A operação de execução prolongada foi concluída com êxito. |