Delen via


Evaluations - List

Hiermee wordt de lijst met evaluaties voor het geverifieerde abonnement opgehaald.

GET {endpoint}/speechtotext/v3.2-preview.2/evaluations
GET {endpoint}/speechtotext/v3.2-preview.2/evaluations?skip={skip}&top={top}&filter={filter}

URI-parameters

Name In Vereist Type Description
endpoint
path True

string

Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://westus.api.cognitive.microsoft.com).

filter
query

string

Een filterexpressie voor het selecteren van een subset van de beschikbare evaluaties.

        - Supported properties: displayName, description, createdDateTime, lastActionDateTime, status and locale.

        - Operators:

          - eq, ne are supported for all properties.

          - gt, ge, lt, le are supported for createdDateTime and lastActionDateTime.

          - and, or, not are supported.

        - Example:

          filter=displayName eq 'My evaluation'
skip
query

integer

int32

Het aantal gegevenssets dat wordt overgeslagen.

top
query

integer

int32

Het aantal gegevenssets dat wordt opgenomen na het overslaan.

Antwoorden

Name Type Description
200 OK

PaginatedEvaluations

OK

Kopteksten

Retry-After: integer

Other Status Codes

Error

Er is een fout opgetreden.

Beveiliging

Ocp-Apim-Subscription-Key

Geef hier de sleutel van uw Cognitive Services-account op.

Type: apiKey
In: header

Authorization

Geef een toegangstoken op van de JWT die wordt geretourneerd door de STS van deze regio. Zorg ervoor dat u het beheerbereik toevoegt aan het token door de volgende querytekenreeks toe te voegen aan de STS-URL: ?scope=speechservicesmanagement

Type: apiKey
In: header

Voorbeelden

Get all evaluations
Get all evaluations with where status is equal to 'Running'

Get all evaluations

Voorbeeldaanvraag

GET {endpoint}/speechtotext/v3.2-preview.2/evaluations?skip=0&top=2

Voorbeeldrespons

{
  "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'

Voorbeeldaanvraag

GET {endpoint}/speechtotext/v3.2-preview.2/evaluations?skip=0&top=2&filter=status%20eq%20'Running'

Voorbeeldrespons

{
  "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"
    }
  ]
}

Definities

Name Description
DetailedErrorCode

DetailedErrorCode

EntityError

EntityError

EntityReference

EntityReference

Error

Fout

ErrorCode

ErrorCode

Evaluation

Evaluatie

EvaluationLinks

EvaluationLinks

EvaluationProperties

EvaluatieEigenschappen

InnerError

InnerError

PaginatedEvaluations

Gepagineerde waarderingen

Status

Status

DetailedErrorCode

DetailedErrorCode

Name Type Description
DataImportFailed

string

Het importeren van gegevens is mislukt.

DeleteNotAllowed

string

Verwijderen is niet toegestaan.

DeployNotAllowed

string

Implementeren is niet toegestaan.

DeployingFailedModel

string

Het implementeren van een mislukt model.

EmptyRequest

string

Lege aanvraag.

EndpointCannotBeDefault

string

Eindpunt kan niet standaard zijn.

EndpointNotUpdatable

string

Eindpunt kan niet worden bijgewerkt.

EndpointWithoutLogging

string

Eindpunt zonder logboekregistratie.

ExceededNumberOfRecordingsUris

string

Het aantal opnamen is overschreden.

FailedDataset

string

Mislukte gegevensset.

Forbidden

string

Verboden.

InUseViolation

string

In gebruiksovertreding.

InaccessibleCustomerStorage

string

Niet-toegankelijke klantopslag.

InvalidAdaptationMapping

string

Ongeldige aanpassingstoewijzing.

InvalidBaseModel

string

Ongeldig basismodel.

InvalidCallbackUri

string

Ongeldige callback-URI.

InvalidCollection

string

Ongeldige verzameling.

InvalidDataset

string

Ongeldige gegevensset.

InvalidDocument

string

Ongeldig document.

InvalidDocumentBatch

string

Ongeldige documentbatch.

InvalidLocale

string

Ongeldige landinstelling.

InvalidLogDate

string

Ongeldige logboekdatum.

InvalidLogEndTime

string

Ongeldige eindtijd van logboek.

InvalidLogId

string

Ongeldige logboek-id.

InvalidLogStartTime

string

Ongeldige begintijd van logboek.

InvalidModel

string

Ongeldig model.

InvalidModelUri

string

Ongeldige model-URI.

InvalidParameter

string

Ongeldige parameter.

InvalidParameterValue

string

Ongeldige parameterwaarde.

InvalidPayload

string

Ongeldige nettolading.

InvalidPermissions

string

Ongeldige machtigingen.

InvalidPrerequisite

string

Ongeldige vereiste.

InvalidProductId

string

Ongeldige product-id.

InvalidProject

string

Ongeldig project.

InvalidProjectKind

string

Ongeldige projectsoort.

InvalidRecordingsUri

string

Ongeldige URI voor opnamen.

InvalidRequestBodyFormat

string

Ongeldige indeling van aanvraagbody.

InvalidSasValidityDuration

string

Ongeldige geldigheidsduur sas.

InvalidSkipTokenForLogs

string

Ongeldig token voor overslaan voor logboeken.

InvalidSourceAzureResourceId

string

Ongeldige bron-id van Azure-resource.

InvalidSubscription

string

Ongeldig abonnement.

InvalidTest

string

Ongeldige test.

InvalidTimeToLive

string

Ongeldige time to live.

InvalidTopForLogs

string

Ongeldige bovenkant voor logboeken.

InvalidTranscription

string

Ongeldige transcriptie.

InvalidWebHookEventKind

string

Ongeldig soort webhook gebeurtenis.

MissingInputRecords

string

Ontbrekende invoerrecords.

ModelCopyOperationExists

string

De kopieerbewerking van het model bestaat.

ModelDeploymentNotCompleteState

string

De status modelimplementatie is niet voltooid.

ModelDeprecated

string

Het model is afgeschaft.

ModelExists

string

Het model bestaat.

ModelMismatch

string

Model komt niet overeen.

ModelNotDeployable

string

Het model kan niet worden geïmplementeerd.

ModelVersionIncorrect

string

Modelversie onjuist.

NoUtf8WithBom

string

Geen utf8 met bom.

OnlyOneOfUrlsOrContainerOrDataset

string

Slechts één van de URL's of container of gegevensset.

ProjectGenderMismatch

string

Het geslacht van het project komt niet overeen.

QuotaViolation

string

Quotumschending.

SingleDefaultEndpoint

string

Eén standaardeindpunt.

SkuLimitsExist

string

Er bestaan SKU-limieten.

SubscriptionNotFound

string

Kan het abonnement niet vinden.

UnexpectedError

string

Onverwachte fout.

UnsupportedClassBasedAdaptation

string

Niet-ondersteunde aanpassing op basis van klassen.

UnsupportedDelta

string

Niet-ondersteunde delta.

UnsupportedDynamicConfiguration

string

Niet-ondersteunde dynamische configuratie.

UnsupportedFilter

string

Niet-ondersteund filter.

UnsupportedLanguageCode

string

Niet-ondersteunde taalcode.

UnsupportedOrderBy

string

Niet-ondersteunde bestelling door.

UnsupportedPagination

string

Niet-ondersteunde paginering.

UnsupportedTimeRange

string

Niet-ondersteund tijdsbereik.

EntityError

EntityError

Name Type Description
code

string

De code van deze fout.

message

string

Het bericht voor deze fout.

EntityReference

EntityReference

Name Type Description
self

string

De locatie van de entiteit waarnaar wordt verwezen.

Error

Fout

Name Type Description
code

ErrorCode

ErrorCode
Foutcodes op hoog niveau.

details

Error[]

