Evaluations - Get

Referência

Serviço:: Azure AI Services

Versão da API:: 3.2

Obtém a avaliação identificada pelo ID fornecido.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
endpoint	path	True	string	Pontos de extremidade de Serviços Cognitivos suportados (protocolo e nome do host, por exemplo: https://westus.api.cognitive.microsoft.com).
id	path	True	string (uuid)	O identificador da avaliação.

Respostas

Name	Tipo	Description
200 OK	Evaluation	OK Cabeçalhos Retry-After: integer
Other Status Codes	Error	Ocorreu um erro.

Name

Tipo

Description

200 OK

Evaluation

Cabeçalhos

Retry-After: integer

Other Status Codes

Error

Ocorreu um erro.

Segurança

Ocp-Apim-Subscription-Key

Forneça a chave da sua conta de serviços cognitivos aqui.

Tipo: apiKey
Em: header

Authorization

Forneça um token de acesso do JWT retornado pelo STS desta região. Certifique-se de adicionar o escopo de gerenciamento ao token adicionando a seguinte cadeia de caracteres de consulta à URL STS: ?scope=speechservicesmanagement

Tipo: apiKey
Em: header

Exemplos

Get a evaluation

Pedido de amostra

HTTP

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

Resposta da amostra

Código de estado:: 200

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

Definições

Name	Description
DetailedErrorCode	DetailedErrorCode
EditsSummary	EdiçõesResumo
EntityError	EntityError
EntityReference	EntidadeReferência
Error	Erro
ErrorCode	Código de erro
Evaluation	Avaliação
EvaluationLinks	AvaliaçãoLinks
EvaluationProperties	AvaliaçãoPropriedades
InnerError	InnerError
Status	Situação
TokenErrorDetails	TokenErrorDetails

DetailedErrorCode

Enumeração

DetailedErrorCode

Valor	Description
DataImportFailed	Falha na importação de dados.
DeleteNotAllowed	Excluir não permitido.
DeployNotAllowed	Implantação não permitida.
DeployingFailedModel	Implantação de modelo com falha.
EmptyRequest	Pedido vazio.
EndpointCannotBeDefault	O ponto de extremidade não pode ser padrão.
EndpointNotUpdatable	Ponto final não atualizável.
EndpointWithoutLogging	Ponto de extremidade sem registro.
ExceededNumberOfRecordingsUris	Excedeu o número de gravações uris.
FailedDataset	Conjunto de dados com falha.
Forbidden	Proibido.
InUseViolation	Violação em uso.
InaccessibleCustomerStorage	Armazenamento inacessível do cliente.
InvalidAdaptationMapping	Mapeamento de adaptação inválido.
InvalidBaseModel	Modelo base inválido.
InvalidCallbackUri	Uri de retorno de chamada inválido.
InvalidChannels	Canais inválidos.
InvalidCollection	Coleção inválida.
InvalidDataset	Conjunto de dados inválido.
InvalidDocument	Documento inválido.
InvalidDocumentBatch	Lote de documentos inválido.
InvalidLocale	Localidade inválida.
InvalidLogDate	Data de registo inválida.
InvalidLogEndTime	Hora de fim de log inválida.
InvalidLogId	ID de log inválido.
InvalidLogStartTime	Hora de início de log inválida.
InvalidModel	Modelo inválido.
InvalidModelUri	Uri de modelo inválido.
InvalidParameter	Parâmetro inválido.
InvalidParameterValue	Valor de parâmetro inválido.
InvalidPayload	Carga útil inválida.
InvalidPermissions	Permissões inválidas.
InvalidPrerequisite	Pré-requisito inválido.
InvalidProductId	ID do produto inválida.
InvalidProject	Projeto inválido.
InvalidProjectKind	Tipo de projeto inválido.
InvalidRecordingsUri	Gravações inválidas uri.
InvalidRequestBodyFormat	Formato de corpo de solicitação inválido.
InvalidSasValidityDuration	Duração de validade sas inválida.
InvalidSkipTokenForLogs	Token de pulo inválido para logs.
InvalidSourceAzureResourceId	ID de recurso do Azure de origem inválida.
InvalidSubscription	Subscrição inválida.
InvalidTest	Teste inválido.
InvalidTimeToLive	Tempo de vida inválido.
InvalidTopForLogs	Parte superior inválida para logs.
InvalidTranscription	Transcrição inválida.
InvalidWebHookEventKind	Tipo de evento de gancho da Web inválido.
MissingInputRecords	Registros de entrada ausentes.
ModelCopyAuthorizationExpired	ModelCopyAuthorization expirado.
ModelDeploymentNotCompleteState	Implantação do modelo não concluída estado.
ModelDeprecated	Modelo preterido.
ModelExists	Modelo existe.
ModelMismatch	Incompatibilidade de modelos.
ModelNotDeployable	Modelo não implantável.
ModelVersionIncorrect	Versão do modelo incorreta.
NoUtf8WithBom	Não utf8 com bom.
OnlyOneOfUrlsOrContainerOrDataset	Apenas um dos urls ou contêiner ou conjunto de dados.
ProjectGenderMismatch	Desfasamento entre homens e mulheres no projeto.
QuotaViolation	Violação de quotas.
SingleDefaultEndpoint	Ponto de extremidade padrão único.
SkuLimitsExist	Existem limites de Sku.
SubscriptionNotFound	Subscrição não encontrada.
UnexpectedError	Erro inesperado.
UnsupportedClassBasedAdaptation	Adaptação baseada em classe sem suporte.
UnsupportedDelta	Delta não suportado.
UnsupportedDynamicConfiguration	Configuração dinâmica não suportada.
UnsupportedFilter	Filtro não suportado.
UnsupportedLanguageCode	Código de idioma não suportado.
UnsupportedOrderBy	Ordem não suportada por.
UnsupportedPagination	Paginação não suportada.
UnsupportedTimeRange	Intervalo de tempo não suportado.

EditsSummary

Object

EdiçõesResumo

Name	Tipo	Description
numberOfEdits	integer (int32)	O número opcional de edições para um determinado tipo de erro da transcrição reconhecida em comparação com a transcrição humana.
percentageOfAllEdits	number (double)	A percentagem opcional de edições para um determinado tipo de erro da transcrição reconhecida em comparação com a transcrição humana.

EntityError

Object

EntityError

Name	Tipo	Description
code	string	O código deste erro.
message	string	A mensagem para este erro.

EntityReference

Object

EntidadeReferência

Name	Tipo	Description
self	string (uri)	A localização da entidade referenciada.

Error

Object

Erro

Name	Tipo	Description
code	ErrorCode	Código de erro Códigos de erro de alto nível.
details	Error[]	Detalhes adicionais de suporte sobre o erro e/ou políticas esperadas.
innerError	InnerError	InnerError Novo formato de Erro Interno que está em conformidade com as Diretrizes da API de Serviços Cognitivos que está disponível em https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Isso contém as propriedades necessárias ErrorCode, mensagem e destino de propriedades opcionais, detalhes (par de valores de chave), erro interno (isso pode ser aninhado).
message	string	Mensagem de erro de alto nível.
target	string	A origem do erro. Por exemplo, seria "documentos" ou "id do documento" no caso de documento inválido.

ErrorCode

Enumeração

Código de erro

Valor	Description
Conflict	Representando o código de erro de conflito.
Forbidden	Representando o código de erro proibido.
InternalCommunicationFailed	Representando o código de erro de falha de comunicação interna.
InternalServerError	Representando o código de erro interno do servidor.
InvalidArgument	Representando o código de erro de argumento inválido.
InvalidRequest	Representando o código de erro de solicitação inválida.
NotAllowed	Representando o código de erro não permitido.
NotFound	Representando o código de erro não encontrado.
PipelineError	Representando o código de erro do pipeline.
ServiceUnavailable	Representando o código de erro indisponível do serviço.
TooManyRequests	Representando o código de erro de muitas solicitações.
Unauthorized	Representando o código de erro não autorizado.
UnprocessableEntity	Representando o código de erro de entidade não processável.
UnsupportedMediaType	Representando o código de erro de tipo de mídia não suportado.

Evaluation

Object

Avaliação

Name	Tipo	Description
createdDateTime	string (date-time)	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", ver https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
customProperties	object	As propriedades personalizadas desta 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.
dataset	EntityReference	EntidadeReferência
description	string	A descrição do objeto.
displayName	string minLength: 1	O nome para exibição do objeto.
lastActionDateTime	string (date-time)	O carimbo de data/hora quando o status atual foi inserido. O carimbo de data/hora é codificado como formato de data e hora ISO 8601 ("AAAA-MM-DDThh:mm:ssZ", ver https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
links	EvaluationLinks	AvaliaçãoLinks
locale	string minLength: 1	A localidade dos dados contidos.
model1	EntityReference	EntidadeReferência
model2	EntityReference	EntidadeReferência
project	EntityReference	EntidadeReferência
properties	EvaluationProperties	AvaliaçãoPropriedades
self	string (uri)	A localização desta entidade.
status	Status	Situação Descreva o estado atual da API.
transcription1	EntityReference	EntidadeReferência
transcription2	EntityReference	EntidadeReferência

EvaluationLinks

Object

AvaliaçãoLinks

Name	Tipo	Description
files	string (uri)	O local para obter todos os arquivos desta entidade. Consulte a operação "Evaluations_ListFiles" para obter mais detalhes.

EvaluationProperties

Object

AvaliaçãoPropriedades

Name	Tipo	Description
correctTokenCount1	integer (int32)	O número opcional de tokens reconhecidos corretamente por model1.
correctTokenCount2	integer (int32)	O número opcional de tokens reconhecidos corretamente por model2.
correctWordCount1	integer (int32)	O número de palavras corretamente reconhecidas por modelo1.
correctWordCount2	integer (int32)	O número de palavras corretamente reconhecidas por modelo2.
email	string	O endereço de e-mail para o qual enviar notificações por e-mail caso a operação seja concluída. O valor será removido após o envio bem-sucedido do e-mail.
error	EntityError	EntityError
sentenceCount1	integer (int32)	O número de sentenças processadas por modelo1.
sentenceCount2	integer (int32)	O número de sentenças processadas por modelo2.
sentenceErrorRate1	number (double)	A taxa de erro de sentença de reconhecimento com o modelo1.
sentenceErrorRate2	number (double)	A taxa de erro de sentença de reconhecimento com o modelo2.
tokenCount1	integer (int32)	Opcional o número de tokens processados por model1.
tokenCount2	integer (int32)	O número opcional de tokens processados por model2.
tokenDeletionCount1	integer (int32)	O número opcional de tokens reconhecidos por model1, que são exclusões.
tokenDeletionCount2	integer (int32)	O número opcional de tokens reconhecidos por model2, que são exclusões.
tokenErrorRate1	number (double)	A taxa de erro de token opcional de reconhecimento com model1.
tokenErrorRate2	number (double)	A taxa de erro de token opcional de reconhecimento com model2.
tokenErrors1	TokenErrorDetails	TokenErrorDetails
tokenErrors2	TokenErrorDetails	TokenErrorDetails
tokenInsertionCount1	integer (int32)	O número opcional de tokens reconhecidos por model1, que são inserções.
tokenInsertionCount2	integer (int32)	O número opcional de tokens reconhecidos por model2, que são inserções.
tokenSubstitutionCount1	integer (int32)	O número opcional de tokens reconhecidos por model1, que são substituições.
tokenSubstitutionCount2	integer (int32)	O número opcional de tokens reconhecidos por model2, que são substituições.
wordCount1	integer (int32)	O número de palavras processadas por modelo1.
wordCount2	integer (int32)	O número de palavras processadas por modelo2.
wordDeletionCount1	integer (int32)	O número de palavras reconhecidas por modelo1, que são exclusões.
wordDeletionCount2	integer (int32)	O número de palavras reconhecidas por modelo2, que são exclusões.
wordErrorRate1	number (double)	A taxa de erro de reconhecimento da palavra com o modelo1.
wordErrorRate2	number (double)	A taxa de erro de reconhecimento da palavra com model2.
wordInsertionCount1	integer (int32)	O número de palavras reconhecidas por modelo1, que são inserções.
wordInsertionCount2	integer (int32)	O número de palavras reconhecidas por modelo2, que são inserções.
wordSubstitutionCount1	integer (int32)	O número de palavras reconhecidas por modelo1, que são substituições.
wordSubstitutionCount2	integer (int32)	O número de palavras reconhecidas por modelo2, que são substituições.

InnerError

Object

InnerError

Name	Tipo	Description
code	DetailedErrorCode	DetailedErrorCode Código de erro detalhado enum.
details	object	Detalhes adicionais de suporte sobre o erro e/ou políticas esperadas.
innerError	InnerError	InnerError Novo formato de Erro Interno que está em conformidade com as Diretrizes da API de Serviços Cognitivos que está disponível em https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Isso contém as propriedades necessárias ErrorCode, mensagem e destino de propriedades opcionais, detalhes (par de valores de chave), erro interno (isso pode ser aninhado).
message	string	Mensagem de erro de alto nível.
target	string	A origem do erro. Por exemplo, seria "documentos" ou "id do documento" no caso de documento inválido.

Status

Enumeração

Situação

Valor	Description
Failed	A operação de longa duração falhou.
NotStarted	A operação de longa duração ainda não começou.
Running	A operação de longa duração está atualmente em processamento.
Succeeded	A operação de longa duração foi concluída com êxito.

TokenErrorDetails

Object

TokenErrorDetails

Name	Tipo	Description
capitalization	EditsSummary	EdiçõesResumo
inverseTextNormalization	EditsSummary	EdiçõesResumo
lexical	EditsSummary	EdiçõesResumo
others	EditsSummary	EdiçõesResumo
punctuation	EditsSummary	EdiçõesResumo

Partilhar via

Evaluations - Get

Parâmetros do URI

Respostas

Segurança

Ocp-Apim-Subscription-Key

Authorization

Exemplos

Get a evaluation

Pedido de amostra

Resposta da amostra

Definições

DetailedErrorCode

EditsSummary

EntityError

EntityReference

Error

ErrorCode

Evaluation

EvaluationLinks

EvaluationProperties

InnerError

Status

TokenErrorDetails

Recursos adicionais