CreateBotVersion

Membuat versi baru bot berdasarkan $LATEST versi. Jika $LATEST versi sumber daya ini tidak berubah sejak Anda membuat versi terakhir, Amazon Lex tidak membuat versi baru. Ia mengembalikan versi yang terakhir dibuat.

catatan

Anda hanya dapat memperbarui $LATEST versi bot. Anda tidak dapat memperbarui versi bernomor yang Anda buat dengan CreateBotVersion operasi.

Saat Anda membuat versi pertama bot, Amazon Lex menetapkan versi ke 1. Versi selanjutnya meningkat sebesar 1. Untuk informasi selengkapnya, lihat Versioning.

Operasi ini memerlukan izin untuk tindakan lex:CreateBotVersion.

Minta Sintaks

POST /bots/name/versions HTTP/1.1
Content-type: application/json

{
   "checksum": "string"
}

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

name

Nama bot yang ingin Anda buat versi baru. Namanya peka huruf besar/kecil.

Kendala Panjang: Panjang minimum 2. Panjang maksimum 50.

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

Wajib: Ya

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

checksum

Mengidentifikasi revisi spesifik dari $LATEST versi bot. Jika Anda menentukan checksum dan $LATEST versi bot memiliki checksum yang berbeda, PreconditionFailedException pengecualian akan dikembalikan dan Amazon Lex tidak menerbitkan versi baru. Jika Anda tidak menentukan checksum, Amazon Lex menerbitkan versinya. $LATEST

Tipe: String

Wajib: Tidak

Sintaksis Respons

HTTP/1.1 201
Content-type: application/json

{
   "abortStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "checksum": "string",
   "childDirected": boolean,
   "clarificationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "detectSentiment": boolean,
   "enableModelImprovements": boolean,
   "failureReason": "string",
   "idleSessionTTLInSeconds": number,
   "intents": [ 
      { 
         "intentName": "string",
         "intentVersion": "string"
      }
   ],
   "lastUpdatedDate": number,
   "locale": "string",
   "name": "string",
   "status": "string",
   "version": "string",
   "voiceId": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respon HTTP 201.

Layanan mengembalikan data berikut dalam format JSON.

abortStatement

Pesan yang digunakan Amazon Lex untuk membatalkan percakapan. Untuk informasi selengkapnya, lihat PutBot.

Tipe: Objek Statement

checksum

Checksum mengidentifikasi versi bot yang dibuat.

Jenis: String

childDirected

Untuk setiap bot Amazon Lex yang dibuat dengan Layanan Pembuatan Model Amazon Lex, Anda harus menentukan apakah penggunaan Amazon Lex Anda terkait dengan situs web, program, atau aplikasi lain yang diarahkan atau ditargetkan, secara keseluruhan atau sebagian, untuk anak-anak di bawah usia 13 tahun dan tunduk pada Undang-Undang Perlindungan Privasi Online Anak (COPPA) dengan menentukan true atau false di lapangan. childDirected Dengan menentukan true di childDirected lapangan, Anda mengonfirmasi bahwa penggunaan Amazon Lex Anda terkait dengan situs web, program, atau aplikasi lain yang diarahkan atau ditargetkan, secara keseluruhan atau sebagian, untuk anak-anak di bawah usia 13 tahun dan tunduk pada COPPA. Dengan menentukan false di childDirected lapangan, Anda mengonfirmasi bahwa penggunaan Amazon Lex Anda tidak terkait dengan situs web, program, atau aplikasi lain yang diarahkan atau ditargetkan, secara keseluruhan atau sebagian, untuk anak-anak di bawah usia 13 tahun dan tunduk pada COPPA. Anda tidak boleh menentukan nilai default untuk childDirected bidang yang tidak secara akurat mencerminkan apakah penggunaan Amazon Lex Anda terkait dengan situs web, program, atau aplikasi lain yang diarahkan atau ditargetkan, secara keseluruhan atau sebagian, untuk anak-anak di bawah usia 13 tahun dan tunduk pada COPPA.

Jika penggunaan Amazon Lex Anda terkait dengan situs web, program, atau aplikasi lain yang diarahkan secara keseluruhan atau sebagian, untuk anak-anak di bawah usia 13 tahun, Anda harus mendapatkan persetujuan orang tua yang dapat diverifikasi berdasarkan COPPA. Untuk informasi mengenai penggunaan Amazon Lex sehubungan dengan situs web, program, atau aplikasi lain yang diarahkan atau ditargetkan, secara keseluruhan atau sebagian, untuk anak-anak di bawah usia 13 tahun, lihat FAQ Amazon Lex.

Jenis: Boolean

clarificationPrompt

Pesan yang digunakan Amazon Lex saat tidak memahami permintaan pengguna. Untuk informasi selengkapnya, lihat PutBot.

Tipe: Objek Prompt

createdDate

Tanggal ketika versi bot dibuat.

Tipe: Timestamp

description

Deskripsi bot.

Jenis: String

Batasan Panjang: Panjang minimum 0. Panjang maksimum 200.

detectSentiment

Menunjukkan apakah ucapan yang dimasukkan oleh pengguna harus dikirim ke Amazon Comprehend untuk analisis sentimen.

Jenis: Boolean

enableModelImprovements

Menunjukkan apakah bot menggunakan peningkatan akurasi. truemenunjukkan bahwa bot menggunakan perbaikan, jika tidak,false.

Jenis: Boolean

failureReason

Jika status yaFAILED, Amazon Lex memberikan alasan bahwa ia gagal membangun bot.

Jenis: String

idleSessionTTLInSeconds

Waktu maksimum dalam hitungan detik Amazon Lex menyimpan data yang dikumpulkan dalam percakapan. Untuk informasi selengkapnya, lihat PutBot.

Jenis: Integer

Rentang yang Valid: Nilai minimum 60. Nilai maksimum 86400.

intents

Susunan objek Intent. Untuk informasi selengkapnya, lihat PutBot.

Tipe: Array objek Intent

lastUpdatedDate

Tanggal ketika $LATEST versi bot ini diperbarui.

Tipe: Timestamp

locale

Menentukan lokal target untuk bot.

Jenis: String

Nilai yang Valid: de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR

name

Nama bot.

Jenis: String

Kendala Panjang: Panjang minimum 2. Panjang maksimum 50.

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

status

Saat Anda mengirim permintaan untuk membuat atau memperbarui bot, Amazon Lex menyetel elemen status respons keBUILDING. Setelah Amazon Lex membangun bot, itu ditetapkan status keREADY. Jika Amazon Lex tidak dapat membangun bot, itu akan diatur status keFAILED. Amazon Lex mengembalikan alasan kegagalan elemen failureReason respons.

Jenis: String

Nilai yang Valid: BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT

version

Versi bot.

Jenis: String

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

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

voiceId

ID suara Amazon Polly yang digunakan Amazon Lex untuk interaksi suara dengan pengguna.

Jenis: String

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 memproses permintaan. 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

NotFoundException

Sumber daya yang ditentukan dalam permintaan tidak ditemukan. Periksa sumber daya dan coba lagi.

Kode Status HTTP: 404

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:

• AWS Antarmuka Baris Perintah

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go v2

• AWS SDK for Java V2

• AWS SDK untuk V3 JavaScript

• AWS SDK for PHP V3

• AWS SDK untuk Python

• AWS SDK for Ruby V3