Aanvullende ondersteunende informatie met betrekking tot de fout en/of het verwachte beleid.

innerError

InnerError

InnerError
Nieuwe indeling voor interne fouten die voldoet aan de API-richtlijnen voor Cognitive Services die beschikbaar zijn op https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Dit bevat de vereiste eigenschappen Foutcode, bericht en optionele eigenschappen doel, details (sleutelwaardepaar), interne fout (dit kan worden genest).

message

string

Foutbericht op hoog niveau.

target

string

De bron van de fout. Dit is bijvoorbeeld 'documenten' of 'document-id' in het geval van een ongeldig document.

ErrorCode

ErrorCode

Name Type Description
Conflict

string

Vertegenwoordigt de conflictfoutcode.

Forbidden

string

Vertegenwoordigt de verboden foutcode.

InternalCommunicationFailed

string

De foutcode voor de interne communicatie mislukt.

InternalServerError

string

Vertegenwoordigt de foutcode van de interne serverfout.

InvalidArgument

string

Vertegenwoordigt de foutcode van het ongeldige argument.

InvalidRequest

string

Vertegenwoordigt de ongeldige aanvraagfoutcode.

NotAllowed

string

Vertegenwoordigt de niet-toegestane foutcode.

NotFound

string

Vertegenwoordigt de foutcode die niet is gevonden.

PipelineError

string

Vertegenwoordigt de foutcode van de pijplijnfout.

ServiceUnavailable

string

Vertegenwoordigt de foutcode die niet beschikbaar is voor de service.

TooManyRequests

string

Vertegenwoordigt de foutcode voor te veel aanvragen.

Unauthorized

string

Vertegenwoordigt de foutcode voor onbevoegden.

UnprocessableEntity

string

Vertegenwoordigt de foutcode van de niet-verwerkbare entiteit.

UnsupportedMediaType

string

Vertegenwoordigt de foutcode van het niet-ondersteunde mediatype.

Evaluation

Evaluatie

Name Type Description
createdDateTime

string

