Evaluations - Update

Layanan:: Azure AI Services

Versi API:: v3.2-preview.2

Memperbarui detail evaluasi yang dapat diubah yang diidentifikasi oleh id-nya.

PATCH {endpoint}/speechtotext/v3.2-preview.2/evaluations/{id}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
endpoint	path	True	string	Titik akhir Cognitive Services yang didukung (protokol dan nama host, misalnya: https://westus.api.cognitive.microsoft.com).
id	path	True	string (uuid)	Pengidentifikasi evaluasi.

Isi Permintaan

Media Types: "application/json", "application/merge-patch+json"

Nama	Jenis	Deskripsi
customProperties	object	Properti kustom entitas ini. Panjang kunci maksimum yang diizinkan adalah 64 karakter, panjang nilai maksimum yang diizinkan adalah 256 karakter dan jumlah entri yang diizinkan adalah 10.
description	string	Deskripsi objek.
displayName	string	Nama objek.
project	EntityReference	EntityReference

Respons

Nama	Jenis	Deskripsi
200 OK	Evaluation	OK Header Retry-After: integer
Other Status Codes	Error	Terjadi kesalahan.

Nama

Jenis

Deskripsi

200 OK

Evaluation

Header

Retry-After: integer

Other Status Codes

Error

Terjadi kesalahan.

Keamanan

Ocp-Apim-Subscription-Key

Berikan kunci akun layanan kognitif Anda di sini.

Jenis: apiKey
Dalam: header

Authorization

Berikan token akses dari JWT yang dikembalikan oleh STS wilayah ini. Pastikan untuk menambahkan cakupan manajemen ke token dengan menambahkan string kueri berikut ke URL STS: ?scope=speechservicesmanagement

Jenis: apiKey
Dalam: header

Contoh

Update a evaluation

Permintaan sampel

HTTP

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

{
  "displayName": "Updated evaluation",
  "description": "Updated evaluation description"
}

Respon sampel

Kode status:: 200

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

Definisi

Nama	Deskripsi
DetailedErrorCode	DetailedErrorCode
EntityError	EntityError
EntityReference	EntityReference
Error	Kesalahan
ErrorCode	Kode Kesalahan
Evaluation	Evaluasi
EvaluationLinks	EvaluationLinks
EvaluationProperties	EvaluationProperties
EvaluationUpdate	EvaluationUpdate
InnerError	InnerError
Status	Kedudukan

DetailedErrorCode

Enumeration

DetailedErrorCode

Nilai	Deskripsi
InvalidParameterValue	Nilai parameter tidak valid.
InvalidRequestBodyFormat	Format isi permintaan tidak valid.
EmptyRequest	Permintaan Kosong.
MissingInputRecords	Rekaman Input hilang.
InvalidDocument	Dokumen Tidak Valid.
ModelVersionIncorrect	Versi Model Salah.
InvalidDocumentBatch	Batch Dokumen Tidak Valid.
UnsupportedLanguageCode	Kode bahasa yang tidak didukung.
DataImportFailed	Impor data gagal.
InUseViolation	Dalam pelanggaran penggunaan.
InvalidLocale	Lokal tidak valid.
InvalidBaseModel	Model dasar tidak valid.
InvalidAdaptationMapping	Pemetaan adaptasi tidak valid.
InvalidDataset	Himpunan data tidak valid.
InvalidTest	Tes tidak valid.
FailedDataset	Himpunan data yang gagal.
InvalidModel	Model tidak valid.
InvalidTranscription	Transkripsi tidak valid.
InvalidPayload	Payload tidak valid.
InvalidParameter	Parameter tidak valid.
EndpointWithoutLogging	Titik akhir tanpa pengelogan.
InvalidPermissions	Izin tidak valid.
InvalidPrerequisite	Prasyarat tidak valid.
InvalidProductId	Id produk tidak valid.
InvalidSubscription	Langganan tidak valid.
InvalidProject	Proyek tidak valid.
InvalidProjectKind	Jenis proyek tidak valid.
InvalidRecordingsUri	uri rekaman tidak valid.
OnlyOneOfUrlsOrContainerOrDataset	Hanya salah satu url atau kontainer atau himpunan data.
ExceededNumberOfRecordingsUris	Melebihi jumlah uri rekaman.
ModelMismatch	Ketidakcocokan model.
ProjectGenderMismatch	Ketidakcocokan jenis kelamin proyek.
ModelDeprecated	Model tidak digunakan lagi.
ModelExists	Model ada.
ModelNotDeployable	Model tidak dapat disebarkan.
EndpointNotUpdatable	Titik akhir tidak dapat diperbarui.
SingleDefaultEndpoint	Titik akhir default tunggal.
EndpointCannotBeDefault	Titik akhir tidak boleh default.
InvalidModelUri	Uri model tidak valid.
SubscriptionNotFound	Langganan tidak ditemukan.
QuotaViolation	Pelanggaran kuota.
UnsupportedDelta	Delta yang tidak didukung.
UnsupportedFilter	Filter yang tidak didukung.
UnsupportedPagination	Penomoran halaman yang tidak didukung.
UnsupportedDynamicConfiguration	Konfigurasi dinamis yang tidak didukung.
UnsupportedOrderBy	Urutan yang tidak didukung oleh.
NoUtf8WithBom	Tidak ada utf8 dengan bom.
ModelDeploymentNotCompleteState	Penyebaran model tidak menyelesaikan status.
SkuLimitsExist	Batas Sku ada.
DeployingFailedModel	Menyebarkan model yang gagal.
UnsupportedTimeRange	Rentang waktu yang tidak didukung.
InvalidLogDate	Tanggal log tidak valid.
InvalidLogId	Id log tidak valid.
InvalidLogStartTime	Waktu mulai log tidak valid.
InvalidLogEndTime	Waktu akhir log tidak valid.
InvalidTopForLogs	Atas tidak valid untuk log.
InvalidSkipTokenForLogs	Melewati token untuk log tidak valid.
DeleteNotAllowed	Hapus tidak diperbolehkan.
Forbidden	Dilarang.
DeployNotAllowed	Sebarkan tidak diizinkan.
UnexpectedError	Kesalahan tak terduga.
InvalidCollection	Koleksi tidak valid.
InvalidCallbackUri	Uri panggilan balik tidak valid.
InvalidSasValidityDuration	Durasi validitas sas tidak valid.
InaccessibleCustomerStorage	Penyimpanan pelanggan yang tidak dapat diakses.
UnsupportedClassBasedAdaptation	Adaptasi berbasis kelas yang tidak didukung.
InvalidWebHookEventKind	Jenis peristiwa web hook tidak valid.
InvalidTimeToLive	Waktu hidup tidak valid.
InvalidSourceAzureResourceId	ID sumber daya Azure sumber tidak valid.
ModelCopyOperationExists	Operasi penyalinan model ada.

EntityError

Objek

EntityError

Nama	Jenis	Deskripsi
code	string	Kode kesalahan ini.
message	string	Pesan untuk kesalahan ini.

EntityReference

Objek

EntityReference

Nama	Jenis	Deskripsi
self	string (uri)	Lokasi entitas yang dirujuk.

Error

Objek

Kesalahan

Nama	Jenis	Deskripsi
code	ErrorCode	Kode Kesalahan Kode kesalahan tingkat tinggi.
details	Error[]	Detail dukungan tambahan mengenai kesalahan dan/atau kebijakan yang diharapkan.
innerError	InnerError	InnerError Format Kesalahan Dalam Baru yang sesuai dengan Panduan API Cognitive Services yang tersedia di https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Ini berisi properti yang diperlukan ErrorCode, pesan, dan target properti opsional, detail(pasangan nilai kunci), kesalahan dalam (ini dapat ditumpuk).
message	string	Pesan kesalahan tingkat tinggi.
target	string	Sumber kesalahan. Misalnya akan menjadi "dokumen" atau "id dokumen" jika dokumen tidak valid.

ErrorCode

Enumeration

Kode Kesalahan

Nilai	Deskripsi
InvalidRequest	Mewakili kode kesalahan permintaan yang tidak valid.
InvalidArgument	Mewakili kode kesalahan argumen yang tidak valid.
InternalServerError	Mewakili kode kesalahan server internal.
ServiceUnavailable	Mewakili kode kesalahan layanan yang tidak tersedia.
NotFound	Mewakili kode kesalahan yang tidak ditemukan.
PipelineError	Mewakili kode kesalahan kesalahan alur.
Conflict	Mewakili kode kesalahan konflik.
InternalCommunicationFailed	Mewakili kode kesalahan komunikasi internal gagal.
Forbidden	Mewakili kode kesalahan terlarang.
NotAllowed	Mewakili kode kesalahan yang tidak diizinkan.
Unauthorized	Mewakili kode kesalahan yang tidak sah.
UnsupportedMediaType	Mewakili kode kesalahan jenis media yang tidak didukung.
TooManyRequests	Mewakili terlalu banyak kode kesalahan permintaan.
UnprocessableEntity	Mewakili kode kesalahan entitas yang tidak dapat diolah.

Evaluation

Objek

Evaluasi

Nama	Jenis	Deskripsi
createdDateTime	string (date-time)	Stempel waktu saat objek dibuat. Stempel waktu dikodekan sebagai format tanggal dan waktu ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", lihat https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
customProperties	object	Properti kustom entitas ini. Panjang kunci maksimum yang diizinkan adalah 64 karakter, panjang nilai maksimum yang diizinkan adalah 256 karakter dan jumlah entri yang diizinkan adalah 10.
dataset	EntityReference	EntityReference
description	string	Deskripsi objek.
displayName	string minLength: 1	Nama tampilan objek.
lastActionDateTime	string (date-time)	Stempel waktu ketika status saat ini dimasukkan. Stempel waktu dikodekan sebagai format tanggal dan waktu ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", lihat https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
links	EvaluationLinks	EvaluationLinks
locale	string minLength: 1	Lokal data yang terkandung.
model1	EntityReference	EntityReference
model2	EntityReference	EntityReference
project	EntityReference	EntityReference
properties	EvaluationProperties	EvaluationProperties
self	string (uri)	Lokasi entitas ini.
status	Status	Kedudukan Menjelaskan status API saat ini
transcription1	EntityReference	EntityReference
transcription2	EntityReference	EntityReference

EvaluationLinks

Objek

EvaluationLinks

Nama	Jenis	Deskripsi
files	string (uri)	Lokasi untuk mendapatkan semua file entitas ini. Lihat operasi "Evaluations_ListFiles" untuk detail selengkapnya.

EvaluationProperties

Objek

EvaluationProperties

Nama	Jenis	Deskripsi
correctTokenCount1	integer (int32)	Jumlah token yang dikenali dengan benar oleh model1.
correctTokenCount2	integer (int32)	Jumlah token yang dikenali dengan benar oleh model2.
correctWordCount1	integer (int32)	Jumlah kata yang dikenali dengan benar berdasarkan model1.
correctWordCount2	integer (int32)	Jumlah kata yang dikenali dengan benar oleh model2.
email	string	Alamat email untuk mengirim pemberitahuan email jika operasi selesai. Nilai akan dihapus setelah berhasil mengirim email.
error	EntityError	EntityError
sentenceCount1	integer (int32)	Jumlah kalimat yang diproses oleh model1.
sentenceCount2	integer (int32)	Jumlah kalimat yang diproses oleh model2.
sentenceErrorRate1	number (double)	Tingkat kesalahan kalimat pengenalan dengan model1.
sentenceErrorRate2	number (double)	Tingkat kesalahan kalimat pengenalan dengan model2.
tokenCount1	integer (int32)	Jumlah token yang diproses berdasarkan model1.
tokenCount2	integer (int32)	Jumlah token yang diproses oleh model2.
tokenDeletionCount1	integer (int32)	Jumlah token yang dikenali oleh model1, yang merupakan penghapusan.
tokenDeletionCount2	integer (int32)	Jumlah token yang dikenali oleh model2, yang merupakan penghapusan.
tokenErrorRate1	number (double)	Tingkat kesalahan token pengenalan dengan model1.
tokenErrorRate2	number (double)	Tingkat kesalahan token pengenalan dengan model2.
tokenInsertionCount1	integer (int32)	Jumlah token yang dikenali oleh model1, yaitu penyisipan.
tokenInsertionCount2	integer (int32)	Jumlah token yang dikenali oleh model2, yaitu penyisipan.
tokenSubstitutionCount1	integer (int32)	Jumlah token yang dikenali oleh model1, yaitu substitusi.
tokenSubstitutionCount2	integer (int32)	Jumlah token yang dikenali oleh model2, yaitu substitusi.
wordCount1	integer (int32)	Jumlah kata yang diproses menurut model1.
wordCount2	integer (int32)	Jumlah kata yang diproses oleh model2.
wordDeletionCount1	integer (int32)	Jumlah kata yang dikenali oleh model1, yang merupakan penghapusan.
wordDeletionCount2	integer (int32)	Jumlah kata yang dikenali oleh model2, yang merupakan penghapusan.
wordErrorRate1	number (double)	Tingkat kesalahan kata pengenalan dengan model1.
wordErrorRate2	number (double)	Tingkat kesalahan kata pengenalan dengan model2.
wordInsertionCount1	integer (int32)	Jumlah kata yang dikenali menurut model1, yang merupakan penyisipan.
wordInsertionCount2	integer (int32)	Jumlah kata yang dikenali oleh model2, yang merupakan penyisipan.
wordSubstitutionCount1	integer (int32)	Jumlah kata yang dikenali oleh model1, yaitu substitusi.
wordSubstitutionCount2	integer (int32)	Jumlah kata yang dikenali oleh model2, yaitu substitusi.

EvaluationUpdate

Objek

EvaluationUpdate

Nama	Jenis	Deskripsi
customProperties	object	Properti kustom entitas ini. Panjang kunci maksimum yang diizinkan adalah 64 karakter, panjang nilai maksimum yang diizinkan adalah 256 karakter dan jumlah entri yang diizinkan adalah 10.
description	string	Deskripsi objek.
displayName	string	Nama objek.
project	EntityReference	EntityReference

InnerError

Objek

InnerError

Nama	Jenis	Deskripsi
code	DetailedErrorCode	DetailedErrorCode Enum kode kesalahan terperinci.
details	object	Detail dukungan tambahan mengenai kesalahan dan/atau kebijakan yang diharapkan.
innerError	InnerError	InnerError Format Kesalahan Dalam Baru yang sesuai dengan Panduan API Cognitive Services yang tersedia di https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Ini berisi properti yang diperlukan ErrorCode, pesan, dan target properti opsional, detail(pasangan nilai kunci), kesalahan dalam (ini dapat ditumpuk).
message	string	Pesan kesalahan tingkat tinggi.
target	string	Sumber kesalahan. Misalnya akan menjadi "dokumen" atau "id dokumen" jika dokumen tidak valid.

Status

Enumeration

Kedudukan

Nilai	Deskripsi
NotStarted	Operasi jangka panjang belum dimulai.
Running	Operasi yang berjalan lama saat ini sedang diproses.
Succeeded	Operasi jangka panjang berhasil diselesaikan.
Failed	Operasi yang berjalan lama gagal.