Pembuatan Versi dan Alias - Amazon Lex V1
VersioningAlias

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.

Pembuatan Versi dan Alias

Amazon Lex mendukung versi penerbitan bot, maksud, dan jenis slot sehingga Anda dapat mengontrol implementasi yang digunakan aplikasi klien Anda. SEBUAHversiadalah snapshot bernomor dari pekerjaan Anda yang dapat Anda publikasikan untuk digunakan di berbagai bagian alur kerja Anda, seperti pengembangan, penyebaran beta, dan produksi.

Bot Amazon Lex juga mendukung alias. Sesialiasadalah penunjuk ke versi tertentu dari bot. Dengan alias, Anda dapat dengan mudah memperbarui versi yang digunakan aplikasi klien Anda. Misalnya, Anda dapat mengarahkan alias ke versi 1 dari bot Anda. Saat Anda siap memperbarui bot, Anda mempublikasikan versi 2 dan mengubah alias untuk mengarah ke versi baru. Karena aplikasi Anda menggunakan alias alih-alih versi tertentu, semua klien Anda mendapatkan fungsionalitas baru tanpa perlu diperbarui.

Versioning

Ketika Anda versi sumber daya Amazon Lex Anda membuat snapshot dari sumber daya sehingga Anda dapat menggunakan sumber daya seperti itu ada ketika versi dibuat. Setelah Anda membuat versi itu akan tetap sama saat Anda terus bekerja pada aplikasi Anda.

Versi $LATEST

Saat Anda membuat bot Amazon Lex, tipe slot, hanya ada satu versi,$LATESTversi.

The $LATEST version of a bot.

$LATESTadalah salinan kerja sumber daya Anda. Anda dapat memperbarui hanya$LATESTversi dan sampai Anda mempublikasikan versi pertama Anda,$LATESTadalah satu-satunya versi sumber daya yang Anda miliki.

Hanya$LATESTsumber daya dapat menggunakan$LATESTversi sumber daya lain. Misalnya,$LATESTversi bot dapat menggunakan$LATESTversi intent, dan$LATESTversi intent dapat menggunakan$LATESTversi dari jenis slot.

Parameter$LATESTversi bot Anda hanya boleh digunakan untuk pengujian manual. Amazon Lex membatasi jumlah permintaan runtime yang dapat Anda buat ke$LATESTversi bot.

Menerbitkan Versi Sumber Daya Amazon Lex

Ketika Anda mempublikasikan sumber daya, Amazon Lex membuat salinan$LATESTversi dan menyimpannya sebagai versi bernomor. Versi yang dipublikasikan tidak dapat diubah.

Publishing a new version of the bot.

Anda membuat dan memublikasikan versi menggunakan konsol Amazon Lex atauCreateBotVersionoperasi. Sebagai contoh, lihat Latihan 3: Publikasikan Versi dan Buat Alias.

Saat Anda memodifikasi$LATESTversi sumber daya, Anda dapat mempublikasikan versi baru untuk membuat perubahan yang tersedia untuk aplikasi klien Anda. Setiap kali Anda mempublikasikan versi, Amazon Lex menyalin$LATESTversi untuk membuat versi baru dan menambah nomor versi dengan 1. Nomor versi tidak pernah digunakan kembali. Misalnya, jika Anda menghapus sumber daya bernomor versi 10 dan kemudian menciptakannya kembali, nomor versi berikutnya yang diberikan Amazon Lex adalah versi 11.

Sebelum dapat memublikasikan bot, Anda harus mengarahkannya ke versi bernomor dari maksud apa pun yang digunakannya. Jika Anda mencoba menerbitkan versi baru bot yang menggunakan intent versi $ TERBARU, Amazon Lex mengembalikan pengecualian HTTP 400 Bad Request. Sebelum dapat memublikasikan maksud versi bernomor, Anda harus mengarahkan intent ke versi bernomor dari jenis slot apa pun yang digunakan. Jika tidak, Anda akan mendapatkan pengecualian HTTP 400 Bad Request.

Publishing a new version of $LATEST.

catatan

Amazon Lex menerbitkan versi baru hanya jika versi terakhir yang diterbitkan berbeda dari$LATESTversi. Jika Anda mencoba untuk mempublikasikan$LATESTversi tanpa memodifikasinya, Amazon Lex tidak membuat atau mempublikasikan versi baru.

Memperbarui Sumber Daya Amazon Lex

Anda dapat memperbarui hanya$LATESTversi bot Amazon Lex, maksud, atau jenis slot. Versi yang dipublikasikan tidak dapat diubah. Anda dapat mempublikasikan versi baru kapan saja setelah memperbarui sumber daya di konsol atau denganCreateBotVersion, yangCreateIntentVersionatauCreateSlotTypeVersionoperasi.

Menghapus Sumber Daya atau Versi Amazon Lex

Amazon Lex mendukung menghapus sumber daya atau versi menggunakan konsol atau salah satu operasi API:

Alias

Alias adalah penunjuk ke versi spesifik dari bot Amazon Lex. Gunakan alias untuk memungkinkan aplikasi klien menggunakan versi bot tertentu tanpa memerlukan aplikasi untuk melacak versi mana yang ada.

Contoh berikut menunjukkan dua versi bot Amazon Lex, versi 1 dan versi 2. Masing-masing versi bot ini memiliki alias terkait, BETA dan PROD, masing-masing. Aplikasi klien menggunakan alias PROD untuk mengakses bot.

Point a client application to a version by using an alias.

Ketika Anda membuat versi kedua dari bot, Anda dapat memperbarui alias untuk menunjuk ke versi baru dari bot menggunakan konsol atauPutBotoperasi. Ketika Anda mengubah alias, semua aplikasi klien Anda menggunakan versi baru. Jika ada masalah dengan versi baru, Anda dapat memutar kembali ke versi sebelumnya hanya dengan mengubah alias untuk menunjuk ke versi itu.

Updating an alias changes the version used by client applications.

catatan

Meskipun Anda dapat menguji$LATESTversi bot di konsol, kami sarankan bahwa ketika Anda mengintegrasikan bot dengan aplikasi klien Anda, Anda pertama kali mempublikasikan versi dan membuat alias yang menunjuk ke versi itu. Gunakan alias dalam aplikasi klien Anda untuk alasan yang dijelaskan di bagian ini. Saat Anda memperbarui alias, Amazon Lex akan menunggu hingga batas waktu sesi semua sesi saat ini berakhir sebelum mulai menggunakan versi baru. Untuk informasi selengkapnya tentang batas waktu sesi, lihatMengatur Timeout Sesi