Dela via

Projects - List Evaluations

  • Referens
Tjänst:
Azure AI Services
API-version:
v3.2-preview.2

Hämtar listan över utvärderingar för det angivna projektet.

GET {endpoint}/speechtotext/v3.2-preview.2/projects/{id}/evaluations
Med valfria parametrar: 
GET {endpoint}/speechtotext/v3.2-preview.2/projects/{id}/evaluations?skip={skip}&top={top}&filter={filter}

URI-parametrar

Name I Obligatorisk Typ Description
endpoint
 path True

string

Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://westus.api.cognitive.microsoft.com).
id
 path True

string (uuid)

Identifieraren för projektet.
filter
 query

string

Ett filtreringsuttryck för att välja en delmängd av de tillgängliga utvärderingarna.

        - 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)

Antal datauppsättningar som ska hoppas över.
top
 query

integer (int32)

Antal datauppsättningar som ska ingå när du hoppar över.

Svar

Name Typ Description
200 OK

PaginatedEvaluations

OK

Sidhuvuden

Retry-After: integer
Other Status Codes

Error

Ett fel uppstod.

Säkerhet

Ocp-Apim-Subscription-Key

Ange din cognitive services-kontonyckel här.

Typ: apiKey
I: header

Authorization

Ange en åtkomsttoken från JWT som returneras av STS i den här regionen. Se till att lägga till hanteringsomfånget i token genom att lägga till följande frågesträng i STS-URL:en: ?scope=speechservicesmanagement

Typ: apiKey
I: header

Exempel

Get all evaluations

Exempelbegäran

GET {endpoint}/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/evaluations?skip=0&top=2

Exempelsvar

Statuskod:
200 
{
  "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"
}

Definitioner

Name Description
DetailedErrorCode

DetailedErrorCode
EntityError

EntityError
EntityReference

EntityReference
Error

Fel
ErrorCode

Felkod
Evaluation

Utvärdering
EvaluationLinks

EvaluationLinks
EvaluationProperties

EvaluationProperties
InnerError

InnerError
PaginatedEvaluations

Sidnumrerade värde
Status

Status

DetailedErrorCode

Uppräkning

DetailedErrorCode

Värde Description
DataImportFailed

Dataimporten misslyckades.
DeleteNotAllowed

Ta bort tillåts inte.
DeployNotAllowed

Distribution tillåts inte.
DeployingFailedModel

Distribution av en misslyckad modell.
EmptyRequest

Tom begäran.
EndpointCannotBeDefault

Slutpunkten kan inte vara standard.
EndpointNotUpdatable

Slutpunkten kan inte uppdateras.
EndpointWithoutLogging

Slutpunkt utan loggning.
ExceededNumberOfRecordingsUris

Överskred antalet inspelningar uris.
FailedDataset

Datauppsättningen misslyckades.
Forbidden

Förbjuden.
InUseViolation

Vid användningsöverträdelse.
InaccessibleCustomerStorage

Otillgänglig kundlagring.
InvalidAdaptationMapping

Ogiltig anpassningsmappning.
InvalidBaseModel

Ogiltig basmodell.
InvalidCallbackUri

Ogiltig återanrops-URI.
InvalidCollection

Ogiltig samling.
InvalidDataset

Ogiltig datauppsättning.
InvalidDocument

Ogiltigt dokument.
InvalidDocumentBatch

Ogiltig dokumentbatch.
InvalidLocale

Ogiltigt språk.
InvalidLogDate

Ogiltigt loggdatum.
InvalidLogEndTime

Ogiltig loggsluttid.
InvalidLogId

Ogiltigt logg-ID.
InvalidLogStartTime

Ogiltig starttid för loggen.
InvalidModel

Ogiltig modell.
InvalidModelUri

Ogiltig modell-URI.
InvalidParameter

Ogiltig parameter.
InvalidParameterValue

Ogiltigt parametervärde.
InvalidPayload

Ogiltig nyttolast.
InvalidPermissions

Ogiltiga behörigheter.
InvalidPrerequisite

Ogiltigt krav.
InvalidProductId

Ogiltigt produkt-ID.
InvalidProject

Ogiltigt projekt.
InvalidProjectKind

Ogiltig projekttyp.
InvalidRecordingsUri

Ogiltig inspelnings-URI.
InvalidRequestBodyFormat

Ogiltigt brödtextformat för begäran.
InvalidSasValidityDuration

Ogiltig varaktighet för sas-giltighet.
InvalidSkipTokenForLogs

Ogiltig hopptoken för loggar.
InvalidSourceAzureResourceId

Ogiltigt azure-källresurs-ID.
InvalidSubscription

Ogiltig prenumeration.
InvalidTest

Ogiltigt test.
InvalidTimeToLive

Ogiltig tid att leva.
InvalidTopForLogs

Ogiltig topp för loggar.
InvalidTranscription

Ogiltig transkription.
InvalidWebHookEventKind

Ogiltig typ av webbhookhändelse.
MissingInputRecords

Indataposter saknas.
ModelCopyOperationExists

Modellkopieringsåtgärden finns.
ModelDeploymentNotCompleteState

Modelldistributionen har inte slutförts.
ModelDeprecated

Modellen är inaktuell.
ModelExists

Modellen finns.
ModelMismatch

Modellmatchningsfel.
ModelNotDeployable

Modellen kan inte distribueras.
ModelVersionIncorrect

Modellversionen är felaktig.
NoUtf8WithBom

Ingen utf8 med bom.
OnlyOneOfUrlsOrContainerOrDataset

Endast en av url:erna eller containern eller datamängden.
ProjectGenderMismatch

Matchningsfel för projektkön.
QuotaViolation

Kvotöverträdelse.
SingleDefaultEndpoint

Enskild standardslutpunkt.
SkuLimitsExist

Det finns SKU-gränser.
SubscriptionNotFound

Det går inte att hitta prenumerationen.
UnexpectedError

Oväntat fel.
UnsupportedClassBasedAdaptation

Klassbaserad anpassning som inte stöds.
UnsupportedDelta

Delta stöds inte.
UnsupportedDynamicConfiguration

Dynamisk konfiguration stöds inte.
UnsupportedFilter

Filter som inte stöds.
UnsupportedLanguageCode

Språkkod som inte stöds.
UnsupportedOrderBy

Order som inte stöds av.
UnsupportedPagination

Sidnumrering stöds inte.
UnsupportedTimeRange

Tidsintervall som inte stöds.

EntityError

Objekt

EntityError

Name Typ Description
code

string

Koden för det här felet.
message

string

Meddelandet för det här felet.

EntityReference

Objekt

EntityReference

Name Typ Description
self

string (uri)

Platsen för den refererade entiteten.

Error

Objekt

Fel

Name Typ Description
code

ErrorCode

Felkod
Felkoder på hög nivå.
details

Error[]

Ytterligare stödjande information om fel och/eller förväntade principer.
innerError

InnerError

InnerError
Nytt format för inre fel som överensstämmer med Cognitive Services API Guidelines som finns på https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Detta innehåller nödvändiga egenskaper ErrorCode, meddelande och valfria egenskaper mål, information (nyckel värde par), inre fel (detta kan kapslas).
message

string

Felmeddelande på hög nivå.
target

string

Källan till felet. Det skulle till exempel vara "dokument" eller "dokument-ID" om dokumentet är ogiltigt.

ErrorCode

Uppräkning

Felkod

Värde Description
Conflict

Representerar konfliktfelkoden.
Forbidden

Representerar den otillåtna felkoden.
InternalCommunicationFailed

Det gick inte att ange felkoden för intern kommunikation.
InternalServerError

Representerar felkoden för den interna servern.
InvalidArgument

Representerar den ogiltiga argumentfelkoden.
InvalidRequest

Representerar den ogiltiga felkoden för begäran.
NotAllowed

Representerar den felkod som inte tillåts.
NotFound

Representerar felkoden som inte hittades.
PipelineError

Representerar felkoden för pipelinefel.
ServiceUnavailable

Representerar felkoden för tjänsten som inte är tillgänglig.
TooManyRequests

Representerar felkoden för för många begäranden.
Unauthorized

Representerar den obehöriga felkoden.
UnprocessableEntity

Representerar felkoden för entitetsfel som inte kan bearbetas.
UnsupportedMediaType

Representerar felkoden för medietypen som inte stöds.

Evaluation

Objekt

Utvärdering

Name Typ Description
createdDateTime

string (date-time)

Tidsstämpeln när objektet skapades. Tidsstämpeln är kodad som ISO 8601-datum- och tidsformat ("ÅÅÅÅ-MM-DDThh:mm:ssZ", se https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
customProperties

object

De anpassade egenskaperna för den här entiteten. Den maximala tillåtna nyckellängden är 64 tecken, den maximala tillåtna värdelängden är 256 tecken och antalet tillåtna poster är 10.
dataset

EntityReference

EntityReference
description

string

Beskrivningen av objektet.
displayName

string

minLength: 1

Objektets visningsnamn.
lastActionDateTime

string (date-time)

Tidsstämpeln när den aktuella statusen angavs. Tidsstämpeln är kodad som ISO 8601-datum- och tidsformat ("ÅÅÅÅ-MM-DDThh:mm:ssZ", se https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
links

EvaluationLinks

EvaluationLinks
locale

string

minLength: 1

Nationella inställningar för inneslutna data.
model1

EntityReference

EntityReference
model2

EntityReference

EntityReference
project

EntityReference

EntityReference
properties

EvaluationProperties

EvaluationProperties
self

string (uri)

Platsen för den här entiteten.
status

Status

Status
Beskriva api:ets aktuella tillstånd
transcription1

EntityReference

EntityReference
transcription2

EntityReference

EntityReference
Objekt

EvaluationLinks

Name Typ Description
files

string (uri)

Platsen där du kan hämta alla filer för den här entiteten. Mer information finns i åtgärden "Evaluations_ListFiles".

EvaluationProperties

Objekt

EvaluationProperties

Name Typ Description
correctTokenCount1

integer (int32)

Antalet korrekt identifierade token per model1.
correctTokenCount2

integer (int32)

Antalet korrekt identifierade token per model2.
correctWordCount1

integer (int32)

Antalet korrekt identifierade ord efter model1.
correctWordCount2

integer (int32)

Antalet korrekt identifierade ord efter model2.
email

string

E-postadressen som e-postaviseringar ska skickas till om åtgärden slutförs. Värdet tas bort när e-postmeddelandet har skickats.
error

EntityError

EntityError
sentenceCount1

integer (int32)

Antalet bearbetade meningar efter model1.
sentenceCount2

integer (int32)

Antalet bearbetade meningar efter model2.
sentenceErrorRate1

number (double)

Igenkänningsfrekvensen för meningsfel med model1.
sentenceErrorRate2

number (double)

Igenkänningsfrekvensen för meningsfel med model2.
tokenCount1

integer (int32)

Antalet bearbetade token per model1.
tokenCount2

integer (int32)

Antalet bearbetade token per model2.
tokenDeletionCount1

integer (int32)

Antalet identifierade token per model1, som är borttagningar.
tokenDeletionCount2

integer (int32)

Antalet identifierade token per model2, som är borttagningar.
tokenErrorRate1

number (double)

Tokenfelfrekvensen för igenkänning med model1.
tokenErrorRate2

number (double)

Tokenfelfrekvensen för igenkänning med model2.
tokenInsertionCount1

integer (int32)

Antalet identifierade token per model1, som är infogningar.
tokenInsertionCount2

integer (int32)

Antalet identifierade token per model2, som är infogningar.
tokenSubstitutionCount1

integer (int32)

Antalet identifierade token per model1, som är ersättningar.
tokenSubstitutionCount2

integer (int32)

Antalet identifierade token per model2, som är ersättningar.
wordCount1

integer (int32)

Antalet bearbetade ord efter model1.
wordCount2

integer (int32)

Antalet bearbetade ord efter model2.
wordDeletionCount1

integer (int32)

Antalet identifierade ord efter model1, som är borttagningar.
wordDeletionCount2

integer (int32)

Antalet identifierade ord per model2, som är borttagningar.
wordErrorRate1

number (double)

Ordet felfrekvens för igenkänning med model1.
wordErrorRate2

number (double)

Ordet felfrekvens för igenkänning med model2.
wordInsertionCount1

integer (int32)

Antalet identifierade ord per model1, som är infogningar.
wordInsertionCount2

integer (int32)

Antalet identifierade ord per model2, som är infogningar.
wordSubstitutionCount1

integer (int32)

Antalet identifierade ord efter model1, som är ersättningar.
wordSubstitutionCount2

integer (int32)

Antalet identifierade ord efter model2, som är ersättningar.

InnerError

Objekt

InnerError

Name Typ Description
code

DetailedErrorCode

DetailedErrorCode
Detaljerad felkodsuppräkning.
details

object

Ytterligare stödjande information om fel och/eller förväntade principer.
innerError

InnerError

InnerError
Nytt format för inre fel som överensstämmer med Cognitive Services API Guidelines som finns på https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Detta innehåller nödvändiga egenskaper ErrorCode, meddelande och valfria egenskaper mål, information (nyckel värde par), inre fel (detta kan kapslas).
message

string

Felmeddelande på hög nivå.
target

string

Källan till felet. Det skulle till exempel vara "dokument" eller "dokument-ID" om dokumentet är ogiltigt.

PaginatedEvaluations

Objekt

Sidnumrerade värde

Name Typ Description
@nextLink

string (uri)

En länk till nästa uppsättning sidnumrerade resultat om det finns fler tillgängliga entiteter. annars null.
values

Evaluation[]

En lista över entiteter som begränsas av antingen de skickade frågeparametrarna "skip" och "top" eller deras standardvärden.

När du itererar genom en lista med sidnumrering och tar bort entiteter parallellt hoppas vissa entiteter över i resultatet. Vi rekommenderar att du skapar en lista på klienten och tar bort efter hämtningen av den fullständiga listan.

Status

Uppräkning

Status

Värde Description
Failed

Den tidskrävande åtgärden misslyckades.
NotStarted

Den tidskrävande åtgärden har ännu inte startats.
Running

Den tidskrävande åtgärden bearbetas för närvarande.
Succeeded

Den tidskrävande åtgärden har slutförts.