De tijdstempel waarop het object is gemaakt. De tijdstempel is gecodeerd als ISO 8601-datum- en tijdnotatie ('JJJJ-MM-DDThh:mm:ssZ', zie https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

customProperties

object

De aangepaste eigenschappen van deze entiteit. De maximaal toegestane sleutellengte is 64 tekens, de maximaal toegestane waardelengte is 256 tekens en het aantal toegestane vermeldingen is 10.

dataset

EntityReference

EntityReference

description

string

De beschrijving van het object.

displayName

string

De weergavenaam van het object.

lastActionDateTime

string

Het tijdstempel waarop de huidige status is ingevoerd. De tijdstempel is gecodeerd als ISO 8601-datum- en tijdnotatie ('JJJJ-MM-DDThh:mm:ssZ', zie https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

links

EvaluationLinks

EvaluationLinks

locale

string

De landinstelling van de opgenomen gegevens.

model1

EntityReference

EntityReference

model2

EntityReference

EntityReference

project

EntityReference

EntityReference

properties

EvaluationProperties

EvaluatieEigenschappen

self

string

De locatie van deze entiteit.

status

Status

Status
De huidige status van de API beschrijven

transcription1

EntityReference

EntityReference

transcription2

EntityReference

EntityReference

EvaluationLinks

Name Type Description
files

string

De locatie voor het ophalen van alle bestanden van deze entiteit. Zie bewerking 'Evaluations_ListFiles' voor meer informatie.

EvaluationProperties

EvaluatieEigenschappen

Name Type Description
correctTokenCount1

integer

Het aantal correct herkende tokens door model1.

correctTokenCount2

integer

Het aantal correct herkende tokens per model2.

correctWordCount1

integer

Het aantal correct herkende woorden door model1.

correctWordCount2

integer

Het aantal correct herkende woorden per model2.

email

string

Het e-mailadres waarnaar u e-mailmeldingen wilt verzenden voor het geval de bewerking is voltooid. De waarde wordt verwijderd nadat het e-mailbericht is verzonden.

error

EntityError

EntityError

sentenceCount1

integer

Het aantal verwerkte zinnen per model1.

sentenceCount2

integer

Het aantal verwerkte zinnen per model2.

sentenceErrorRate1

number

Het foutpercentage van herkenning van zinnen met model1.

sentenceErrorRate2

number

Het foutpercentage van de zin bij herkenning met model2.

tokenCount1

integer

Het aantal verwerkte tokens per model1.

tokenCount2

integer

Het aantal verwerkte tokens per model2.

tokenDeletionCount1

integer

Het aantal herkende tokens per model1, dat verwijderingen zijn.

tokenDeletionCount2

integer

Het aantal herkende tokens per model2, dat verwijderingen zijn.

tokenErrorRate1

number

Het tokenfoutpercentage van herkenning met model1.

tokenErrorRate2

number

Het tokenfoutpercentage van herkenning met model2.

tokenInsertionCount1

integer

Het aantal herkende tokens per model1, dat invoegingen zijn.

tokenInsertionCount2

integer

Het aantal herkende tokens per model2, dat invoegingen zijn.

tokenSubstitutionCount1

integer

Het aantal herkende tokens door model1, dat vervangingen zijn.

tokenSubstitutionCount2

integer

Het aantal herkende tokens per model2, dat vervangingen zijn.

wordCount1

integer

Het aantal verwerkte woorden per model1.

wordCount2

integer

Het aantal verwerkte woorden per model2.

wordDeletionCount1

integer

Het aantal herkende woorden door model1, dat verwijderingen zijn.

wordDeletionCount2

integer

Het aantal herkende woorden per model2, dat verwijderingen zijn.

wordErrorRate1

number

Het foutpercentage van het woord herkenning met model1.

wordErrorRate2

number

Het foutpercentage van herkenning met model2.

wordInsertionCount1

integer

Het aantal herkende woorden door model1, dat invoegingen zijn.

wordInsertionCount2

integer

Het aantal herkende woorden door model2, dat invoegingen zijn.

wordSubstitutionCount1

integer

Het aantal herkende woorden door model1, dat vervangingen zijn.

wordSubstitutionCount2

integer

Het aantal herkende woorden door model2, dat vervangingen zijn.

InnerError

InnerError

Name Type Description
code

DetailedErrorCode

DetailedErrorCode
Gedetailleerde foutcode- enum.

details

object

Aanvullende ondersteunende informatie met betrekking tot de fout en/of het verwachte beleid.

innerError

InnerError

InnerError
Nieuwe indeling voor interne fouten die voldoet aan de API-richtlijnen voor Cognitive Services die beschikbaar zijn op https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Dit bevat de vereiste eigenschappen Foutcode, bericht en optionele eigenschappen doel, details (sleutelwaardepaar), interne fout (dit kan worden genest).

message

string

Foutbericht op hoog niveau.

target

string

De bron van de fout. Dit is bijvoorbeeld 'documenten' of 'document-id' in het geval van een ongeldig document.

PaginatedEvaluations

Gepagineerde waarderingen

Name Type Description
@nextLink

string

Een koppeling naar de volgende set gepagineerde resultaten als er meer entiteiten beschikbaar zijn; anders null.

values

Evaluation[]

Een lijst met entiteiten die beperkt zijn door de doorgegeven queryparameters 'skip' en 'top' of hun standaardwaarden.

Wanneer u een lijst doorloopt met behulp van paginering en het parallel verwijderen van entiteiten, worden sommige entiteiten overgeslagen in de resultaten. Het wordt aanbevolen om een lijst op de client te maken en te verwijderen nadat de volledige lijst is opgehaald.

Status

Status

Name Type Description
Failed

string

De langdurige bewerking is mislukt.

NotStarted

string

De langdurige bewerking is nog niet gestart.

Running

string

De langdurige bewerking wordt momenteel verwerkt.

Succeeded

string

De langdurige bewerking is voltooid.