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. # PostText Mengirim masukan pengguna ke Amazon Lex. Aplikasi klien dapat menggunakan API ini untuk mengirim permintaan ke Amazon Lex saat runtime. Amazon Lex kemudian menafsirkan input pengguna menggunakan model pembelajaran mesin yang dibuatnya untuk bot. Sebagai tanggapan, Amazon Lex mengembalikan yang berikutnya `message` untuk menyampaikan kepada pengguna opsional `responseCard` untuk ditampilkan. Perhatikan contoh pesan berikut: + Untuk masukan pengguna “Saya ingin pizza”, Amazon Lex mungkin mengembalikan respons dengan pesan yang memunculkan data slot (misalnya, PizzaSize): “Pizza ukuran apa yang Anda inginkan?” + Setelah pengguna memberikan semua informasi pesanan pizza, Amazon Lex mungkin mengembalikan tanggapan dengan pesan untuk mendapatkan konfirmasi pengguna “Lanjutkan dengan pesanan pizza?”. + Setelah pengguna membalas prompt konfirmasi dengan “ya”, Amazon Lex mungkin mengembalikan pernyataan kesimpulan: “Terima kasih, pizza keju Anda telah dipesan.” Tidak semua pesan Amazon Lex memerlukan respons pengguna. Misalnya, pernyataan kesimpulan tidak memerlukan tanggapan. Beberapa pesan hanya memerlukan respons pengguna “ya” atau “tidak”. Selain itu`message`, Amazon Lex menyediakan konteks tambahan tentang pesan dalam respons yang mungkin Anda gunakan untuk meningkatkan perilaku klien, misalnya, untuk menampilkan antarmuka pengguna klien yang sesuai. Ini adalah`slotToElicit`,`dialogState`,`intentName`, dan `slots` bidang dalam tanggapan. Pertimbangkan contoh berikut: + Jika pesannya adalah untuk mendapatkan data slot, Amazon Lex mengembalikan informasi konteks berikut: + `dialogState`diatur ke ElicitSlot + `intentName`disetel ke nama maksud dalam konteks saat ini + `slotToElicit`atur ke nama slot `message` yang mendapatkan informasi + `slots`disetel ke peta slot, dikonfigurasi untuk maksud, dengan nilai yang diketahui saat ini + Jika pesan adalah prompt konfirmasi, `dialogState` diatur ke ConfirmIntent dan `SlotToElicit` diatur ke null. + Jika pesan adalah prompt klarifikasi (dikonfigurasi untuk maksud) yang menunjukkan bahwa maksud pengguna tidak dipahami, maka akan disetel ke ElicitIntent dan `dialogState` `slotToElicit` disetel ke null. Selain itu, Amazon Lex juga mengembalikan aplikasi khusus `sessionAttributes` Anda. Untuk informasi selengkapnya, lihat [Mengelola Konteks Percakapan](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html). ## Minta Sintaks ``` POST /bot/botName/alias/botAlias/user/userId/text HTTP/1.1 Content-type: application/json { "activeContexts": [ { "name": "string", "parameters": { "string" : "string" }, "timeToLive": { "timeToLiveInSeconds": number, "turnsToLive": number } } ], "inputText": "string", "requestAttributes": { "string" : "string" }, "sessionAttributes": { "string" : "string" } } ``` ## Parameter Permintaan URI Permintaan menggunakan parameter URI berikut. ** [botAlias](#API_runtime_PostText_RequestSyntax) ** Alias bot Amazon Lex. Wajib: Ya ** [botName](#API_runtime_PostText_RequestSyntax) ** Nama bot Amazon Lex. Wajib: Ya ** [userId](#API_runtime_PostText_RequestSyntax) ** ID pengguna aplikasi klien. Amazon Lex menggunakan ini untuk mengidentifikasi percakapan pengguna dengan bot Anda. Saat runtime, setiap permintaan harus berisi `userID` bidang. Untuk memutuskan ID pengguna yang akan digunakan untuk aplikasi Anda, pertimbangkan faktor-faktor berikut. + `userID`Bidang tidak boleh berisi informasi pribadi pengguna, misalnya, nama, nomor identifikasi pribadi, atau informasi pribadi pengguna akhir lainnya. + Jika Anda ingin pengguna memulai percakapan di satu perangkat dan melanjutkan di perangkat lain, gunakan pengenal khusus pengguna. + Jika Anda ingin pengguna yang sama dapat melakukan dua percakapan independen di dua perangkat yang berbeda, pilih pengenal khusus perangkat. + Pengguna tidak dapat melakukan dua percakapan independen dengan dua versi berbeda dari bot yang sama. Misalnya, pengguna tidak dapat melakukan percakapan dengan versi PROD dan BETA dari bot yang sama. Jika Anda mengantisipasi bahwa pengguna perlu melakukan percakapan dengan dua versi yang berbeda, misalnya, saat menguji, sertakan alias bot di ID pengguna untuk memisahkan dua percakapan. Kendala Panjang: Panjang minimum 2. Panjang maksimum 100. Pola: `[0-9a-zA-Z._:-]+` Wajib: Ya ## Isi Permintaan Permintaan menerima data berikut dalam format JSON. ** [activeContexts](#API_runtime_PostText_RequestSyntax) ** Daftar konteks yang aktif untuk permintaan. Konteks dapat diaktifkan ketika maksud sebelumnya terpenuhi, atau dengan memasukkan konteks dalam permintaan, Jika Anda tidak menentukan daftar konteks, Amazon Lex akan menggunakan daftar konteks saat ini untuk sesi tersebut. Jika Anda menentukan daftar kosong, semua konteks untuk sesi akan dihapus. Tipe: Array objek [ActiveContext](API_runtime_ActiveContext.md) Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 20 item. Wajib: Tidak ** [inputText](#API_runtime_PostText_RequestSyntax) ** Teks yang dimasukkan pengguna (Amazon Lex menafsirkan teks ini). Saat Anda menggunakan AWS CLI, Anda tidak dapat meneruskan URL dalam parameter. `--input-text` Lulus URL menggunakan `--cli-input-json` parameter sebagai gantinya. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024. Wajib: Ya ** [requestAttributes](#API_runtime_PostText_RequestSyntax) ** Informasi khusus permintaan diteruskan antara Amazon Lex dan aplikasi klien. Namespace dicadangkan `x-amz-lex:` untuk atribut khusus. Jangan membuat atribut permintaan apa pun dengan awalan`x-amz-lex:`. Untuk informasi selengkapnya, lihat [Menyetel Atribut Permintaan](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-request-attribs). Tipe: Peta antar string Wajib: Tidak ** [sessionAttributes](#API_runtime_PostText_RequestSyntax) ** Informasi khusus aplikasi diteruskan antara Amazon Lex dan aplikasi klien. Untuk informasi selengkapnya, lihat [Menyetel Atribut Sesi](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-attribs). Tipe: Peta antar string Wajib: Tidak ## Sintaksis Respons ``` HTTP/1.1 200 Content-type: application/json { "activeContexts": [ { "name": "string", "parameters": { "string" : "string" }, "timeToLive": { "timeToLiveInSeconds": number, "turnsToLive": number } } ], "alternativeIntents": [ { "intentName": "string", "nluIntentConfidence": { "score": number }, "slots": { "string" : "string" } } ], "botVersion": "string", "dialogState": "string", "intentName": "string", "message": "string", "messageFormat": "string", "nluIntentConfidence": { "score": number }, "responseCard": { "contentType": "string", "genericAttachments": [ { "attachmentLinkUrl": "string", "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subTitle": "string", "title": "string" } ], "version": "string" }, "sentimentResponse": { "sentimentLabel": "string", "sentimentScore": "string" }, "sessionAttributes": { "string" : "string" }, "sessionId": "string", "slots": { "string" : "string" }, "slotToElicit": "string" } ``` ## Elemen Respons Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200. Layanan mengembalikan data berikut dalam format JSON. ** [activeContexts](#API_runtime_PostText_ResponseSyntax) ** Daftar konteks aktif untuk sesi tersebut. Konteks dapat diatur ketika maksud terpenuhi atau dengan memanggil`PostContent`,`PostText`, atau `PutSession` operasi. Anda dapat menggunakan konteks untuk mengontrol maksud yang dapat menindaklanjuti intent, atau untuk memodifikasi operasi aplikasi Anda. Tipe: Array objek [ActiveContext](API_runtime_ActiveContext.md) Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 20 item. ** [alternativeIntents](#API_runtime_PostText_ResponseSyntax) ** Satu hingga empat maksud alternatif yang mungkin berlaku untuk maksud pengguna. Setiap alternatif menyertakan skor yang menunjukkan seberapa yakin Amazon Lex bahwa maksud tersebut cocok dengan maksud pengguna. Maksud diurutkan berdasarkan skor kepercayaan. Tipe: Array objek [PredictedIntent](API_runtime_PredictedIntent.md) Anggota Array: Jumlah maksimum 4 item. ** [botVersion](#API_runtime_PostText_ResponseSyntax) ** Versi bot yang menanggapi percakapan. Anda dapat menggunakan informasi ini untuk membantu menentukan apakah satu versi bot berkinerja lebih baik daripada versi lain. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64. Pola: `[0-9]+|\$LATEST` ** [dialogState](#API_runtime_PostText_ResponseSyntax) ** Mengidentifikasi keadaan interaksi pengguna saat ini. Amazon Lex mengembalikan salah satu nilai berikut sebagai`dialogState`. Klien secara opsional dapat menggunakan informasi ini untuk menyesuaikan antarmuka pengguna. + `ElicitIntent`- Amazon Lex ingin mendapatkan niat pengguna. Misalnya, pengguna mungkin mengucapkan maksud (“Saya ingin memesan pizza”). Jika Amazon Lex tidak dapat menyimpulkan maksud pengguna dari ucapan ini, Amazon Lex akan mengembalikan DialogState ini. + `ConfirmIntent`- Amazon Lex mengharapkan respons “ya” atau “tidak”. Misalnya, Amazon Lex menginginkan konfirmasi pengguna sebelum memenuhi maksud. Alih-alih “ya” atau “tidak” sederhana, pengguna mungkin merespons dengan informasi tambahan. Misalnya, “ya, tapi buatlah pizza kerak kental” atau “tidak, saya ingin memesan minuman”. Amazon Lex dapat memproses informasi tambahan tersebut (dalam contoh ini, memperbarui nilai slot tipe kerak, atau mengubah maksud dari OrderPizza ke OrderDrink). + `ElicitSlot`- Amazon Lex mengharapkan nilai slot untuk maksud saat ini. Misalnya, anggaplah dalam tanggapannya Amazon Lex mengirim pesan ini: “Berapa ukuran pizza yang Anda inginkan?”. Seorang pengguna mungkin membalas dengan nilai slot (misalnya, “medium”). Pengguna mungkin juga memberikan informasi tambahan dalam tanggapan (misalnya, “pizza kerak tebal sedang”). Amazon Lex dapat memproses informasi tambahan tersebut dengan tepat. + `Fulfilled`- Menyampaikan bahwa fungsi Lambda yang dikonfigurasi untuk maksud telah berhasil memenuhi intent. + `ReadyForFulfillment`- Menyampaikan bahwa klien harus memenuhi niat. + `Failed`- Menyampaikan bahwa percakapan dengan pengguna gagal. Hal ini dapat terjadi karena berbagai alasan termasuk bahwa pengguna tidak memberikan respons yang sesuai terhadap permintaan dari layanan (Anda dapat mengonfigurasi berapa kali Amazon Lex dapat meminta pengguna untuk informasi tertentu), atau fungsi Lambda gagal memenuhi intent. Tipe: String Nilai yang Valid: `ElicitIntent | ConfirmIntent | ElicitSlot | Fulfilled | ReadyForFulfillment | Failed` ** [intentName](#API_runtime_PostText_ResponseSyntax) ** Maksud pengguna saat ini yang diketahui Amazon Lex. Tipe: String ** [message](#API_runtime_PostText_ResponseSyntax) ** Pesan untuk disampaikan kepada pengguna. Pesan dapat berasal dari konfigurasi bot atau dari fungsi Lambda. Jika intent tidak dikonfigurasi dengan fungsi Lambda, atau jika fungsi Lambda `Delegate` ditampilkan sebagai `dialogAction.type` responsnya, Amazon Lex memutuskan tindakan berikutnya dan memilih pesan yang sesuai dari konfigurasi bot berdasarkan konteks interaksi saat ini. Misalnya, jika Amazon Lex tidak dapat memahami masukan pengguna, Amazon Lex menggunakan pesan prompt klarifikasi. Saat membuat maksud, Anda dapat menetapkan pesan ke grup. Ketika pesan ditetapkan ke grup Amazon Lex mengembalikan satu pesan dari setiap grup dalam respons. Bidang pesan adalah string JSON yang lolos yang berisi pesan. Untuk informasi lebih lanjut tentang struktur string JSON yang dikembalikan, lihat[Format Pesan yang Didukung](howitworks-manage-prompts.md#msg-prompts-formats). Jika fungsi Lambda mengembalikan pesan, Amazon Lex meneruskannya ke klien dalam responsnya. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024. ** [messageFormat](#API_runtime_PostText_ResponseSyntax) ** Format pesan respons. Salah satu nilai berikut: + `PlainText`- Pesan berisi teks UTF-8 biasa. + `CustomPayload`- Pesan adalah format khusus yang ditentukan oleh fungsi Lambda. + `SSML`- Pesan berisi teks yang diformat untuk output suara. + `Composite`- Pesan berisi objek JSON yang lolos yang berisi satu atau beberapa pesan dari grup tempat pesan ditetapkan saat maksud dibuat. Tipe: String Nilai yang Valid: `PlainText | CustomPayload | SSML | Composite` ** [nluIntentConfidence](#API_runtime_PostText_ResponseSyntax) ** Memberikan skor yang menunjukkan seberapa yakin Amazon Lex bahwa intent yang dikembalikan adalah yang cocok dengan maksud pengguna. Skornya antara 0,0 dan 1,0. Untuk informasi lebih lanjut, lihat [Skor Keyakinan](https://docs.aws.amazon.com/lex/latest/dg/confidence-scores.html). Skor adalah skor relatif, bukan skor absolut. Skor dapat berubah berdasarkan peningkatan Amazon Lex. Tipe: Objek [IntentConfidence](API_runtime_IntentConfidence.md) ** [responseCard](#API_runtime_PostText_ResponseSyntax) ** Merupakan opsi yang harus ditanggapi pengguna terhadap prompt saat ini. Kartu Respons dapat berasal dari konfigurasi bot (di konsol Amazon Lex, pilih tombol pengaturan di sebelah slot) atau dari kait kode (fungsi Lambda). Tipe: Objek [ResponseCard](API_runtime_ResponseCard.md) ** [sentimentResponse](#API_runtime_PostText_ResponseSyntax) ** Sentimen yang diungkapkan dan diucapkan. Ketika bot dikonfigurasi untuk mengirim ucapan ke Amazon Comprehend untuk analisis sentimen, bidang ini berisi hasil analisis. Tipe: Objek [SentimentResponse](API_runtime_SentimentResponse.md) ** [sessionAttributes](#API_runtime_PostText_ResponseSyntax) ** Peta pasangan nilai kunci yang mewakili informasi konteks khusus sesi. Tipe: Peta string ke string ** [sessionId](#API_runtime_PostText_ResponseSyntax) ** Pengenal unik untuk sesi tersebut. Tipe: String ** [slots](#API_runtime_PostText_ResponseSyntax) ** Slot maksud yang dideteksi Amazon Lex dari input pengguna dalam percakapan. Amazon Lex membuat daftar resolusi yang berisi kemungkinan nilai untuk slot. Nilai yang dikembalikan ditentukan oleh yang `valueSelectionStrategy` dipilih ketika jenis slot dibuat atau diperbarui. Jika `valueSelectionStrategy` diatur ke`ORIGINAL_VALUE`, nilai yang diberikan oleh pengguna dikembalikan, jika nilai pengguna mirip dengan nilai slot. Jika `valueSelectionStrategy` diatur ke `TOP_RESOLUTION` Amazon Lex mengembalikan nilai pertama dalam daftar resolusi atau, jika tidak ada daftar resolusi, null. Jika Anda tidak menentukan a`valueSelectionStrategy`, defaultnya adalah`ORIGINAL_VALUE`. Tipe: Peta string ke string ** [slotToElicit](#API_runtime_PostText_ResponseSyntax) ** Jika `dialogState` nilainya`ElicitSlot`, mengembalikan nama slot yang Amazon Lex memunculkan nilai. Tipe: String ## Kesalahan ** BadGatewayException ** Entah bot Amazon Lex masih dibangun, atau salah satu layanan dependen (Amazon Polly, AWS Lambda) gagal dengan kesalahan layanan internal. Kode Status HTTP: 502 ** BadRequestException ** Validasi permintaan gagal, tidak ada pesan yang dapat digunakan dalam konteksnya, atau pembuatan bot gagal, masih dalam proses, atau berisi perubahan yang belum dibangun. Kode Status HTTP: 400 ** ConflictException ** Dua klien menggunakan akun AWS yang sama, bot Amazon Lex, dan ID pengguna. Kode Status HTTP: 409 ** DependencyFailedException ** Salah satu dependensi, seperti AWS Lambda atau Amazon Polly, memberikan pengecualian. Misalnya, + Jika Amazon Lex tidak memiliki izin yang cukup untuk memanggil fungsi Lambda. + Jika fungsi Lambda membutuhkan waktu lebih dari 30 detik untuk dijalankan. + Jika fungsi Lambda pemenuhan mengembalikan `Delegate` tindakan dialog tanpa menghapus nilai slot apa pun. Kode Status HTTP: 424 ** InternalFailureException ** Kesalahan layanan internal. Coba lagi panggilannya. Kode Status HTTP: 500 ** LimitExceededException ** Melebihi batas. Kode Status HTTP: 429 ** LoopDetectedException ** Pengecualian ini tidak digunakan. Kode Status HTTP: 508 ** NotFoundException ** Sumber daya (seperti bot Amazon Lex atau alias) yang disebut tidak ditemukan. Kode Status HTTP: 404 ## 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/runtime.lex-2016-11-28/PostText) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/runtime.lex-2016-11-28/PostText) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/runtime.lex-2016-11-28/PostText) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/runtime.lex-2016-11-28/PostText) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/runtime.lex-2016-11-28/PostText) + [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/runtime.lex-2016-11-28/PostText) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/runtime.lex-2016-11-28/PostText) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/runtime.lex-2016-11-28/PostText) + [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/runtime.lex-2016-11-28/PostText) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/runtime.lex-2016-11-28/PostText)