Pemberitahuan akhir dukungan: Pada 15 September 2025, AWS akan menghentikan dukungan untuk Amazon Lex V1. Setelah 15 September 2025, Anda tidak lagi dapat mengakses konsol Amazon Lex V1 atau sumber daya Amazon Lex V1. Jika Anda menggunakan Amazon Lex V2, lihat [panduan Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) sebagai gantinya. Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # PutIntent Menciptakan maksud atau menggantikan maksud yang ada. Untuk menentukan interaksi antara pengguna dan bot Anda, Anda menggunakan satu atau lebih maksud. Untuk bot pemesanan pizza, misalnya, Anda akan membuat `OrderPizza` maksud. Untuk membuat intent atau mengganti intent yang ada, Anda harus memberikan yang berikut: + Nama niat. Misalnya, `OrderPizza`. + Sampel ucapan. Misalnya, “Bisakah saya memesan pizza, tolong.” dan “Saya ingin memesan pizza.” + Informasi yang akan dikumpulkan. Anda menentukan jenis slot untuk informasi yang akan diminta bot Anda dari pengguna. Anda dapat menentukan jenis slot standar, seperti tanggal atau waktu, atau jenis slot khusus seperti ukuran dan kerak pizza. + Bagaimana niatnya akan terpenuhi. Anda dapat menyediakan fungsi Lambda atau mengonfigurasi intent untuk mengembalikan informasi maksud ke aplikasi klien. Jika Anda menggunakan fungsi Lambda, ketika semua informasi maksud tersedia, Amazon Lex memanggil fungsi Lambda Anda. Jika Anda mengonfigurasi maksud Anda untuk mengembalikan informasi maksud ke aplikasi klien. Anda dapat menentukan informasi opsional lainnya dalam permintaan, seperti: + Permintaan konfirmasi untuk meminta pengguna mengonfirmasi maksud. Misalnya, “Haruskah saya memesan pizza Anda?” + Pernyataan kesimpulan untuk dikirim ke pengguna setelah maksud terpenuhi. Misalnya, “Saya memesan pizza Anda.” + Prompt tindak lanjut yang meminta pengguna untuk aktivitas tambahan. Misalnya, bertanya “Apakah Anda ingin memesan minuman dengan pizza Anda?” Jika Anda menentukan nama intent yang ada untuk memperbarui intent, Amazon Lex mengganti nilai dalam `$LATEST` versi intent dengan nilai dalam permintaan. Amazon Lex menghapus bidang yang tidak Anda berikan dalam permintaan. Jika Anda tidak menentukan bidang yang diperlukan, Amazon Lex melempar pengecualian. Saat Anda memperbarui `$LATEST` versi intent, `status` bidang bot apa pun yang menggunakan `$LATEST` versi intent akan disetel ke. `NOT_BUILT` Untuk informasi selengkapnya, lihat [Amazon Lex: Cara Kerjanya](how-it-works.md). Operasi ini memerlukan izin utuk tindakan `lex:PutIntent`. ## Minta Sintaks ``` PUT /intents/name/versions/$LATEST HTTP/1.1 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" }, "createVersion": boolean, "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" }, "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" } } ] } ``` ## Parameter Permintaan URI Permintaan menggunakan parameter URI berikut. ** [name](#API_PutIntent_RequestSyntax) ** Nama niat. Namanya *tidak* peka huruf besar/kecil. Nama tidak dapat cocok dengan nama intent bawaan, atau nama intent bawaan dengan “AMAZON.” dihapus. Misalnya, karena ada intent bawaan yang dipanggil`AMAZON.HelpIntent`, Anda tidak dapat membuat maksud khusus yang dipanggil. `HelpIntent` Untuk daftar intent bawaan, lihat [Intent Bawaan Standar](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) 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](#API_PutIntent_RequestSyntax) ** Mengidentifikasi revisi spesifik dari versi. `$LATEST` Saat Anda membuat maksud baru, biarkan `checksum` bidang kosong. Jika Anda menentukan checksum Anda mendapatkan `BadRequestException` pengecualian. Saat Anda ingin memperbarui maksud, setel `checksum` bidang ke checksum revisi terbaru versi. `$LATEST` Jika Anda tidak menentukan ` checksum` bidang, atau jika checksum tidak cocok dengan `$LATEST` versi, Anda mendapatkan `PreconditionFailedException` pengecualian. Tipe: String Wajib: Tidak ** [conclusionStatement](#API_PutIntent_RequestSyntax) ** Pernyataan yang Anda ingin Amazon Lex sampaikan kepada pengguna setelah maksud berhasil dipenuhi oleh fungsi Lambda. Elemen ini relevan hanya jika Anda menyediakan fungsi Lambda di. `fulfillmentActivity` Jika Anda mengembalikan intent ke aplikasi klien, Anda tidak dapat menentukan elemen ini. Itu `followUpPrompt` dan `conclusionStatement` saling eksklusif. Anda hanya dapat menentukan satu. Tipe: Objek [Statement](API_Statement.md) Wajib: Tidak ** [confirmationPrompt](#API_PutIntent_RequestSyntax) ** Meminta pengguna untuk mengonfirmasi maksud. Pertanyaan ini harus memiliki jawaban ya atau tidak. Amazon Lex menggunakan prompt ini untuk memastikan bahwa pengguna mengakui bahwa intent siap untuk dipenuhi. Misalnya, dengan `OrderPizza` intent, Anda mungkin ingin mengonfirmasi bahwa pesanan sudah benar sebelum menempatkannya. Untuk maksud lain, seperti maksud yang hanya menanggapi pertanyaan pengguna, Anda mungkin tidak perlu meminta konfirmasi kepada pengguna sebelum memberikan informasi. Anda harus menyediakan keduanya `rejectionStatement` dan`confirmationPrompt`, atau tidak. Tipe: Objek [Prompt](API_Prompt.md) Wajib: Tidak ** [createVersion](#API_PutIntent_RequestSyntax) ** Ketika disetel ke `true` versi bernomor baru dari intent dibuat. Ini sama dengan memanggil `CreateIntentVersion` operasi. Jika Anda tidak menentukan`createVersion`, defaultnya adalah`false`. Tipe: Boolean Wajib: Tidak ** [description](#API_PutIntent_RequestSyntax) ** Deskripsi niat. Tipe: String Batasan Panjang: Panjang minimum 0. Panjang maksimum 200. Wajib: Tidak ** [dialogCodeHook](#API_PutIntent_RequestSyntax) ** Menentukan fungsi Lambda untuk memanggil untuk setiap input pengguna. Anda dapat memanggil fungsi Lambda ini untuk mempersonalisasi interaksi pengguna. Misalnya, bot Anda menentukan bahwa penggunanya adalah John. Fungsi Lambda Anda mungkin mengambil informasi John dari basis data backend dan mengisi beberapa nilai. Misalnya, jika Anda menemukan bahwa John tidak toleran terhadap gluten, Anda dapat mengatur slot maksud yang sesuai,`GlutenIntolerant`, ke true. Anda mungkin menemukan nomor telepon John dan mengatur atribut sesi yang sesuai. Tipe: Objek [CodeHook](API_CodeHook.md) Wajib: Tidak ** [followUpPrompt](#API_PutIntent_RequestSyntax) ** Amazon Lex menggunakan prompt ini untuk meminta aktivitas tambahan setelah memenuhi maksud. Misalnya, setelah `OrderPizza` intent terpenuhi, Anda dapat meminta pengguna untuk memesan minuman. Tindakan yang dilakukan Amazon Lex bergantung pada respons pengguna, sebagai berikut: + Jika pengguna mengatakan “Ya” itu merespons dengan prompt klarifikasi yang dikonfigurasi untuk bot. + jika pengguna mengatakan “Ya” dan melanjutkan dengan ucapan yang memicu maksud, ia memulai percakapan untuk maksud tersebut. + Jika pengguna mengatakan “Tidak” itu merespons dengan pernyataan penolakan yang dikonfigurasi untuk prompt tindak lanjut. + Jika tidak mengenali ucapannya, ia mengulangi prompt tindak lanjut lagi. `followUpPrompt`Bidang dan `conclusionStatement` lapangan saling eksklusif. Anda hanya dapat menentukan satu. Tipe: Objek [FollowUpPrompt](API_FollowUpPrompt.md) Wajib: Tidak ** [fulfillmentActivity](#API_PutIntent_RequestSyntax) ** Wajib. Menjelaskan bagaimana niat terpenuhi. Misalnya, setelah pengguna memberikan semua informasi untuk pesanan pizza, `fulfillmentActivity` mendefinisikan bagaimana bot melakukan pemesanan dengan toko pizza lokal. Anda dapat mengonfigurasi Amazon Lex untuk mengembalikan semua informasi intent ke aplikasi klien, atau mengarahkannya untuk memanggil fungsi Lambda yang dapat memproses intent (misalnya, melakukan pemesanan dengan restoran pizza). Tipe: Objek [FulfillmentActivity](API_FulfillmentActivity.md) Wajib: Tidak ** [inputContexts](#API_PutIntent_RequestSyntax) ** Larik `InputContext` objek yang mencantumkan konteks yang harus aktif untuk Amazon Lex untuk memilih maksud dalam percakapan dengan pengguna. Tipe: Array objek [InputContext](API_InputContext.md) Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 5 item. Wajib: Tidak ** [kendraConfiguration](#API_PutIntent_RequestSyntax) ** Informasi konfigurasi diperlukan untuk menggunakan `AMAZON.KendraSearchIntent` intent untuk menyambung ke indeks Amazon Kendra. Untuk informasi selengkapnya, lihat [AMAZON. KendraSearchIntent](https://docs.aws.amazon.com/lex/latest/dg/built-in-intent-kendra-search.html). Tipe: Objek [KendraConfiguration](API_KendraConfiguration.md) Wajib: Tidak ** [outputContexts](#API_PutIntent_RequestSyntax) ** Array `OutputContext` objek yang mencantumkan konteks yang mengaktifkan intent saat intent terpenuhi. Tipe: Array objek [OutputContext](API_OutputContext.md) Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 10 item. Wajib: Tidak ** [parentIntentSignature](#API_PutIntent_RequestSyntax) ** Pengidentifikasi unik untuk maksud bawaan yang menjadi dasar maksud ini. Untuk menemukan tanda tangan untuk intent, lihat [Intent Bawaan Standar](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/standard-intents) di *Alexa* Skills Kit. Tipe: String Wajib: Tidak ** [rejectionStatement](#API_PutIntent_RequestSyntax) ** Ketika pengguna menjawab “tidak” untuk pertanyaan yang didefinisikan dalam`confirmationPrompt`, Amazon Lex merespons dengan pernyataan ini untuk mengakui bahwa maksud tersebut dibatalkan. Anda harus menyediakan keduanya `rejectionStatement` dan`confirmationPrompt`, atau tidak. Tipe: Objek [Statement](API_Statement.md) Wajib: Tidak ** [sampleUtterances](#API_PutIntent_RequestSyntax) ** Array ucapan (string) yang mungkin dikatakan pengguna untuk memberi sinyal maksud. Misalnya, “Saya ingin \$1PizzaSize\$1 pizza”, “Pesan \$1Kuantitas\$1 \$1PizzaSize\$1 pizza”. Dalam setiap ucapan, nama slot dilampirkan dalam kurung kurawal. Tipe: Array string Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1500 item. Batasan Panjang: Panjang minimum 1. Panjang maksimum 200. Wajib: Tidak ** [slots](#API_PutIntent_RequestSyntax) ** Sebuah array slot niat. Saat runtime, Amazon Lex memperoleh nilai slot yang diperlukan dari pengguna menggunakan petunjuk yang ditentukan dalam slot. Untuk informasi selengkapnya, lihat [Amazon Lex: Cara Kerjanya](how-it-works.md). Tipe: Array objek [Slot](API_Slot.md) Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 100 item. Wajib: Tidak ## Sintaksis Respons ``` HTTP/1.1 200 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, "createVersion": boolean, "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 respons HTTP 200. Layanan mengembalikan data berikut dalam format JSON. ** [checksum](#API_PutIntent_ResponseSyntax) ** Checksum `$LATEST` versi maksud yang dibuat atau diperbarui. Tipe: String ** [conclusionStatement](#API_PutIntent_ResponseSyntax) ** Setelah fungsi Lambda yang ditentukan dalam `fulfillmentActivity` intent memenuhi intent, Amazon Lex menyampaikan pernyataan ini kepada pengguna. Tipe: Objek [Statement](API_Statement.md) ** [confirmationPrompt](#API_PutIntent_ResponseSyntax) ** Jika didefinisikan dalam maksud, Amazon Lex meminta pengguna untuk mengonfirmasi maksud sebelum memenuhinya. Tipe: Objek [Prompt](API_Prompt.md) ** [createdDate](#API_PutIntent_ResponseSyntax) ** Tanggal dimana niat itu dibuat. Tipe: Timestamp ** [createVersion](#API_PutIntent_ResponseSyntax) ** `True`jika versi baru dari intent telah dibuat. Jika `createVersion` bidang tidak ditentukan dalam permintaan, `createVersion` bidang diatur ke false dalam respons. Jenis: Boolean ** [description](#API_PutIntent_ResponseSyntax) ** Deskripsi niat. Tipe: String Batasan Panjang: Panjang minimum 0. Panjang maksimum 200. ** [dialogCodeHook](#API_PutIntent_ResponseSyntax) ** Jika didefinisikan dalam intent, Amazon Lex memanggil fungsi Lambda ini untuk setiap input pengguna. Tipe: Objek [CodeHook](API_CodeHook.md) ** [followUpPrompt](#API_PutIntent_ResponseSyntax) ** Jika didefinisikan dalam intent, Amazon Lex menggunakan prompt ini untuk meminta aktivitas pengguna tambahan setelah intent terpenuhi. Tipe: Objek [FollowUpPrompt](API_FollowUpPrompt.md) ** [fulfillmentActivity](#API_PutIntent_ResponseSyntax) ** Jika didefinisikan dalam intent, Amazon Lex memanggil fungsi Lambda ini untuk memenuhi intent setelah pengguna memberikan semua informasi yang diperlukan oleh intent. Tipe: Objek [FulfillmentActivity](API_FulfillmentActivity.md) ** [inputContexts](#API_PutIntent_ResponseSyntax) ** Larik `InputContext` objek yang mencantumkan konteks yang harus aktif untuk Amazon Lex untuk memilih maksud dalam percakapan dengan pengguna. Tipe: Array objek [InputContext](API_InputContext.md) Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 5 item. ** [kendraConfiguration](#API_PutIntent_ResponseSyntax) ** Informasi konfigurasi, jika ada, diperlukan untuk terhubung ke indeks Amazon Kendra dan menggunakan intent. `AMAZON.KendraSearchIntent` Tipe: Objek [KendraConfiguration](API_KendraConfiguration.md) ** [lastUpdatedDate](#API_PutIntent_ResponseSyntax) ** Tanggal dimana intent diperbarui. Saat Anda membuat sumber daya, tanggal pembuatan dan tanggal pembaruan terakhir adalah sama. Tipe: Timestamp ** [name](#API_PutIntent_ResponseSyntax) ** Nama niat. Tipe: String Panjang Batasan: Panjang minimum 1. Panjang maksimum 100. Pola: `^([A-Za-z]_?)+$` ** [outputContexts](#API_PutIntent_ResponseSyntax) ** Array `OutputContext` objek yang mencantumkan konteks yang mengaktifkan intent saat intent terpenuhi. Tipe: Array objek [OutputContext](API_OutputContext.md) Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 10 item. ** [parentIntentSignature](#API_PutIntent_ResponseSyntax) ** Pengidentifikasi unik untuk maksud bawaan yang menjadi dasar maksud ini. Tipe: String ** [rejectionStatement](#API_PutIntent_ResponseSyntax) ** Jika pengguna menjawab “tidak” untuk pertanyaan yang didefinisikan di `confirmationPrompt` Amazon Lex merespons dengan pernyataan ini untuk mengakui bahwa maksud tersebut dibatalkan. Tipe: Objek [Statement](API_Statement.md) ** [sampleUtterances](#API_PutIntent_ResponseSyntax) ** Array 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](#API_PutIntent_ResponseSyntax) ** Sebuah array slot intent yang dikonfigurasi untuk maksud. Tipe: Array objek [Slot](API_Slot.md) Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 100 item. ** [version](#API_PutIntent_ResponseSyntax) ** Versi maksudnya. Untuk maksud baru, versinya selalu`$LATEST`. Tipe: 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 bahasa khusus AWS SDKs, lihat berikut ini: + [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutIntent) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutIntent) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutIntent) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutIntent) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutIntent) + [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutIntent) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutIntent) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutIntent) + [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutIntent) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutIntent)