CreateIntentVersion - Amazon Lex V1
Minta SintaksParameter Permintaan URIIsi PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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.

CreateIntentVersion

Membuat versi baru dari intent berdasarkan $LATEST versi intent. Jika $LATEST versi intent ini tidak berubah sejak terakhir kali Anda memperbaruinya, Amazon Lex tidak membuat versi baru. Ini mengembalikan versi terakhir yang Anda buat.

catatan

Anda hanya dapat memperbarui $LATEST versi intent. Anda tidak dapat memperbarui versi bernomor yang Anda buat dengan CreateIntentVersion operasi.

Saat Anda membuat versi intent, Amazon Lex menyetel versi ke 1. Versi selanjutnya meningkat sebesar 1. Untuk informasi selengkapnya, lihat Versioning.

Operasi ini memerlukan izin untuk menjalankan tindakan lex:CreateIntentVersion.

Minta Sintaks

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

{
   "checksum": "string"
}

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

name

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

Batasan Panjang: Panjang minimum 1. Panjang maksimum 100.

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

Wajib: Ya

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

checksum

Checksum $LATEST versi intent yang harus digunakan untuk membuat versi baru. Jika Anda menentukan checksum dan $LATEST versi intent memiliki checksum yang berbeda, Amazon Lex mengembalikan PreconditionFailedException pengecualian dan tidak memublikasikan 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

{
   "checksum": "string",
   "conclusionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "confirmationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "dialogCodeHook": { 
      "messageVersion": "string",
      "uri": "string"
   },
   "followUpPrompt": { 
      "prompt": { 
         "maxAttempts": number,
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      },
      "rejectionStatement": { 
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      }
   },
   "fulfillmentActivity": { 
      "codeHook": { 
         "messageVersion": "string",
         "uri": "string"
      },
      "type": "string"
   },
   "inputContexts": [ 
      { 
         "name": "string"
      }
   ],
   "kendraConfiguration": { 
      "kendraIndex": "string",
      "queryFilterString": "string",
      "role": "string"
   },
   "lastUpdatedDate": number,
   "name": "string",
   "outputContexts": [ 
      { 
         "name": "string",
         "timeToLiveInSeconds": number,
         "turnsToLive": number
      }
   ],
   "parentIntentSignature": "string",
   "rejectionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "sampleUtterances": [ "string" ],
   "slots": [ 
      { 
         "defaultValueSpec": { 
            "defaultValueList": [ 
               { 
                  "defaultValue": "string"
               }
            ]
         },
         "description": "string",
         "name": "string",
         "obfuscationSetting": "string",
         "priority": number,
         "responseCard": "string",
         "sampleUtterances": [ "string" ],
         "slotConstraint": "string",
         "slotType": "string",
         "slotTypeVersion": "string",
         "valueElicitationPrompt": { 
            "maxAttempts": number,
            "messages": [ 
               { 
                  "content": "string",
                  "contentType": "string",
                  "groupNumber": number
               }
            ],
            "responseCard": "string"
         }
      }
   ],
   "version": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respon HTTP 201.

Layanan mengembalikan data berikut dalam format JSON.

checksum

Checksum dari versi intent yang dibuat.

Jenis: String

conclusionStatement

Setelah fungsi Lambda yang ditentukan dalam fulfillmentActivity bidang memenuhi intent, Amazon Lex menyampaikan pernyataan ini kepada pengguna.

Tipe: Objek Statement

confirmationPrompt

Jika ditentukan, prompt yang digunakan Amazon Lex untuk mengonfirmasi maksud pengguna sebelum memenuhinya.

Tipe: Objek Prompt

createdDate

Tanggal dimana niat itu dibuat.

Tipe: Timestamp

description

Deskripsi niat.

Jenis: String

Batasan Panjang: Panjang minimum 0. Panjang maksimum 200.

dialogCodeHook

Jika ditentukan, Amazon Lex memanggil fungsi Lambda ini untuk setiap input pengguna.

Tipe: Objek CodeHook

followUpPrompt

Jika didefinisikan, Amazon Lex menggunakan prompt ini untuk meminta aktivitas pengguna tambahan setelah intent terpenuhi.

Tipe: Objek FollowUpPrompt

fulfillmentActivity

Menjelaskan bagaimana niat terpenuhi.

Tipe: Objek FulfillmentActivity

inputContexts

Larik InputContext objek yang mencantumkan konteks yang harus aktif untuk Amazon Lex untuk memilih maksud dalam percakapan dengan pengguna.

Tipe: Array objek InputContext

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

kendraConfiguration

Informasi konfigurasi, jika ada, untuk menghubungkan indeks Amazon Kendra dengan maksud. AMAZON.KendraSearchIntent

Tipe: Objek KendraConfiguration

lastUpdatedDate

Tanggal dimana intent diperbarui.

Tipe: Timestamp

name

Nama niat.

Jenis: String

Panjang Batasan: Panjang minimum 1. Panjang maksimum 100.

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

outputContexts

Array OutputContext objek yang mencantumkan konteks yang mengaktifkan intent saat intent terpenuhi.

Tipe: Array objek OutputContext

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

parentIntentSignature

Pengenal unik untuk maksud bawaan.

Jenis: String

rejectionStatement

Jika pengguna menjawab “tidak” untuk pertanyaan yang didefinisikan dalamconfirmationPrompt, Amazon Lex merespons dengan pernyataan ini untuk mengakui bahwa maksud tersebut dibatalkan.

Tipe: Objek Statement

sampleUtterances

Larik contoh ucapan yang dikonfigurasi untuk maksud.

Tipe: Array string.

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

Batasan Panjang: Panjang minimum 1. Panjang maksimum 200.

slots

Array jenis slot yang mendefinisikan informasi yang diperlukan untuk memenuhi maksud.

Tipe: Array objek Slot

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

version

Nomor versi yang ditetapkan ke versi baru dari intent.

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

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: