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 disebut
AMAZON.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 mendapatkanBadRequestException
pengecualian.Saat Anda ingin memperbarui jenis slot, atur
checksum
bidang ke checksum dari revisi versi terbaru.$LATEST
Jika Anda tidak menentukanchecksum
bidang, atau jika checksum tidak cocok dengan$LATEST
versi, Anda mendapatkanPreconditionFailedException
pengecualian.Tipe: String
Wajib: Tidak
- createVersion
-
Ketika diatur ke
true
versi bernomor baru dari jenis slot dibuat. Ini sama dengan memanggilCreateSlotTypeVersion
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.
valueSelectionStrategy
Bidang 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 menentukan
valueSelectionStrategy
, 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
-
True
jika versi baru dari jenis slot dibuat. JikacreateVersion
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: