Evaluations - Create

Referenz

Dienst:: Azure AI Services

API-Version:: v3.2-preview.2

Erstellt eine neue Auswertung.

POST {endpoint}/speechtotext/v3.2-preview.2/evaluations

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string	Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://westus.api.cognitive.microsoft.com).

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
dataset	True	EntityReference	EntityReference
displayName	True	string minLength: 1	Der Anzeigename des Objekts.
locale	True	string minLength: 1	Das Gebietsschema der enthaltenen Daten.
model1	True	EntityReference	EntityReference
model2	True	EntityReference	EntityReference
customProperties		object	Die benutzerdefinierten Eigenschaften dieser Entität. Die maximal zulässige Schlüssellänge beträgt 64 Zeichen, die maximal zulässige Wertlänge beträgt 256 Zeichen und die Anzahl zulässiger Einträge beträgt 10.
description		string	Die Beschreibung des Objekts.
project		EntityReference	EntityReference
transcription1		EntityReference	EntityReference
transcription2		EntityReference	EntityReference

Antworten

Name	Typ	Beschreibung
201 Created	Evaluation	Die Antwort enthält Informationen zur Entität als Nutzlast und deren Position als Header. Header Location: string
Other Status Codes	Error	Ein Fehler ist aufgetreten.

Name

Typ

Beschreibung

201 Created

Evaluation

Die Antwort enthält Informationen zur Entität als Nutzlast und deren Position als Header.

Header

Location: string

Other Status Codes

Error

Ein Fehler ist aufgetreten.

Sicherheit

Ocp-Apim-Subscription-Key

Stellen Sie hier Ihren kognitiven Leistungskontoschlüssel bereit.

Typ: apiKey
In: header

Authorization

Stellen Sie ein Zugriffstoken von JWT bereit, das vom STS dieser Region zurückgegeben wird. Stellen Sie sicher, dass Sie dem Token den Verwaltungsbereich hinzufügen, indem Sie der STS-URL die folgende Abfragezeichenfolge hinzufügen: ?scope=speechservicesmanagement

Typ: apiKey
In: header

Beispiele

Create a evaluation

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:: 201

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

Definitionen

Name	Beschreibung
DetailedErrorCode	DetailedErrorCode
EntityError	EntityError
EntityReference	EntityReference
Error	Fehler
ErrorCode	Fehlercode
Evaluation	Auswertung
EvaluationLinks	EvaluationLinks
EvaluationProperties	EvaluationProperties
InnerError	InnerError
Status	Status

DetailedErrorCode

Enumeration

DetailedErrorCode

Wert	Beschreibung
DataImportFailed	Fehler beim Datenimport.
DeleteNotAllowed	Löschen nicht zulässig.
DeployNotAllowed	Bereitstellen nicht zulässig.
DeployingFailedModel	Fehler beim Bereitstellen des Modells.
EmptyRequest	Leere Anforderung.
EndpointCannotBeDefault	Der Endpunkt kann nicht standardmäßig sein.
EndpointNotUpdatable	Endpunkt nicht aktualisierbar.
EndpointWithoutLogging	Endpunkt ohne Protokollierung.
ExceededNumberOfRecordingsUris	Die Anzahl der Aufzeichnungs-URIs wurde überschritten.
FailedDataset	Fehler beim Dataset.
Forbidden	Verboten.
InUseViolation	Verletzung des Einsatzes.
InaccessibleCustomerStorage	Nicht zugänglicher Kundenspeicher.
InvalidAdaptationMapping	Ungültige Anpassungszuordnung.
InvalidBaseModel	Ungültiges Basismodell.
InvalidCallbackUri	Ungültiger Rückruf-URI.
InvalidCollection	Ungültige Auflistung.
InvalidDataset	Ungültiges Dataset.
InvalidDocument	Ungültiges Dokument.
InvalidDocumentBatch	Ungültiger Dokumentbatch.
InvalidLocale	Ungültiges Gebietsschema.
InvalidLogDate	Ungültiges Protokolldatum.
InvalidLogEndTime	Ungültige Protokollendzeit.
InvalidLogId	Ungültige Protokoll-ID.
InvalidLogStartTime	Ungültige Startzeit des Protokolls.
InvalidModel	Ungültiges Modell.
InvalidModelUri	Ungültiger Modell-URI.
InvalidParameter	Ungültiger Parameter.
InvalidParameterValue	Ungültiger Parameterwert.
InvalidPayload	Ungültige Nutzlast.
InvalidPermissions	Ungültige Berechtigungen.
InvalidPrerequisite	Ungültige Voraussetzung.
InvalidProductId	Ungültige Produkt-ID.
InvalidProject	Ungültiges Projekt.
InvalidProjectKind	Ungültige Projektart.
InvalidRecordingsUri	Ungültiger Aufzeichnungs-URI.
InvalidRequestBodyFormat	Ungültiges Anforderungstextformat.
InvalidSasValidityDuration	Ungültige Gültigkeitsdauer für sas.
InvalidSkipTokenForLogs	Ungültiges Skip-Token für Protokolle.
InvalidSourceAzureResourceId	Ungültige Azure-Quellressourcen-ID.
InvalidSubscription	Ungültiges Abonnement.
InvalidTest	Ungültiger Test.
InvalidTimeToLive	Ungültige Zeit für live.
InvalidTopForLogs	Ungültiger Anfang für Protokolle.
InvalidTranscription	Ungültige Transkription.
InvalidWebHookEventKind	Ungültiger Web hook-Ereignistyp.
MissingInputRecords	Fehlende Eingabedatensätze.
ModelCopyOperationExists	Der Modellkopievorgang ist vorhanden.
ModelDeploymentNotCompleteState	Der Status der Modellbereitstellung ist nicht abgeschlossen.
ModelDeprecated	Das Modell ist veraltet.
ModelExists	Das Modell ist vorhanden.
ModelMismatch	Modellkonflikt.
ModelNotDeployable	Das Modell kann nicht bereitgestellt werden.
ModelVersionIncorrect	Modellversion falsch.
NoUtf8WithBom	No utf8 with bom.
OnlyOneOfUrlsOrContainerOrDataset	Nur eine url oder ein Container oder Dataset.
ProjectGenderMismatch	Project gender mismatch.
QuotaViolation	Kontingentverletzung.
SingleDefaultEndpoint	Einzelner Standardendpunkt.
SkuLimitsExist	Sku-Grenzwerte sind vorhanden.
SubscriptionNotFound	Das Abonnement wurde nicht gefunden.
UnexpectedError	Unerwarteter Fehler.
UnsupportedClassBasedAdaptation	Nicht unterstützte klassenbasierte Anpassung.
UnsupportedDelta	Nicht unterstütztes Delta.
UnsupportedDynamicConfiguration	Nicht unterstützte dynamische Konfiguration.
UnsupportedFilter	Nicht unterstützter Filter.
UnsupportedLanguageCode	Nicht unterstützter Sprachcode.
UnsupportedOrderBy	Nicht unterstützte Reihenfolge nach.
UnsupportedPagination	Nicht unterstützte Paginierung.
UnsupportedTimeRange	Nicht unterstützter Zeitraum.

EntityError

Objekt

EntityError

Name	Typ	Beschreibung
code	string	Der Code dieses Fehlers.
message	string	Die Meldung für diesen Fehler.

EntityReference

Objekt

EntityReference

Name	Typ	Beschreibung
self	string (uri)	Der Speicherort der Entität, auf die verwiesen wird.

Error

Objekt

Fehler

Name	Typ	Beschreibung
code	ErrorCode	Fehlercode Fehlercodes auf hoher Ebene.
details	Error[]	Zusätzliche unterstützende Details zu den Fehler- und/oder erwarteten Richtlinien.
innerError	InnerError	InnerError Neues inneres Fehlerformat, das den Cognitive Services-API-Richtlinien entspricht, die unter https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owverfügbar sind. Dies enthält die erforderlichen Eigenschaften ErrorCode, Meldung und optionale Eigenschaftenziel, Details(Schlüsselwertpaar), inneren Fehler(dies kann geschachtelt werden).
message	string	Fehlermeldung auf hoher Ebene.
target	string	Die Quelle des Fehlers. Bei ungültigen Dokumenten wäre es z. B. "Dokumente" oder "Dokument-ID".

ErrorCode

Enumeration

Fehlercode

Wert	Beschreibung
Conflict	Stellt den Konfliktfehlercode dar.
Forbidden	Stellt den verbotenen Fehlercode dar.
InternalCommunicationFailed	Fehlercode für die interne Kommunikation.
InternalServerError	Stellt den internen Fehlercode des Servers dar.
InvalidArgument	Stellt den fehlercode für ungültiges Argument dar.
InvalidRequest	Stellt den ungültigen Anforderungsfehlercode dar.
NotAllowed	Stellt den nicht zulässigen Fehlercode dar.
NotFound	Stellt den nicht gefundenen Fehlercode dar.
PipelineError	Stellt den Pipelinefehlerfehlercode dar.
ServiceUnavailable	Stellt den dienst nicht verfügbaren Fehlercode dar.
TooManyRequests	Stellt den Fehlercode für zu viele Anforderungen dar.
Unauthorized	Stellt den nicht autorisierten Fehlercode dar.
UnprocessableEntity	Stellt den nicht verarbeiteten Entitätsfehlercode dar.
UnsupportedMediaType	Stellt den Fehlercode für den nicht unterstützten Medientyp dar.

Evaluation

Objekt

Auswertung

Name	Typ	Beschreibung
createdDateTime	string (date-time)	Der Zeitstempel, zu dem das Objekt erstellt wurde. Der Zeitstempel wird als ISO 8601-Datums- und Uhrzeitformat codiert ("JJJJ-MM-DDThh:mm:ssZ", siehe https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
customProperties	object	Die benutzerdefinierten Eigenschaften dieser Entität. Die maximal zulässige Schlüssellänge beträgt 64 Zeichen, die maximal zulässige Wertlänge beträgt 256 Zeichen und die Anzahl zulässiger Einträge beträgt 10.
dataset	EntityReference	EntityReference
description	string	Die Beschreibung des Objekts.
displayName	string minLength: 1	Der Anzeigename des Objekts.
lastActionDateTime	string (date-time)	Der Zeitstempel, zu dem der aktuelle Status eingegeben wurde. Der Zeitstempel wird als ISO 8601-Datums- und Uhrzeitformat codiert ("JJJJ-MM-DDThh:mm:ssZ", siehe https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
links	EvaluationLinks	EvaluationLinks
locale	string minLength: 1	Das Gebietsschema der enthaltenen Daten.
model1	EntityReference	EntityReference
model2	EntityReference	EntityReference
project	EntityReference	EntityReference
properties	EvaluationProperties	EvaluationProperties
self	string (uri)	Der Speicherort dieser Entität.
status	Status	Status Beschreiben des aktuellen Status der API
transcription1	EntityReference	EntityReference
transcription2	EntityReference	EntityReference

EvaluationLinks

Objekt

EvaluationLinks

Name	Typ	Beschreibung
files	string (uri)	Der Speicherort zum Abrufen aller Dateien dieser Entität. Weitere Informationen finden Sie unter Operation "Evaluations_ListFiles".

EvaluationProperties

Objekt

EvaluationProperties

Name	Typ	Beschreibung
correctTokenCount1	integer (int32)	Die Anzahl der ordnungsgemäß erkannten Token nach Model1.
correctTokenCount2	integer (int32)	Die Anzahl der ordnungsgemäß erkannten Token nach Model2.
correctWordCount1	integer (int32)	Die Anzahl der ordnungsgemäß erkannten Wörter nach Model1.
correctWordCount2	integer (int32)	Die Anzahl der ordnungsgemäß erkannten Wörter nach Model2.
email	string	Die E-Mail-Adresse, an die E-Mail-Benachrichtigungen gesendet werden sollen, falls der Vorgang abgeschlossen ist. Der Wert wird nach dem erfolgreichen Senden der E-Mail entfernt.
error	EntityError	EntityError
sentenceCount1	integer (int32)	Die Anzahl der verarbeiteten Sätze nach Model1.
sentenceCount2	integer (int32)	Die Anzahl der verarbeiteten Sätze nach Model2.
sentenceErrorRate1	number (double)	Die Satzfehlerrate der Erkennung mit Model1.
sentenceErrorRate2	number (double)	Die Satzfehlerrate der Erkennung mit Model2.
tokenCount1	integer (int32)	Die Anzahl der verarbeiteten Token nach Model1.
tokenCount2	integer (int32)	Die Anzahl der verarbeiteten Token nach Model2.
tokenDeletionCount1	integer (int32)	Die Anzahl der erkannten Token nach Model1, die Löschvorgänge sind.
tokenDeletionCount2	integer (int32)	Die Anzahl der erkannten Token nach Model2, die Löschvorgänge sind.
tokenErrorRate1	number (double)	Die Tokenfehlerrate der Erkennung mit Model1.
tokenErrorRate2	number (double)	Die Tokenfehlerrate der Erkennung mit Model2.
tokenInsertionCount1	integer (int32)	Die Anzahl der erkannten Token nach Model1, die Einfügungen sind.
tokenInsertionCount2	integer (int32)	Die Anzahl der erkannten Token nach Model2, die Einfügungen sind.
tokenSubstitutionCount1	integer (int32)	Die Anzahl der erkannten Token nach Model1, die Ersetzungen sind.
tokenSubstitutionCount2	integer (int32)	Die Anzahl der erkannten Token nach Model2, die Ersetzungen sind.
wordCount1	integer (int32)	Die Anzahl der verarbeiteten Wörter nach Modell1.
wordCount2	integer (int32)	Die Anzahl der verarbeiteten Wörter nach Model2.
wordDeletionCount1	integer (int32)	Die Anzahl der erkannten Wörter nach Model1, die Löschvorgänge sind.
wordDeletionCount2	integer (int32)	Die Anzahl der erkannten Wörter nach Model2, die Löschvorgänge sind.
wordErrorRate1	number (double)	Die Wortfehlerrate der Erkennung mit Model1.
wordErrorRate2	number (double)	Die Wortfehlerrate der Erkennung mit Model2.
wordInsertionCount1	integer (int32)	Die Anzahl der erkannten Wörter nach Model1, die Einfügungen sind.
wordInsertionCount2	integer (int32)	Die Anzahl der erkannten Wörter nach Modell2, die Einfügungen sind.
wordSubstitutionCount1	integer (int32)	Die Anzahl der erkannten Wörter nach Model1, die Ersetzungen sind.
wordSubstitutionCount2	integer (int32)	Die Anzahl der erkannten Wörter nach Model2, die Ersetzungen sind.

InnerError

Objekt

InnerError

Name	Typ	Beschreibung
code	DetailedErrorCode	DetailedErrorCode Detaillierte Fehlercode-Enumeration.
details	object	Zusätzliche unterstützende Details zu den Fehler- und/oder erwarteten Richtlinien.
innerError	InnerError	InnerError Neues inneres Fehlerformat, das den Cognitive Services-API-Richtlinien entspricht, die unter https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owverfügbar sind. Dies enthält die erforderlichen Eigenschaften ErrorCode, Meldung und optionale Eigenschaftenziel, Details(Schlüsselwertpaar), inneren Fehler(dies kann geschachtelt werden).
message	string	Fehlermeldung auf hoher Ebene.
target	string	Die Quelle des Fehlers. Bei ungültigen Dokumenten wäre es z. B. "Dokumente" oder "Dokument-ID".

Status

Enumeration

Status

Wert	Beschreibung
Failed	Fehler beim vorgang mit langer Ausführung.
NotStarted	Der lange ausgeführte Vorgang wurde noch nicht gestartet.
Running	Der lange ausgeführte Vorgang wird zurzeit verarbeitet.
Succeeded	Der lange ausgeführte Vorgang wurde erfolgreich abgeschlossen.

Freigeben über

Evaluations - Create

URI-Parameter

Anforderungstext

Antworten

Sicherheit

Ocp-Apim-Subscription-Key

Authorization

Beispiele

Create a evaluation

Beispielanforderung

Beispiel für eine Antwort

Definitionen

DetailedErrorCode

EntityError

EntityReference

Error

ErrorCode

Evaluation

EvaluationLinks

EvaluationProperties

InnerError

Status

Zusätzliche Ressourcen