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.
# GetUtterancesView
Gunakan `GetUtterancesView` operasi untuk mendapatkan informasi tentang ucapan yang telah dibuat pengguna Anda ke bot Anda. Anda dapat menggunakan daftar ini untuk menyetel ucapan yang ditanggapi bot Anda.
Misalnya, katakan bahwa Anda telah membuat bot untuk memesan bunga. Setelah pengguna Anda menggunakan bot Anda untuk sementara waktu, gunakan `GetUtterancesView` operasi untuk melihat permintaan yang telah mereka buat dan apakah mereka telah berhasil. Anda mungkin menemukan bahwa ucapan “Saya ingin bunga” tidak dikenali. Anda dapat menambahkan ucapan ini ke `OrderFlowers` maksud sehingga bot Anda mengenali ucapan itu.
Setelah Anda menerbitkan versi baru bot, Anda bisa mendapatkan informasi tentang versi lama dan yang baru sehingga Anda dapat membandingkan kinerja di kedua versi.
Statistik ucapan dihasilkan sekali sehari. Data tersedia selama 15 hari terakhir. Anda dapat meminta informasi hingga 5 versi bot Anda di setiap permintaan. Amazon Lex mengembalikan ucapan yang paling sering diterima oleh bot dalam 15 hari terakhir. Respons berisi informasi tentang maksimum 100 ucapan untuk setiap versi.
Statistik ucapan tidak dihasilkan dalam kondisi berikut:
+ `childDirected`Bidang disetel ke true saat bot dibuat.
+ Anda menggunakan slot obfuscation dengan satu atau lebih slot.
+ Anda memilih untuk tidak berpartisipasi dalam meningkatkan Amazon Lex.
Operasi ini memerlukan izin utuk tindakan `lex:GetUtterancesView`.
## Minta Sintaks
```
GET /bots/botname/utterances?view=aggregation&bot_versions=botVersions&status_type=statusType HTTP/1.1
```
## Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
** [botname](#API_GetUtterancesView_RequestSyntax) **
Nama bot yang informasi ucapannya harus dikembalikan.
Kendala Panjang: Panjang minimum 2. Panjang maksimum 50.
Pola: `^([A-Za-z]_?)+$`
Wajib: Ya
** [botVersions](#API_GetUtterancesView_RequestSyntax) **
Array versi bot yang informasi ucapannya harus dikembalikan. Batasnya adalah 5 versi per permintaan.
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 5 item.
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola: `\$LATEST|[0-9]+`
Wajib: Ya
** [statusType](#API_GetUtterancesView_RequestSyntax) **
Untuk mengembalikan ucapan yang diakui dan ditangani, gunakan. `Detected` Untuk mengembalikan ucapan yang tidak dikenali, gunakan. `Missed`
Nilai yang Valid: `Detected | Missed`
Wajib: Ya
## Isi Permintaan
Permintaan tidak memiliki isi permintaan.
## Sintaks Respons
```
HTTP/1.1 200
Content-type: application/json
{
"botName": "string",
"utterances": [
{
"botVersion": "string",
"utterances": [
{
"count": number,
"distinctUsers": number,
"firstUtteredDate": number,
"lastUtteredDate": number,
"utteranceString": "string"
}
]
}
]
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [botName](#API_GetUtterancesView_ResponseSyntax) **
Nama bot yang informasi ucapannya dikembalikan.
Tipe: String
Kendala Panjang: Panjang minimum 2. Panjang maksimum 50.
Pola: `^([A-Za-z]_?)+$`
** [utterances](#API_GetUtterancesView_ResponseSyntax) **
Array [UtteranceList](API_UtteranceList.md) objek, masing-masing berisi daftar [UtteranceData](API_UtteranceData.md) objek yang menggambarkan ucapan yang diproses oleh bot Anda. Respons berisi maksimal 100 `UtteranceData` objek untuk setiap versi. Amazon Lex mengembalikan ucapan yang paling sering diterima oleh bot dalam 15 hari terakhir.
Tipe: Array objek [UtteranceList](API_UtteranceList.md)
## 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
** 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
## 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/GetUtterancesView)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetUtterancesView)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetUtterancesView)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetUtterancesView)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetUtterancesView)
+ [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetUtterancesView)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetUtterancesView)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetUtterancesView)
+ [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetUtterancesView)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetUtterancesView)