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:

• childDirectedBidang 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

Nama bot yang informasi ucapannya harus dikembalikan.

Kendala Panjang: Panjang minimum 2. Panjang maksimum 50.

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

Diperlukan: Ya

botVersions

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]+

Diperlukan: Ya

statusType

Untuk mengembalikan ucapan yang diakui dan ditangani, gunakan. Detected Untuk mengembalikan ucapan yang tidak dikenali, gunakan. Missed

Nilai yang Valid: Detected | Missed

Diperlukan: 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

Nama bot yang informasi ucapannya dikembalikan.

Jenis: String

Kendala Panjang: Panjang minimum 2. Panjang maksimum 50.

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

utterances

Array UtteranceList objek, masing-masing berisi daftar UtteranceData 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

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 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