Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mencatat percakapan dengan log percakapan di Lex V2
Anda mengaktifkan *log percakapan* untuk menyimpan interaksi bot. Anda dapat menggunakan log ini untuk meninjau kinerja bot Anda dan untuk memecahkan masalah dengan percakapan. Anda dapat mencatat teks untuk [RecognizeText](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeText.html)operasi. Anda dapat mencatat teks dan audio untuk [RecognizeUtterance](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeUtterance.html)operasi. Dengan mengaktifkan log percakapan, Anda mendapatkan tampilan terperinci tentang percakapan yang dimiliki pengguna dengan bot Anda.
Misalnya, sesi dengan bot Anda memiliki ID sesi. Anda dapat menggunakan ID ini untuk mendapatkan transkrip percakapan termasuk ucapan pengguna dan respons bot yang sesuai. Anda juga mendapatkan metadata seperti nama maksud dan nilai slot untuk ucapan.
**catatan**
Anda tidak dapat menggunakan log percakapan dengan bot yang tunduk pada Undang-Undang Perlindungan Privasi Online Anak-anak (COPPA).
Log percakapan dikonfigurasi untuk alias. Setiap alias dapat memiliki pengaturan yang berbeda untuk teks dan log audio mereka. Anda dapat mengaktifkan log teks, log audio, atau keduanya untuk setiap alias. Log teks menyimpan input teks, transkrip input audio, dan metadata terkait di Log. CloudWatch Log audio menyimpan input audio di Amazon S3. Anda dapat mengaktifkan enkripsi log teks dan audio menggunakan AWS KMS pelanggan yang dikelola CMKs.
Untuk mengkonfigurasi logging, gunakan konsol atau [UpdateBotAlias](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateBotAlias.html)operasi [CreateBotAlias](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBotAlias.html)atau. Setelah mengaktifkan log percakapan untuk alias, gunakan [RecognizeUtterance](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeUtterance.html)operasi [RecognizeText](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeText.html)atau untuk alias tersebut mencatat ucapan teks atau audio dalam grup log Log yang dikonfigurasi atau bucket CloudWatch S3.
**Topics**
+ [Kebijakan IAM untuk Log Percakapan](conversation-logs-policies.md)
+ [Mengkonfigurasi log percakapan untuk bot Lex V2 Anda](conversation-logs-configure.md)
+ [Melihat log teks di Amazon CloudWatch Logs dari Lex V2](conversation-logs-cw.md)
+ [Mengakses log audio di Amazon S3](conversation-logs-s3.md)
+ [Memantau status log percakapan dengan CloudWatch metrik](conversation-logs-monitoring.md)
# Kebijakan IAM untuk Log Percakapan
Bergantung pada jenis logging yang Anda pilih, Amazon Lex V2 memerlukan izin untuk menggunakan Amazon CloudWatch Logs dan Amazon Simple Storage Service (S3) bucket untuk menyimpan log Anda. Anda harus membuat peran dan izin AWS Identity and Access Management untuk mengaktifkan Amazon Lex V2 mengakses sumber daya ini.
## Membuat Peran dan Kebijakan IAM untuk Log Percakapan
Untuk mengaktifkan log percakapan, Anda harus memberikan izin menulis untuk CloudWatch Log dan Amazon S3. Jika Anda mengaktifkan enkripsi objek untuk objek S3 Anda, Anda harus memberikan izin akses ke AWS KMS kunci yang digunakan untuk mengenkripsi objek.
Anda dapat menggunakan konsol IAM, API IAM, atau AWS Command Line Interface untuk membuat peran dan kebijakan. Petunjuk ini menggunakan AWS CLI untuk membuat peran dan kebijakan.
**catatan**
Kode berikut diformat untuk Linux dan macOS. Untuk Windows, ganti karakter kelanjutan baris Linux (\$1) dengan tanda sisipan (^).
**Untuk membuat peran IAM untuk log percakapan**
1. Buat dokumen di direktori saat ini yang disebut**LexConversationLogsAssumeRolePolicyDocument.json**, tambahkan kode berikut ke dalamnya, dan simpan. Dokumen kebijakan ini menambahkan Amazon Lex V2 sebagai entitas tepercaya ke peran tersebut. Hal ini memungkinkan Amazon Lex V2 untuk mengambil peran untuk mengirimkan log ke sumber daya yang dikonfigurasi untuk log percakapan.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "lexv2.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
1. Di AWS CLI, jalankan perintah berikut untuk membuat peran IAM untuk log percakapan.
```
aws iam create-role \
--role-name role-name \
--assume-role-policy-document file://LexConversationLogsAssumeRolePolicyDocument.json
```
Selanjutnya, buat dan lampirkan kebijakan ke peran yang memungkinkan Amazon Lex V2 menulis ke CloudWatch Log.
**Untuk membuat kebijakan IAM untuk mencatat teks percakapan ke CloudWatch Log**
1. Buat dokumen di direktori saat ini yang disebut**LexConversationLogsCloudWatchLogsPolicy.json**, tambahkan kebijakan IAM berikut ke dalamnya, dan simpan.
1. Di AWS CLI, buat kebijakan IAM yang memberikan izin menulis ke grup log Log. CloudWatch
```
aws iam create-policy \
--policy-name cloudwatch-policy-name \
--policy-document file://LexConversationLogsCloudWatchLogsPolicy.json
```
1. Lampirkan kebijakan ke peran IAM yang Anda buat untuk log percakapan.
```
aws iam attach-role-policy \
--policy-arn arn:aws:iam::account-id:policy/cloudwatch-policy-name \
--role-name role-name
```
Jika Anda mencatat audio ke bucket S3, buat kebijakan yang memungkinkan Amazon Lex V2 menulis ke bucket.
**Untuk membuat kebijakan IAM untuk pencatatan audio ke bucket S3**
1. Buat dokumen di direktori saat ini yang disebut**LexConversationLogsS3Policy.json**, tambahkan kebijakan berikut ke dalamnya, dan simpan.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject"
],
"Resource": "arn:aws:s3:::bucket-name/*"
}
]
}
```
------
1. Di AWS CLI, buat kebijakan IAM yang memberikan izin menulis ke bucket S3 Anda.
```
aws iam create-policy \
--policy-name s3-policy-name \
--policy-document file://LexConversationLogsS3Policy.json
```
1. Lampirkan kebijakan ke peran yang Anda buat untuk log percakapan.
```
aws iam attach-role-policy \
--policy-arn arn:aws:iam::account-id:policy/s3-policy-name \
--role-name role-name
```
## Memberikan Izin untuk Lulus Peran IAM
Saat Anda menggunakan konsol, AWS SDK AWS Command Line Interface, atau AWS untuk menentukan peran IAM yang akan digunakan untuk log percakapan, pengguna yang menentukan peran IAM log percakapan harus memiliki izin untuk meneruskan peran tersebut ke Amazon Lex V2. Untuk mengizinkan pengguna meneruskan peran ke Amazon Lex V2, Anda harus memberikan `PassRole` izin kepada pengguna, peran, atau grup IAM pengguna.
Kebijakan berikut menentukan izin untuk diberikan kepada pengguna, peran, atau grup. Anda dapat menggunakan tombol `iam:AssociatedResourceArn` dan `iam:PassedToService` kondisi untuk membatasi ruang lingkup izin. Untuk informasi selengkapnya, lihat [Memberikan Izin Pengguna untuk Meneruskan Peran ke Layanan AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html) dan [IAM serta Kunci Konteks AWS STS Kondisi](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_iam-condition-keys.html) dalam Panduan Pengguna *AWS Identity and Access Management*.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "iam:PassRole",
"Resource": "arn:aws:iam::111122223333:role/role-name",
"Condition": {
"StringEquals": {
"iam:PassedToService": "lexv2.amazonaws.com"
},
"StringLike": {
"iam:AssociatedResourceARN": "arn:aws:lex:region:123456789012:bot:bot-name:bot-alias"
}
}
}
]
}
```
------
# Mengkonfigurasi log percakapan untuk bot Lex V2 Anda
Anda mengaktifkan dan menonaktifkan log percakapan menggunakan konsol atau `conversationLogSettings` bidang `UpdateBotAlias` operasi `CreateBotAlias` atau. Anda dapat mengaktifkan atau mematikan log audio, log teks, atau keduanya. Logging dimulai pada sesi bot baru. Perubahan pada setelan log tidak tercermin untuk sesi aktif.
Untuk menyimpan log teks, gunakan grup CloudWatch log Amazon Logs di akun AWS Anda. Anda dapat menggunakan grup log yang valid. Grup log harus berada di wilayah yang sama dengan bot Amazon Lex V2. Untuk informasi selengkapnya tentang membuat grup CloudWatch log Log, lihat [Bekerja dengan Grup Log dan Aliran Log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) di *Panduan Pengguna CloudWatch Log Amazon*.
Untuk menyimpan log audio, gunakan bucket Amazon S3 di akun AWS Anda. Anda dapat menggunakan bucket S3 yang valid. Bucket harus berada di wilayah yang sama dengan bot Amazon Lex V2. Untuk informasi selengkapnya tentang membuat bucket S3, lihat [Membuat bucket](https://docs.aws.amazon.com/AmazonS3/latest/gsg/CreatingABucket.html) di *Panduan Memulai Layanan Penyimpanan Sederhana Amazon*.
Saat Anda mengelola log percakapan menggunakan konsol, konsol akan memperbarui peran layanan Anda sehingga memiliki akses ke grup log dan bucket S3.
Jika Anda tidak menggunakan konsol, Anda harus memberikan peran IAM dengan kebijakan yang memungkinkan Amazon Lex V2 untuk menulis ke grup log atau bucket yang dikonfigurasi. Jika Anda membuat peran terkait layanan menggunakan AWS Command Line Interface, Anda harus menambahkan akhiran kustom ke peran menggunakan `custom-suffix` opsi seperti pada contoh berikut. Untuk informasi selengkapnya, lihat [Membuat Peran dan Kebijakan IAM untuk Log Percakapan](conversation-logs-policies.md#conversation-logs-role-and-policy).
```
aws iam create-service-linked-role \
--aws-service-name lexv2.amazon.aws.com \
--custom-suffix suffix
```
Peran IAM yang Anda gunakan untuk mengaktifkan log percakapan harus memiliki `iam:PassRole` izin. Kebijakan berikut harus dilampirkan pada peran:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "iam:PassRole",
"Resource": "arn:aws:iam::111122223333:role/role"
}
]
}
```
------
## Mengaktifkan log percakapan
**Untuk mengaktifkan log menggunakan konsol**
1. Buka konsol Amazon Lex V2 [https://console.aws.amazon.com/lexv2](https://console.aws.amazon.com/lexv2).
1. Dari daftar, pilih bot.
1. Dari menu sebelah kiri, pilih **Alias**.
1. Dalam daftar alias, pilih alias yang ingin Anda konfigurasikan log percakapan.
1. Di bagian **Log percakapan**, pilih **Kelola log percakapan**.
1. Untuk log teks, pilih **Aktifkan** lalu masukkan nama grup CloudWatch log Amazon Logs.
1. Untuk log audio, pilih **Aktifkan** lalu masukkan informasi bucket S3.
1. Tidak wajib. Untuk mengenkripsi log audio, pilih AWS KMS kunci yang akan digunakan untuk enkripsi.
1. Pilih **Simpan** untuk mulai mencatat percakapan. Jika perlu, Amazon Lex V2 akan memperbarui peran layanan Anda dengan izin untuk mengakses grup CloudWatch log Log dan bucket S3 yang dipilih.
## Menonaktifkan log percakapan di Lex V2
**Untuk mematikan log menggunakan konsol**
1. Buka konsol Amazon Lex V2 [https://console.aws.amazon.com/lexv2](https://console.aws.amazon.com/lexv2).
1. Dari daftar, pilih bot.
1. Dari menu sebelah kiri, pilih **Alias**.
1. Dalam daftar alias, pilih alias yang ingin Anda konfigurasikan log percakapan.
1. Di bagian **Log percakapan**, pilih **Kelola log percakapan**.
1. Nonaktifkan pencatatan teks, pencatatan audio, atau keduanya untuk mematikan logging.
1. Pilih **Simpan** untuk menghentikan pencatatan percakapan.
# Melihat log teks di Amazon CloudWatch Logs dari Lex V2
Amazon Lex V2 menyimpan log teks untuk percakapan Anda di Amazon CloudWatch Logs. Untuk melihat log, gunakan konsol CloudWatch Log atau API. Untuk informasi selengkapnya, lihat [Cari Data Log Menggunakan Pola Filter](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/SearchDataFilterPattern.html) dan [Sintaks Kueri Wawasan CloudWatch Log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html) di *Panduan Pengguna Amazon CloudWatch Logs*.
**Untuk melihat log menggunakan konsol Amazon Lex V2**
1. Buka konsol Amazon Lex V2 [https://console.aws.amazon.com/lexv2](https://console.aws.amazon.com/lexv2).
1. Dari daftar, pilih bot.
1. Dari menu sebelah kiri, pilih **Analytics**, lalu pilih **CloudWatch metrik**.
1. Lihat metrik untuk bot Anda di halaman **CloudWatch metrik**.
Anda juga dapat menggunakan CloudWatch konsol atau API untuk melihat entri log Anda. Untuk menemukan entri log, navigasikan ke grup log yang Anda konfigurasikan untuk alias. Anda dapat menemukan awalan aliran log untuk log Anda di konsol Amazon Lex V2 atau dengan menggunakan [DescribeBotAlias](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DescribeBotAlias.html)operasi.
Entri log untuk ucapan pengguna ditemukan di beberapa aliran log. Ucapan dalam percakapan memiliki entri di salah satu aliran log dengan awalan yang ditentukan. Entri dalam aliran log berisi informasi berikut:
versi pesan
Versi skema pesan.
bot
Detail tentang bot yang berinteraksi dengan pelanggan.
pesan
Tanggapan yang dikirim bot kembali ke pengguna.
UtteranceContext
Informasi tentang memproses ucapan ini.
+ `runtimeHints`—konteks runtime digunakan untuk mentranskripsikan dan menafsirkan masukan pengguna. Untuk informasi selengkapnya, lihat [Meningkatkan pengenalan nilai slot dengan petunjuk runtime dalam percakapan](using-hints.md).
+ `slotElicitationStyle`—Gaya elisitasi slot digunakan untuk menafsirkan input pengguna. Untuk informasi selengkapnya, lihat [Menangkap nilai slot dengan gaya ejaan selama percakapan](spelling-styles.md).
SessionState
Keadaan percakapan saat ini antara pengguna dan bot. Untuk informasi selengkapnya, lihat [Memahami percakapan bot Amazon Lex V2](managing-conversations.md).
interpretasi
Daftar maksud yang ditentukan Amazon Lex V2 dapat memuaskan ucapan pengguna. [Menggunakan skor kepercayaan diri untuk meningkatkan akurasi percakapan](confidence-scores.md).
InterpretasiSumber
Menunjukkan apakah slot diselesaikan oleh Amazon Lex V2 atau Amazon Bedrock. Nilai: Lex \$1 Bedrock
sessionId
Pengidentifikasi sesi pengguna yang melakukan percakapan.
inputTranscript
Transkripsi input dari pengguna.
+ Untuk input teks, ini adalah teks yang diketik pengguna. Untuk input DTMF, ini adalah kunci yang dimasukkan pengguna.
+ Untuk input ucapan, ini adalah teks yang digunakan Amazon Lex V2 untuk mengonversi ucapan pengguna untuk memanggil maksud atau mengisi slot.
rawInputTranscript
Transkrip mentah dari input pengguna sebelum pemrosesan teks diterapkan. Catatan: Pemrosesan teks hanya untuk lokal en-US dan en-GB.
transkripsi
Daftar transkripsi potensial dari input pengguna. Untuk informasi selengkapnya, lihat [Menggunakan skor kepercayaan transkripsi suara untuk meningkatkan percakapan dengan bot Lex V2 Anda](using-transcript-confidence-scores.md).
RawTranskripsi
Menggunakan skor kepercayaan transkripsi suara. Untuk informasi selengkapnya, lihat [Menggunakan skor kepercayaan transkripsi suara untuk meningkatkan percakapan dengan bot Lex V2 Anda](using-transcript-confidence-scores.md).
MisseDutterance
Menunjukkan apakah Amazon Lex V2 dapat mengenali ucapan pengguna.
requestId
Amazon Lex V2 menghasilkan ID permintaan untuk input pengguna.
timestamp
Stempel waktu input pengguna.
DeveloperOverride
Menunjukkan apakah alur percakapan diperbarui menggunakan hook kode dialog. Untuk informasi selengkapnya tentang menggunakan hook kode dialog, lihat[Mengintegrasikan AWS Lambda fungsi ke bot Amazon Lex V2 Anda](lambda.md).
InputMode
Menunjukkan jenis input. Bisa audio, DTMF, atau teks.
requestAttributes
Atribut permintaan yang digunakan saat memproses input pengguna.
AudioProperties
Jika log percakapan audio diaktifkan dan input pengguna dalam format audio, termasuk total durasi input audio, durasi suara dan durasi keheningan dalam audio. Ini juga termasuk tautan ke file audio.
BargeIn
Menunjukkan apakah input pengguna mengganggu respons bot sebelumnya.
ResponseReason
Alasan respons dihasilkan. Bisa menjadi salah satu dari:
+ `UtteranceResponse`— respon terhadap masukan pengguna
+ `StartTimeout`— respons yang dihasilkan server saat pengguna tidak memberikan masukan
+ `StillWaitingResponse`— respons yang dihasilkan server saat pengguna meminta bot menunggu
+ `FulfillmentInitiated`— respons yang dihasilkan server bahwa pemenuhan akan dimulai
+ `FulfillmentStartedResponse`— server menghasilkan respons bahwa pemenuhan telah dimulai
+ `FulfillmentUpdateResponse`— respons yang dihasilkan server berkala saat pemenuhan sedang berlangsung
+ `FulfillmentCompletedResponse`— respons yang dihasilkan server saat pemenuhan selesai.
operationName
API digunakan untuk berinteraksi dengan bot. Bisa menjadi salah satu`PutSession`,`RecognizeText`,`RecognizeUtterance`, atau`StartConversation`.
```
{
"message-version": "2.0",
"bot": {
"id": "string",
"name": "string",
"aliasId": "string",
"aliasName": "string",
"localeId": "string",
"version": "string"
},
"messages": [
{
"contentType": "PlainText | SSML | CustomPayload | ImageResponseCard",
"content": "string",
"imageResponseCard": {
"title": "string",
"subtitle": "string",
"imageUrl": "string",
"buttonsList": [
{
"text": "string",
"value": "string"
}
]
}
}
],
"utteranceContext": {
"activeRuntimeHints": {
"slotHints": {
"string": {
"string": {
"runtimeHintValues": [
{
"phrase": "string"
},
{
"phrase": "string"
}
]
}
}
}
},
"slotElicitationStyle": "string"
},
"sessionState": {
"dialogAction": {
"type": "Close | ConfirmIntent | Delegate | ElicitIntent | ElicitSlot",
"slotToElicit": "string"
},
"intent": {
"name": "string",
"slots": {
"string": {
"value": {
"interpretedValue": "string",
"originalValue": "string",
"resolvedValues": [ "string" ]
}
},
"string": {
"shape": "List",
"value": {
"originalValue": "string",
"interpretedValue": "string",
"resolvedValues": [ "string" ]
},
"values": [
{
"shape": "Scalar",
"value": {
"originalValue": "string",
"interpretedValue": "string",
"resolvedValues": [ "string" ]
}
},
{
"shape": "Scalar",
"value": {
"originalValue": "string",
"interpretedValue": "string",
"resolvedValues": [ "string" ]
}
}
]
}
},
"kendraResponse": {
// Only present when intent is KendraSearchIntent. For details, see
// https://docs.aws.amazon.com/kendra/latest/dg/API_Query.html#API_Query_ResponseSyntax
},
"state": "InProgress | ReadyForFulfillment | Fulfilled | Failed",
"confirmationState": "Confirmed | Denied | None"
},
"originatingRequestId": "string",
"sessionAttributes": {
"string": "string"
},
"runtimeHints": {
"slotHints": {
"string": {
"string": {
"runtimeHintValues": [
{
"phrase": "string"
},
{
"phrase": "string"
}
]
}
}
}
}
},
"dialogEventLogs": [
{
// only for conditional
"conditionalEvaluationResult":[
// all the branches until true
{
"conditionalBranchName": "string",
"expressionString": "string",
"evaluatedExpression": "string",
"evaluationResult": "true | false"
}
],
"dialogCodeHookInvocationLabel": "string",
"response": "string",
"nextStep": {
"dialogAction": {
"type": "Close | ConfirmIntent | Delegate | ElicitIntent | ElicitSlot",
"slotToElicit": "string"
},
"intent": {
"name": "string",
"slots": {
}
}
}
]
"interpretations": [
{
"interpretationSource": "Bedrock | Lex",
"nluConfidence": "string",
"intent": {
"name": "string",
"slots": {
"string": {
"value": {
"originalValue": "string",
"interpretedValue": "string",
"resolvedValues": [ "string" ]
}
},
"string": {
"shape": "List",
"value": {
"interpretedValue": "string",
"originalValue": "string",
"resolvedValues": [ "string" ]
},
"values": [
{
"shape": "Scalar",
"value": {
"interpretedValue": "string",
"originalValue": "string",
"resolvedValues": [ "string" ]
}
},
{
"shape": "Scalar",
"value": {
"interpretedValue": "string",
"originalValue": "string",
"resolvedValues": [ "string" ]
}
}
]
}
},
"kendraResponse": {
// Only present when intent is KendraSearchIntent. For details, see
// https://docs.aws.amazon.com/kendra/latest/dg/API_Query.html#API_Query_ResponseSyntax
},
"state": "InProgress | ReadyForFulfillment | Fulfilled | Failed",
"confirmationState": "Confirmed | Denied | None"
},
"sentimentResponse": {
"sentiment": "string",
"sentimentScore": {
"positive": "string",
"negative": "string",
"neutral": "string",
"mixed": "string"
}
}
}
],
"sessionId": "string",
"inputTranscript": "string",
"rawInputTranscript": "string",
"transcriptions": [
{
"transcription": "string",
"rawTranscription": "string",
"transcriptionConfidence": "number",
},
"resolvedContext": {
"intent": "string"
},
"resolvedSlots": {
"string": {
"name": "slotName",
"shape": "List",
"value": {
"originalValue": "string",
"resolvedValues": [
"string"
]
}
}
}
}
],
"missedUtterance": "bool",
"requestId": "string",
"timestamp": "string",
"developerOverride": "bool",
"inputMode": "DTMF | Speech | Text",
"requestAttributes": {
"string": "string"
},
"audioProperties": {
"contentType": "string",
"s3Path": "string",
"duration": {
"total": "integer",
"voice": "integer",
"silence": "integer"
}
},
"bargeIn": "string",
"responseReason": "string",
"operationName": "string"
}
```
Isi entri log tergantung pada hasil transaksi dan konfigurasi bot dan permintaan.
+ `slotToElicit`Bidang `intent``slots`,, dan tidak muncul dalam entri jika `missedUtterance` bidang tersebut`true`.
+ `s3PathForAudio`Bidang tidak muncul jika log audio dinonaktifkan atau jika `inputDialogMode` bidangnya`Text`.
+ `responseCard`Bidang hanya muncul ketika Anda telah menentukan kartu respons untuk bot.
+ `requestAttributes`Peta hanya muncul jika Anda telah menentukan atribut permintaan dalam permintaan.
+ `kendraResponse`Bidang ini hanya ada ketika `AMAZON.KendraSearchIntent` membuat permintaan untuk mencari indeks Amazon Kendra.
+ `developerOverride`Bidang ini benar ketika maksud alternatif ditentukan dalam fungsi Lambda bot.
+ `sessionAttributes`Peta hanya muncul jika Anda telah menentukan atribut sesi dalam permintaan.
+ `sentimentResponse`Peta hanya muncul jika Anda mengonfigurasi bot untuk mengembalikan nilai sentimen.
**catatan**
Format input dapat berubah tanpa perubahan yang sesuai dalam format`messageVersion`. Kode Anda seharusnya tidak menimbulkan kesalahan jika ada bidang baru.
# Mengakses log audio di Amazon S3
Amazon Lex V2 menyimpan log audio untuk percakapan Anda dalam ember S3.
Anda dapat menggunakan konsol Amazon S3 atau API untuk mengakses log audio. Anda dapat melihat awalan key objek S3 dari file audio di konsol Amazon Lex V2, atau di bidang `conversationLogSettings` dalam respons operasi`DescribeBotAlias`.
# Memantau status log percakapan dengan CloudWatch metrik
Gunakan Amazon CloudWatch untuk memantau metrik pengiriman log percakapan Anda. Anda dapat menyetel alarm pada metrik sehingga Anda mengetahui masalah dengan pencatatan jika terjadi.
Amazon Lex V2 menyediakan empat metrik di `AWS/Lex` namespace untuk log percakapan:
+ `ConversationLogsAudioDeliverySuccess`
+ `ConversationLogsAudioDeliveryFailure`
+ `ConversationLogsTextDeliverySuccess`
+ `ConversationLogsTextDeliveryFailure`
Metrik keberhasilan menunjukkan bahwa Amazon Lex V2 telah berhasil menulis log audio atau teks Anda ke tujuan mereka.
Metrik kegagalan menunjukkan bahwa Amazon Lex V2 tidak dapat mengirimkan log audio atau teks ke tujuan yang ditentukan. Biasanya, ini adalah kesalahan konfigurasi. Jika metrik kegagalan Anda di atas nol, periksa hal berikut:
+ Pastikan Amazon Lex V2 adalah entitas tepercaya untuk peran IAM.
+ Untuk pencatatan teks, pastikan grup CloudWatch log Log ada. Untuk pencatatan audio, pastikan bucket S3 ada.
+ Pastikan bahwa peran IAM yang digunakan Amazon Lex V2 untuk mengakses grup CloudWatch log Log atau bucket S3 memiliki izin menulis untuk grup log atau bucket.
+ Pastikan bucket S3 ada di wilayah yang sama dengan bot Amazon Lex V2 dan milik akun Anda.