PutSlotType - Amazon Lex V1

Jika Anda menggunakan Amazon Lex V2, lihat panduan Amazon Lex V2 sebagai gantinya.

 

Jika Anda menggunakan Amazon Lex V1, kami sarankan untuk meningkatkan bot Anda ke Amazon Lex V2. Kami tidak lagi menambahkan fitur baru ke V1 dan sangat menyarankan menggunakan V2 untuk semua bot baru.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

PutSlotType

Membuat jenis slot khusus atau menggantikan jenis slot kustom yang ada.

Untuk membuat jenis slot khusus, tentukan nama untuk jenis slot dan satu set nilai enumerasi, yang merupakan nilai yang dapat diasumsikan oleh slot jenis ini. Untuk informasi selengkapnya, lihat Amazon Lex: Cara Kerjanya.

Jika Anda menentukan nama jenis slot yang ada, bidang dalam permintaan menggantikan nilai yang ada dalam $LATEST versi jenis slot. Amazon Lex menghapus bidang yang tidak Anda berikan dalam permintaan. Jika Anda tidak menentukan bidang wajib, Amazon Lex melempar pengecualian. Saat Anda memperbarui $LATEST versi jenis slot, jika bot menggunakan $LATEST versi intent yang berisi jenis slot, status bidang bot disetel keNOT_BUILT.

Operasi ini memerlukan izin utuk tindakan lex:PutSlotType.

Minta Sintaks

PUT /slottypes/name/versions/$LATEST HTTP/1.1 Content-type: application/json { "checksum": "string", "createVersion": boolean, "description": "string", "enumerationValues": [ { "synonyms": [ "string" ], "value": "string" } ], "parentSlotTypeSignature": "string", "slotTypeConfigurations": [ { "regexConfiguration": { "pattern": "string" } } ], "valueSelectionStrategy": "string" }

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

name

Nama jenis slot. Namanya tidak peka huruf besar/kecil.

Nama tidak dapat cocok dengan nama tipe slot bawaan, atau nama tipe slot bawaan dengan “AMAZON.” dihapus. Misalnya, karena ada jenis slot bawaan yang disebutAMAZON.DATE, Anda tidak dapat membuat jenis slot khusus yang disebutDATE.

Untuk daftar jenis slot bawaan, lihat Referensi Jenis Slot di Alexa Skills Kit.

Batasan Panjang: Panjang minimum 1. Panjang maksimum 100.

Pola: ^([A-Za-z]_?)+$

Wajib: Ya

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

checksum

Mengidentifikasi revisi spesifik dari versi. $LATEST

Saat Anda membuat jenis slot baru, biarkan checksum bidang kosong. Jika Anda menentukan checksum, Anda mendapatkan BadRequestException pengecualian.

Saat Anda ingin memperbarui jenis slot, atur checksum bidang ke checksum dari revisi versi terbaru. $LATEST Jika Anda tidak menentukan checksum bidang, atau jika checksum tidak cocok dengan $LATEST versi, Anda mendapatkan PreconditionFailedException pengecualian.

Tipe: String

Wajib: Tidak

createVersion

Ketika diatur ke true versi bernomor baru dari jenis slot dibuat. Ini sama dengan memanggil CreateSlotTypeVersion operasi. Jika Anda tidak menentukancreateVersion, defaultnya adalahfalse.

Tipe: Boolean

Wajib: Tidak

description

Deskripsi jenis slot.

Jenis: String

Batasan Panjang: Panjang minimum 0. Panjang maksimum 200.

Diperlukan: Tidak

enumerationValues

Daftar EnumerationValue objek yang mendefinisikan nilai yang dapat diambil oleh jenis slot. Setiap nilai dapat memiliki daftarsynonyms, yang merupakan nilai tambahan yang membantu melatih model pembelajaran mesin tentang nilai-nilai yang diselesaikan untuk slot.

Jenis slot ekspresi reguler tidak memerlukan nilai enumerasi. Semua jenis slot lainnya memerlukan daftar nilai enumerasi.

Ketika Amazon Lex menyelesaikan nilai slot, itu menghasilkan daftar resolusi yang berisi hingga lima nilai yang mungkin untuk slot. Jika Anda menggunakan fungsi Lambda, daftar resolusi ini diteruskan ke fungsi. Jika Anda tidak menggunakan fungsi Lambda, Anda dapat memilih untuk mengembalikan nilai yang dimasukkan pengguna atau nilai pertama dalam daftar resolusi sebagai nilai slot. valueSelectionStrategyBidang menunjukkan opsi untuk digunakan.

Tipe: Array objek EnumerationValue

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 10000 item.

Diperlukan: Tidak

parentSlotTypeSignature

Tipe slot built-in digunakan sebagai induk dari jenis slot. Saat Anda menentukan jenis slot induk, jenis slot baru memiliki semua konfigurasi yang sama dengan induknya.

Hanya AMAZON.AlphaNumeric didukung.

Jenis: String

Panjang Batasan: Panjang minimum 1. Panjang maksimum 100.

Pola: ^((AMAZON\.)_?|[A-Za-z]_?)+

Diperlukan: Tidak

slotTypeConfigurations

Informasi konfigurasi yang memperluas tipe slot bawaan induk. Konfigurasi ditambahkan ke pengaturan untuk jenis slot induk.

Tipe: Array objek SlotTypeConfiguration

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 10 item.

Diperlukan: Tidak

valueSelectionStrategy

Menentukan strategi resolusi slot yang digunakan Amazon Lex untuk mengembalikan nilai jenis slot. Bidang dapat diatur ke salah satu nilai berikut:

  • ORIGINAL_VALUE- Mengembalikan nilai yang dimasukkan oleh pengguna, jika nilai pengguna mirip dengan nilai slot.

  • TOP_RESOLUTION- Jika ada daftar resolusi untuk slot, kembalikan nilai pertama dalam daftar resolusi sebagai nilai jenis slot. Jika tidak ada daftar resolusi, null dikembalikan.

Jika Anda tidak menentukanvalueSelectionStrategy, defaultnya adalahORIGINAL_VALUE.

Jenis: String

Nilai yang Valid: ORIGINAL_VALUE | TOP_RESOLUTION

Diperlukan: Tidak

Sintaksis Respons

HTTP/1.1 200 Content-type: application/json { "checksum": "string", "createdDate": number, "createVersion": boolean, "description": "string", "enumerationValues": [ { "synonyms": [ "string" ], "value": "string" } ], "lastUpdatedDate": number, "name": "string", "parentSlotTypeSignature": "string", "slotTypeConfigurations": [ { "regexConfiguration": { "pattern": "string" } } ], "valueSelectionStrategy": "string", "version": "string" }

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

checksum

Checksum dari $LATEST versi jenis slot.

Jenis: String

createdDate

Tanggal jenis slot dibuat.

Tipe: Timestamp

createVersion

Truejika versi baru dari jenis slot dibuat. Jika createVersion bidang tidak ditentukan dalam permintaan, createVersion bidang diatur ke false dalam respons.

Jenis: Boolean

description

Deskripsi jenis slot.

Jenis: String

Batasan Panjang: Panjang minimum 0. Panjang maksimum 200.

enumerationValues

Daftar EnumerationValue objek yang mendefinisikan nilai yang dapat diambil oleh jenis slot.

Tipe: Array objek EnumerationValue

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 10000 item.

lastUpdatedDate

Tanggal bahwa jenis slot diperbarui. Saat Anda membuat jenis slot, tanggal pembuatan dan tanggal pembaruan terakhir adalah sama.

Tipe: Timestamp

name

Nama jenis slot.

Jenis: String

Panjang Batasan: Panjang minimum 1. Panjang maksimum 100.

Pola: ^([A-Za-z]_?)+$

parentSlotTypeSignature

Tipe slot built-in digunakan sebagai induk dari jenis slot.

Jenis: String

Panjang Batasan: Panjang minimum 1. Panjang maksimum 100.

Pola: ^((AMAZON\.)_?|[A-Za-z]_?)+

slotTypeConfigurations

Informasi konfigurasi yang memperluas tipe slot bawaan induk.

Tipe: Array objek SlotTypeConfiguration

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 10 item.

valueSelectionStrategy

Strategi resolusi slot yang digunakan Amazon Lex untuk menentukan nilai slot. Untuk informasi selengkapnya, lihat PutSlotType.

Tipe: String

Nilai yang Valid: ORIGINAL_VALUE | TOP_RESOLUTION

version

Versi dari jenis slot. Untuk jenis slot baru, versinya selalu$LATEST.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.

Pola: \$LATEST|[0-9]+

Kesalahan

BadRequestException

Permintaan tidak terbentuk dengan baik. Misalnya, nilai tidak valid atau bidang wajib hilang. Periksa nilai bidang, dan coba lagi.

Kode Status HTTP: 400

ConflictException

Ada konflik yang memproses permintaan tersebut. Coba permintaan Anda lagi.

Kode Status HTTP: 409

InternalFailureException

Terjadi kesalahan internal Amazon Lex. Coba permintaan Anda lagi.

Kode Status HTTP: 500

LimitExceededException

Permintaan melebihi batas. Coba permintaan Anda lagi.

Kode Status HTTP: 429

PreconditionFailedException

Checksum sumber daya yang Anda coba ubah tidak cocok dengan checksum dalam permintaan. Periksa checksum sumber daya dan coba lagi.

Kode Status HTTP: 412

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: