Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan AppInstanceBots sebagai agen saluran cerdas untuk perpesanan Amazon Chime SDK
Anda dapat menggunakan `AppInstanceBots` sebagai agen saluran cerdas. Agen mengenali frasa kunci yang dikirim melalui `ChannelMessages` oleh anggota saluran. Model pemahaman bahasa alami bot menyelesaikan pesan. Pada gilirannya, itu memungkinkan satu atau lebih anggota saluran untuk terlibat dalam dialog bahasa alami yang ditentukan oleh model bot. Anda menyediakan bot, sehingga Anda mengontrol kedalaman dialog dan integrasi dengan sistem perusahaan Anda.
**Prasyarat**
+ Pengetahuan tentang fungsionalitas SDK Amazon Chime dasar, seperti membuat`AppInstanceUsers`, mengelola saluran, serta mengirim dan menerima pesan.
+ Kemampuan untuk memanggil Amazon Chime SDK Messaging. APIs
+ Pengetahuan tentang fungsionalitas dasar Amazon Lex V2, seperti membuat Bot Amazon Lex V2, memodelkan maksud dan slot, membuat versi bot, alias, menggunakan status sesi, dan integrasi kait Lambda.
**penting**
Penggunaan Amazon Lex V2 tunduk pada [Ketentuan Layanan AWS](https://aws.amazon.com/service-terms/), termasuk persyaratan khusus untuk AWS Machine Learning dan Layanan Kecerdasan Buatan.
**Topics**
+ [Membuat bot Amazon Lex V2 untuk perpesanan Amazon Chime SDK](create-lex-bot.md)
+ [Menyiapkan AppInstance bot untuk perpesanan Amazon Chime SDK](appinstance-bot-setup.md)
+ [Membuat keanggotaan saluran AppInstanceBot untuk perpesanan Amazon Chime SDK](channel-membership.md)
+ [Mengirim pesan ke pesan AppInstanceBot Amazon Chime SDK](message-appinstancebot.md)
+ [Memproses pesan dari Amazon Lex untuk perpesanan Amazon Chime SDK](process-from-lexv2.md)
+ [Memproses tanggapan dari pesan AppInstanceBot untuk Amazon Chime SDK](process-response.md)
+ [Menggunakan aturan untuk mengirim acara ke Amazon EventBridge untuk pesan Amazon Chime SDK](event-bridge-alerts.md)
+ [Pemecahan masalah yang AppInstanceBots dikonfigurasi dengan bot Amazon Lex V2 untuk perpesanan Amazon Chime SDK](troubleshoot-lex-bots.md)
# Membuat bot Amazon Lex V2 untuk perpesanan Amazon Chime SDK
Untuk menggunakan AppInstance bot sebagai agen, Anda harus terlebih dahulu membuat bot Amazon Lex V2 untuk mengelola interaksi dialog untuk skenario agen cerdas. Untuk mulai membuat bot Amazon Lex V2, lihat [Memulai Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/getting-started.html) di *Panduan Pengembang Amazon Lex V2*. Untuk informasi tentang memigrasikan bot Amazon Lex V1 ke Amazon Lex V2, lihat panduan migrasi [Amazon Lex V1 ke V2](https://docs.aws.amazon.com/lexv2/latest/dg/migration.html).
**Topics**
+ [Prasyarat](#lex-prereqs)
+ [Memberikan izin pemanggilan](#invocation-perms)
+ [Membuat maksud selamat datang untuk perpesanan Amazon Chime SDK](welcome-intent.md)
+ [Membuat versi bot Amazon Lex V2 untuk perpesanan Amazon Chime SDK](lex-versions.md)
+ [Membuat alias bot Amazon Lex V2 untuk perpesanan Amazon Chime SDK](lex-aliases.md)
## Prasyarat
Bot Amazon Lex V2 Anda harus memiliki prasyarat berikut.
+ Anda harus membuat bot di AWS Wilayah yang mendukung titik akhir runtime Amazon Lex V2.
+ Anda harus membuat bot di AWS akun dan Wilayah yang sama dengan `AppInstance` dan`AppInstanceBot`.
+ Bot harus memberikan izin pemanggilan melalui kebijakan berbasis sumber daya kepada kepala layanan. `messaging.chime.amazonaws.com`
+ Bot dapat memodelkan Niat Selamat Datang. Hal ini memungkinkan `AppInstanceBot` untuk mengumumkan dirinya sendiri dan kemampuannya pada keanggotaan dalam saluran.
+ Bot harus memiliki versi produksi dan alias untuk mengonfigurasi. `AppInstanceBot`
+ Bot harus menggunakan bahasa dan lokal yang didukung. Untuk informasi selengkapnya tentang bahasa dan lokal, lihat [Bahasa dan lokal yang didukung di Amazon Lex V2 di Panduan](https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html) *Pengembang Amazon Lex V2*.
## Memberikan izin pemanggilan
`AppInstanceBot`Untuk memanggil Bot Amazon Lex V2, kepala layanan pesan Amazon Chime SDK harus memiliki izin untuk memanggil sumber daya Amazon Lex Bot. *Untuk informasi selengkapnya tentang izin kebijakan berbasis sumber daya Amazon Lex V2, lihat [contoh kebijakan berbasis sumber daya untuk Amazon Lex V2 di Panduan Pengembang Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/security_iam_resource-based-policy-examples.html).*
Contoh berikut menunjukkan kebijakan berbasis sumber daya.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "messaging.chime.amazonaws.com"
},
"Action": [
"lex:PutSession",
"lex:DeleteSession",
"lex:RecognizeText"
],
"Resource": "arn:aws:lex:us-east-1:111122223333:bot-alias/lex-bot-id/lex-bot-alias-id",
"Condition": {
"StringEquals": {
"AWS:SourceAccount": "111122223333"
},
"ArnEquals": {
"AWS:SourceArn": "arn:aws:chime:us-east-1:111122223333:app-instance/app-instance-id/bot/app-instance-bot-id"
}
}
}
]
}
```
------
**catatan**
Untuk mengizinkan seseorang `AppInstanceBot` memanggil bot Amazon Lex V2, gunakan ID AppInstanceBot tersebut. Untuk memungkinkan semua orang `AppInstanceBots` dalam `AppInstance` menjalankan bot Amazon Lex V2, gunakan wildcard. Contoh:
`arn:aws:chime:region:aws-account-id:app-instance/app-instance-id/bot/*`
# Membuat maksud selamat datang untuk perpesanan Amazon Chime SDK
Jika Anda menambahkan maksud selamat datang opsional ke model bot Amazon Lex V2 Anda, Anda `AppInstanceBot` dapat mengumumkan dirinya sendiri dan kemampuannya saat bergabung dengan saluran. Maksud selamat datang dapat menampilkan pesan, atau dapat memulai dialog dengan anggota saluran. Nama maksud selamat datang dapat bervariasi, dan Anda mendefinisikannya dalam AppInstanceBot konfigurasi.
Untuk informasi selengkapnya tentang maksud, lihat [Menambahkan maksud di Panduan Pengembang](https://docs.aws.amazon.com/lexv2/latest/dg/build-intents.html) *Amazon Lex V2*
# Membuat versi bot Amazon Lex V2 untuk perpesanan Amazon Chime SDK
Saat Anda membuat Bot Amazon Lex V2, Anda hanya membuat versi *draf*. Draf adalah salinan bot yang berfungsi yang dapat Anda perbarui. Secara default, versi draf dikaitkan dengan alias yang disebut`TestBotAlias`, dan Anda hanya boleh menggunakan bot draf untuk pengujian manual.
Setelah Anda menyelesaikan pemodelan dialog dan membangun draft bot, Anda membuat satu atau beberapa *versi*, snapshot bernomor dari draft Lex bot. Versi memungkinkan Anda untuk mengontrol implementasi yang digunakan aplikasi klien Anda. Misalnya, Anda dapat mempublikasikan versi untuk digunakan di berbagai bagian alur kerja Anda, seperti pengembangan, penerapan beta, dan produksi.
Untuk informasi selengkapnya tentang pembuatan versi bot Lex, lihat [Membuat versi di Panduan](https://docs.aws.amazon.com/lexv2/latest/dg/versions.html) *Pengembang Amazon Lex V2*.
# Membuat alias bot Amazon Lex V2 untuk perpesanan Amazon Chime SDK
Setelah Anda membuat satu atau beberapa versi bot Amazon Lex V2, Anda membuat *alias*. Alias bertindak sebagai pointer bernama ke versi bot Amazon Lex V2. Misalnya, Anda hanya dapat mengaitkan alias dengan satu versi pada satu waktu.
Untuk informasi selengkapnya tentang alias Lex bot, lihat [Membuat alias di Panduan](https://docs.aws.amazon.com/lexv2/latest/dg/aliases.html) *Pengembang Lex V2*.
# Menyiapkan AppInstance bot untuk perpesanan Amazon Chime SDK
Setelah Anda memiliki bot Amazon Lex V2 dengan model, versi, dan alias, Anda menggunakan pesan Amazon Chime SDK APIs atau CLI untuk membuat file. AppInstanceBot Untuk informasi selengkapnya tentang penggunaan APIs, lihat dokumentasi [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_identity-chime_CreateAppInstanceBot.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_identity-chime_CreateAppInstanceBot.html)API.
**catatan**
Anda menggunakan `InvokedBy` atribut untuk mengonfigurasi perilaku interaksi dialog`AppInstanceBot`. Anda dapat mengonfigurasi jenis pesan yang memicu bot, seperti pesan standar atau pesan yang ditargetkan.
Contoh berikut menunjukkan cara menggunakan AWS CLI untuk membuat semua pesan standar dengan`MENTIONS`, dan pesan AppInstanceBot yang ditargetkan, dapat dipanggil.
```
aws chime-sdk-identity create-app-instance-bot \
--app-instance-arn app-instance-arn \
--name app-instance-bot-name \
--configuration '{
"Lex": {
"LexBotAliasArn": "lex-bot-alias-arn",
"LocaleId": "lex_bot_alias_locale_id",
"InvokedBy": {
"StandardMessages": "MENTIONS",
"TargetedMessages": "ALL"
}
"WelcomeIntent": "welcome-intent-name"
}
}
```
# Membuat keanggotaan saluran AppInstanceBot untuk perpesanan Amazon Chime SDK
Setelah Anda membuat AppInstanceBot, Anda menambahkannya sebagai anggota ke saluran baru atau yang sudah ada. Untuk informasi selengkapnya, lihat [CreateChannel](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html)dan [ CreateChannelMembership](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelMembership.html)di dokumentasi *API perpesanan Amazon Chime SDK*.
Contoh berikut menunjukkan cara menggunakan AWS CLI untuk membuat saluran dan menambahkan `AppInstanceBot` sebagai anggota.
```
aws chime-sdk-messaging create-channel \
--chime-bearer caller_app_instance_user_arn \
--app-instance-arn app_instance_arn \
--name channel_name \
--member-arns '[
"app_instance_bot_arn"
]'
```
Contoh berikut menunjukkan cara menggunakan AWS CLI untuk menambahkan ke saluran yang `AppInstanceBot` ada.
```
aws chime-sdk-messaging create-channel-membership \
--chime-bearer caller_app_instance_user_arn \
--channel-arn channel_arn \
--member-arn app_instance_bot_arn
```
# Mengirim pesan ke pesan AppInstanceBot Amazon Chime SDK
Anda menggunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_SendChannelMessage.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_SendChannelMessage.html)API untuk mengirim pesan ke file AppInstanceBot. Anda mengirim pesan ke saluran di mana AppInstanceBot adalah anggota. Jika [model pemahaman bahasa alami](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) mengenali konten pesan dan memunculkan maksud Amazon Lex, model akan AppInstanceBot merespons dengan pesan saluran dan memulai dialog.
Anda juga dapat mengirim pesan target ke anggota saluran, yang bisa berupa AppInstanceUser atau AppInstanceBot. Hanya target dan pengirim yang dapat melihat pesan yang ditargetkan. Hanya pengguna yang dapat melihat pesan yang ditargetkan yang dapat mengambil tindakan terhadapnya. Namun, administrator dapat menghapus pesan yang ditargetkan yang tidak dapat mereka lihat.
Contoh berikut menunjukkan cara menggunakan AWS CLI untuk mengirim pesan saluran.
```
aws chime-sdk-messaging send-channel-message \
--chime-bearer caller_app_instance_user_arn \
--channel-arn channel_arn \
--content content \
--type STANDARD \
--persistence PERSISTENT
```
# Memproses pesan dari Amazon Lex untuk perpesanan Amazon Chime SDK
Saat mengirim pesan ke Amazon Lex, Amazon Chime SDK Messaging mengisi `CHIME.channel.arn` dan `CHIME.sender.arn` dengan saluran dan informasi ARN pengirim sebagai atribut permintaan. Anda dapat menggunakan atribut untuk menentukan siapa yang mengirim pesan dan saluran milik pengirim. Untuk informasi selengkapnya, lihat [Mengaktifkan logika kustom dengan fungsi AWS Lambda](https://docs.aws.amazon.com/lexv2/latest/dg/lambda.html) di Panduan Pengembang *Amazon Lex*.
# Memproses tanggapan dari pesan AppInstanceBot untuk Amazon Chime SDK
Saat pengguna mengirim pesan, pengguna AppInstanceBot merespons dengan pesan saluran. Anda dapat membuat daftar pesan saluran untuk mendapatkan respons bot.
Contoh berikut menunjukkan Anda untuk menggunakan CLI untuk daftar pesan saluran.
```
aws chime-sdk-messaging list-channel-messages \
--chime-bearer caller_app_instance_user_arn \
--channel-arn channel_arn
```
Tanggapan sukses dari AppInstanceBot mengambil format berikut.
```
{
"MessageId": "messageId",
"Content": "*{\"Messages\":[{\"...\"}]}*",
"ContentType": "application/amz-chime-lex-msgs",
"MessageAttributes": {
"CHIME.LEX.sessionState.intent.name": {
"StringValues": [
"lex_bot_intent_name"
]
},
"CHIME.LEX.sessionState.intent.state": {
"StringValues": [
"lex_bot_intent_fullfilment_status"
]
},
"CHIME.LEX.sessionState.originatingRequestId": {
"StringValues": [
"lex_bot_originating_request_id"
]
},
"CHIME.LEX.sessionState.sessionId": {
"StringValues": [
"lex_bot_session_id"
]
}
},
"Sender": {
"Arn": "app_instance_bot_arn",
"Name": "app_instance_bot_name"
},
"Type": "STANDARD",
}
```
**Content**
`Content`Bidang berisi daftar pesan yang berasal dari bot Amazon Lex V2. Untuk informasi selengkapnya tentang pesan-pesan tersebut, lihat [pesan](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeText.html#lexv2-runtime_RecognizeText-response-messages) di Amazon Lex V2 `RecognizeText` API.
Contoh berikut menunjukkan cara menggunakan `Content` bidang dalam pesan selamat datang.
```
{
"Messages":
[
{
"Content": "Hello!",
"ContentType": "PlainText"
},
{
"ContentType": "ImageResponseCard",
"ImageResponseCard":
{
"Title": "Hello! I'm BB, the Bank Bot.",
"Subtitle": "I can help you with the following transactions",
"Buttons":
[
{
"Text": "Check balance",
"Value": "Check balance"
},
{
"Text": "Escalate to agent",
"Value": "Escalate to agent"
}
]
}
}
]
}
```
Untuk respons kegagalan, bidang Konten berisi pesan kesalahan dan kode dalam format berikut:
```
{
"Code": error_code
}
```
**ContentType**
`ContentType`Mengacu pada jenis payload yang berisi `Content` bidang, dan harus diperiksa untuk mengurai bidang. `Content`
Bot Lex V2 menggunakan yang berbeda`ContentType`.
`ContentType`diatur `application/amz-chime-lex-msgs` untuk respons sukses, atau `application/amz-chime-lex-error` untuk respons kegagalan.
**MessageAttributes**
A *MessageAttribute*adalah peta kunci string untuk nilai string. Tanggapan dari sebuah `AppInstanceBot` berisi atribut pesan berikut yang dipetakan ke respons dari bot Amazon Lex.
+ **Chime.lex.SessionState.Intent.Name — Nama bot Lex** bermaksud bahwa permintaan tersebut berusaha untuk memenuhi.
+ **Chime.lex.SessionState.Intent.state** — Status maksud saat ini. Nilai yang mungkin meliputi:`Fulfilled`,`InProgress`, dan`Failed`.
+ **Chime.lex.SessionState. originatingRequestId** — Pengidentifikasi unik untuk permintaan khusus ke bot Amazon Lex. Ini diatur ke `MessageId` pesan pengguna asal yang memicu file. AppInstanceBot
+ **Chime.lex.SessionState.SessionId** — Pengidentifikasi unik untuk percakapan antara pengguna dan bot. Saat pengguna memulai obrolan dengan bot Anda, Amazon Lex membuat sesi.
Untuk informasi selengkapnya tentang sesi Amazon Lex dan status sesi, lihat *Referensi API Amazon Lex*, dan [Mengelola sesi](https://docs.aws.amazon.com/lexv2/latest/dg/using-sessions.html) *di Panduan Pengembang Amazon Lex V2 [https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_SessionState.html](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_SessionState.html)*
Untuk informasi selengkapnya tentang atribut yang dikembalikan Amazon Lex V2, lihat [Amazon Lex Runtime V2](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_Operations_Amazon_Lex_Runtime_V2.html) APIs.
# Menggunakan aturan untuk mengirim acara ke Amazon EventBridge untuk pesan Amazon Chime SDK
Amazon Chime SDK mengirimkan EventBridge peristiwa saat kesalahan mencegahnya menjalankan Bot Amazon Lex V2. Anda dapat membuat EventBridge aturan yang mengenali peristiwa tersebut dan secara otomatis mengambil tindakan ketika aturan dicocokkan. Untuk informasi selengkapnya, lihat [ EventBridge Aturan Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) *di Panduan EventBridge Pengguna Amazon*.
Contoh berikut menunjukkan peristiwa kegagalan yang khas.
```
{
version: '0',
id: '12345678-1234-1234-1234-111122223333',
'detail-type': 'Chime Messaging AppInstanceBot Lex Failure',
source: 'aws.chime',
account: 'aws-account-id',
time: 'yyyy-mm-ddThh:mm:ssZ',
region: "region",
resources: [],
detail: {
resourceArn: 'arn:aws:chime:region:aws-account-id:app-instance/app-instance-id/bot/app-instance-bot-id',
failureReason: "1 validation error detected: Value at 'text' failed to satisfy constraint: Member must have length less than or equal to 1024 (Service: LexRuntimeV2, Status Code: 400, Request ID: request-id)"
}
}
```
# Pemecahan masalah yang AppInstanceBots dikonfigurasi dengan bot Amazon Lex V2 untuk perpesanan Amazon Chime SDK
Topik berikut menjelaskan cara memecahkan masalah umum dengan. AppInstanceBots
## Menemukan kegagalan Amazon Lex V2
Pesan Amazon Chime SDK mengirimkan [ EventBridge peristiwa Amazon](https://docs.aws.amazon.com/chime-sdk/latest/dg/event-bridge-alerts.html) ketika kesalahan mencegahnya memanggil bot Amazon Lex V2. Untuk informasi selengkapnya tentang menyiapkan aturan dan mengonfigurasi target notifikasi, lihat [Memulai Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-get-started.html) di *Panduan EventBridge Pengguna Amazon*.
Jika menerima EventBridge peristiwa di AWS CloudWatch Log, Anda dapat menggunakan Wawasan AWS CloudWatch Log untuk melakukan kueri EventBridge peristiwa berdasarkan jenis detail pesan Amazon Chime SDK. `failureReason`Daftar penyebab kegagalan.
Contoh berikut menunjukkan query tipikal.
```
fields @timestamp, @message
| filter `detail-type` = "Chime Messaging AppInstanceBot Lex Failure"
| sort @timestamp desc
```
Jika Amazon Chime SDK Messaging dapat memanggil bot Amazon Lex V2 Anda, SDK akan mengirimkan `CONTROL` pesan dengan pesan kesalahan.
## Memecahkan masalah kesalahan izin bot Amazon Lex V2
AppInstanceBot Untuk memanggil Bot Amazon Lex V2, kepala layanan pesan Amazon Chime SDK harus memiliki izin untuk memanggil sumber daya Amazon Lex V2 Bot. Juga, pastikan kondisi kebijakan sumber daya sesuai dengan ARN dari. `AWS:SourceArn` AppInstanceBot
Untuk informasi selengkapnya tentang mengonfigurasi AppInstanceBot untuk memanggil bot Amazon Lex V2, lihat[Membuat bot Amazon Lex V2 untuk perpesanan Amazon Chime SDK](create-lex-bot.md), sebelumnya di bagian ini.
## Memecahkan masalah pelambatan bot Amazon Lex V2
Amazon Lex memiliki kuota layanan untuk jumlah maksimum percakapan mode teks bersamaan per alias bot. Anda dapat menghubungi tim layanan Amazon Lex untuk kenaikan kuota. Untuk informasi selengkapnya, lihat [pedoman dan kuota Amazon Lex](https://docs.aws.amazon.com/lexv2/latest/dg/quotas.html) di *Panduan Pengembang Amazon Lex*.