Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menghasilkan wawasan dari panggilan menggunakan analitik panggilan untuk Amazon Chime SDK
Topik di bagian ini menjelaskan cara menggunakan analitik panggilan Amazon Chime SDK untuk menghasilkan wawasan dari data panggilan Anda.
Analisis panggilan Amazon Chime SDK memberi pengembang solusi kode rendah untuk menghasilkan wawasan hemat biaya dari audio waktu nyata, termasuk konsumsi audio, analisis, peringatan, dan integrasi data lake. Analisis panggilan memungkinkan Anda menghasilkan wawasan melalui integrasi dengan Amazon Transcribe dan Transcribe Call Analytics (TCA), dan secara native melalui analitik suara Amazon Chime SDK. Analisis panggilan juga dapat merekam panggilan ke Amazon S3 Bucket Anda.
Anda dapat menggunakan metode berikut untuk mengonfigurasi dan menjalankan analitik panggilan.
+ Gunakan konsol Amazon Chime SDK untuk membuat konfigurasi analitik panggilan dan mengaitkannya dengan Konektor Suara Amazon Chime SDK. Selama proses itu, Anda dapat mengaktifkan perekaman panggilan dan analitik. Anda tidak perlu menulis kode untuk menyelesaikan proses.
+ Gunakan satu set Amazon Chime SDK APIs [Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/welcome.html) APIs untuk membuat dan menjalankan konfigurasi secara terprogram.
Untuk informasi lebih lanjut, lihat [Membuat konfigurasi analitik panggilan untuk Amazon Chime SDK](creating-ca-configuration.md) dan[Menggunakan konfigurasi analitik panggilan untuk Amazon Chime SDK](using-call-analytics-configurations.md), nanti di bagian ini.
**Topics**
+ [Apa itu analitik panggilan Amazon Chime SDK](what-is-amazon-chime-sdk-call-analytics.md)
+ [Memahami terminologi analitik panggilan untuk Amazon Chime SDK](ca-terms-concepts.md)
+ [Membuat konfigurasi analitik panggilan untuk Amazon Chime SDK](creating-ca-configuration.md)
+ [Menggunakan konfigurasi analitik panggilan untuk Amazon Chime SDK](using-call-analytics-configurations.md)
+ [Mengelola pipeline analitik panggilan untuk Amazon Chime SDK](managing-call-analytics-pipelines.md)
+ [Menjeda dan melanjutkan pipeline analitik panggilan untuk Amazon Chime SDK](pausing-and-resuming-call-analytics-pipelines.md)
+ [Menggunakan peran akses sumber daya analitik panggilan untuk Amazon Chime SDK](call-analytics-resource-access-role.md)
+ [Memahami status analitik panggilan untuk Amazon Chime SDK](call-analytics-statuses.md)
+ [Memantau pipeline analitik panggilan untuk Amazon Chime SDK dengan Amazon CloudWatch](monitoring-with-cloudwatch.md)
+ [Panggilan prosesor analitik dan tujuan keluaran untuk Amazon Chime SDK](call-analytics-processor-and-output-destinations.md)
+ [Model data analitik panggilan untuk Amazon Chime SDK](ca-data-model.md)
+ [Menggunakan analitik suara Amazon Chime SDK](voice-analytics.md)
+ [Kuota layanan analitik panggilan untuk Amazon Chime SDK](ca-regions.md)
# Apa itu analitik panggilan Amazon Chime SDK
Amazon Chime SDK call analytics adalah solusi low-code untuk menghasilkan wawasan hemat biaya dari audio real-time, termasuk kemampuan untuk konsumsi audio, perekaman, analitik suara, peringatan, dan data lake. Anda dapat menghasilkan wawasan yang didukung pembelajaran mesin menggunakan analitik panggilan dengan membuat konfigurasi analitik panggilan yang dapat digunakan kembali yang menentukan integrasi pembelajaran AWS mesin dan fitur pemrosesan audio mana yang akan diaktifkan untuk alur kerja. Anda kemudian menggunakan konfigurasi analitik panggilan dengan berbagai sumber media seperti Konektor Suara atau Amazon Kinesis Video Streams. Analisis panggilan menghasilkan wawasan melalui integrasi dengan Amazon Transcribe dan Transcribe call analytics (TCA), dan secara native melalui analisis [suara Amazon Chime SDK](voice-analytics.md), layanan yang berjalan di bawah analitik panggilan.
Anda mengikuti langkah-langkah berikut untuk menggunakan analitik panggilan:
![\[Gambar yang menunjukkan proses penyiapan analitik panggilan Amazon Chime SDK.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/CallAnalyticsOverview.png)
Dalam diagram:
1. Anda mulai dengan membuat konfigurasi analitik panggilan.
1. Anda mengatur tujuan output dan data lake opsional.
1. Anda membuat alur kerja yang mengaitkan konfigurasi Anda dengan Konektor Suara dan Amazon Kinesis Video Streams.
1. Anda menganalisis dan secara opsional memvisualisasikan wawasan Anda.
Anda dapat menggunakan konsol Amazon Chime SDK untuk membuat konfigurasi analitik panggilan dan mengaktifkan analitik panggilan untuk memulai secara otomatis. Jika Anda perlu mengontrol konfigurasi yang berlaku untuk jenis panggilan tertentu, Anda gunakan APIs untuk membuat konfigurasi. Either way, konfigurasi berisi detail tentang layanan pembelajaran AWS mesin untuk memanggil audio panggilan, mengaktifkan perekaman panggilan, dan tujuan untuk wawasan, metadata, dan rekaman. Analisis panggilan menyediakan tujuan berikut:
+ Aliran Data Kinesis Amazon (KDS). Anda dapat menggunakan KDS untuk menerima wawasan panggilan langsung yang kemudian dapat Anda integrasikan ke dalam aplikasi Anda. Misalnya, Anda dapat mengintegrasikan wawasan langsung untuk membantu agen penjualan atau dukungan pelanggan selama panggilan pelanggan, atau menggunakan wawasan untuk menambah permintaan dan ringkasan AI generatif.
+ Bucket Amazon S3 yang dikonfigurasi sebagai gudang data. Bucket menyimpan data dalam format Parket. Parket adalah format file sumber terbuka yang dirancang untuk mengompres dan menyimpan data dalam jumlah besar. Anda kemudian dapat menggunakan Amazon Athena untuk menanyakan data tersebut menggunakan bahasa kueri sederhana (SQL), atau memindahkan data ke gudang data yang ada untuk dipasangkan dengan data bisnis Anda. Misalnya, Anda dapat melakukan analisis agregat pasca-panggilan untuk memahami efektivitas panggilan pelanggan, area masalah produk, atau peluang untuk melatih karyawan untuk mencapai hasil pelanggan yang lebih baik.
Selain tujuan tersebut, analitik panggilan juga mendukung peringatan waktu nyata yang dapat Anda konfigurasi sebelumnya, berdasarkan wawasan. Peringatan dikirim ke Amazon EventBridge.
**catatan**
Saat membuat konfigurasi analitik panggilan, Anda tidak memilih sumber audio tertentu. Itu memungkinkan Anda untuk menggunakan kembali konfigurasi di beberapa sumber audio. Misalnya, konfigurasi dapat mengaktifkan perekaman panggilan dan menyediakan transkripsi panggilan. Anda kemudian dapat menggunakan konfigurasi dengan Konektor Suara Chime SDK dan aliran audio melalui Kinesis Video Stream. Anda juga dapat berbagi konfigurasi di antara beberapa Konektor Suara. Setiap konfigurasi analitik panggilan unik dan diidentifikasi oleh ARN.
# Memahami terminologi analitik panggilan untuk Amazon Chime SDK
Terminologi dan konsep berikut sangat penting untuk memahami cara menggunakan analitik panggilan Amazon Chime SDK.
**Amazon Athena**
Layanan kueri interaktif yang memungkinkan Anda menganalisis data di Amazon S3 menggunakan SQL standar. Athena tanpa server, jadi Anda tidak memiliki infrastruktur untuk dikelola, dan Anda hanya membayar untuk kueri yang Anda jalankan. Untuk menggunakan Athena, arahkan ke data Anda di Amazon S3, tentukan skema, dan gunakan kueri SQL standar. Anda juga dapat menggunakan grup kerja untuk mengelompokkan pengguna dan mengontrol sumber daya yang dapat mereka akses saat menjalankan kueri. Workgroup memungkinkan Anda mengelola konkurensi kueri dan memprioritaskan eksekusi kueri di berbagai grup pengguna dan beban kerja. Untuk informasi lebih lanjut, lihat [Apa itu Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/what-is.html).
**Amazon Kinesis Data Firehose**
Layanan ekstrak, transformasi, dan muat (ETL) yang andal menangkap, mengubah, dan mengirimkan data streaming ke data lake, penyimpanan data, dan layanan analitik. Untuk informasi lebih lanjut, lihat [Apa Itu Amazon Kinesis Data Firehose](https://aws.amazon.com/kinesis/data-firehose/).
**Panggilan gudang data analitik**
Penyimpanan opsional untuk data analitik panggilan. Gudang menyimpan data dalam format file data berbasis parket dalam bucket Amazon S3. Anda dapat menggunakan SQL standar untuk menanyakan data. Anda mengaktifkan gudang dalam konfigurasi analitik panggilan.
**Katalog Data Glue**
Repositori metadata terpusat untuk aset data di berbagai sumber data. Katalog terdiri dari database dan tabel. Untuk analitik panggilan, metadata dalam tabel memberi tahu Athena lokasi bucket Amazon S3 Anda. Ini juga menentukan struktur data, seperti nama kolom, tipe data, dan nama tabel. Database hanya menyimpan informasi metadata dan skema untuk kumpulan data. Untuk informasi lebih lanjut, lihat[Memahami struktur tabel katalog AWS Glue data untuk Amazon Chime SDK](ca-data-model-diagram.md), nanti di bagian ini.
**Pipa wawasan media**
Sumber daya sementara yang diidentifikasi oleh yang unik`MediaPipelineId`. Dibuat dengan menggunakan konfigurasi pipeline analitik panggilan dan parameter runtime. Parameter runtime menentukan sumber data untuk pipeline.
**Konfigurasi saluran wawasan media**
Konfigurasi statis yang digunakan untuk membuat pipeline wawasan media. Anda dapat menggunakan konfigurasi untuk membuat instance satu atau beberapa pipeline.
**Elemen konfigurasi pipa wawasan media**
Elemen konfigurasi pipeline wawasan media mencakup instruksi untuk media pemrosesan menggunakan elemen prosesor atau memberikan wawasan yang dihasilkan menggunakan elemen sink.
**Tugas pipa wawasan media**
Sub-sumber daya sementara dari saluran wawasan media. Tugas menyimpan metadata tentang status proses untuk ARN aliran tertentu dan ID saluran. Diidentifikasi oleh ID unik. Dibuat dengan memulai analisis suara pada pipeline wawasan media.
**Pencarian speaker**
Fitur analisis suara yang membantu Anda mengenali peserta panggilan.
**Analisis suara**
Fitur Amazon Chime SDK yang mencakup pencarian speaker dan analisis nada suara.
**Penyematan suara**
Representasi vektor dari suara pemanggil, ditambah ID unik.
**Peningkatan suara**
Sistem yang meningkatkan kualitas audio panggilan telepon.
**Profil suara**
Kombinasi penyematan suara, ID-nya, dan tanggal kedaluwarsanya.
**Domain profil suara**
Koleksi profil suara.
**Analisis nada suara**
Fitur analisis suara yang memungkinkan Anda menganalisis suara pemanggil untuk`positive`,`negative`, atau `neutral` sentimen.
*Untuk informasi selengkapnya tentang APIs penggunaan untuk membuat konfigurasi wawasan panggilan, memulai pipeline, dan menjalankan analisis suara, lihat Amazon Chime SDK Media [Pipelines, di Referensi API Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Media_Pipelines.html).*
**catatan**
Kami sangat menyarankan untuk menggunakan pipeline wawasan media APIs untuk menjalankan analitik panggilan, karena hanya mereka yang APIs menyediakan fitur baru. Untuk informasi selengkapnya tentang perbedaan antara saluran media dan ruang nama suara, lihat[Menggunakan suara APIs untuk menjalankan analisis suara untuk Amazon Chime SDK](va-in-voice-namespace.md), nanti di bagian ini.
# Membuat konfigurasi analitik panggilan untuk Amazon Chime SDK
Untuk menggunakan analitik panggilan, Anda mulai dengan membuat *konfigurasi*, struktur statis yang menyimpan informasi yang diperlukan untuk membuat pipeline analitik panggilan. Anda dapat menggunakan konsol Amazon Chime SDK untuk membuat konfigurasi, atau memanggil API. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)
Konfigurasi analitik panggilan mencakup detail tentang prosesor audio, seperti perekaman, analitik suara, atau Amazon Transcribe. Ini juga mencakup tujuan wawasan dan konfigurasi acara peringatan. Secara opsional, Anda dapat menyimpan data panggilan ke bucket Amazon S3 untuk analisis lebih lanjut.
Namun, *konfigurasi tidak termasuk sumber audio tertentu*. Itu memungkinkan Anda menggunakan kembali konfigurasi di beberapa alur kerja analitik panggilan. Misalnya, Anda dapat menggunakan konfigurasi analitik panggilan yang sama dengan Konektor Suara yang berbeda atau di berbagai sumber Amazon Kinesis Video Stream (KVS).
Anda menggunakan konfigurasi untuk membuat pipeline saat panggilan SIP terjadi melalui Konektor Suara, atau saat media baru dikirim ke Amazon Kinesis Video Stream (KVS). Pipa, pada gilirannya, memproses media sesuai dengan spesifikasi dalam konfigurasi.
Anda dapat menghentikan pipa secara terprogram kapan saja. Saluran pipa juga menghentikan pemrosesan media saat panggilan Konektor Suara berakhir. Selain itu, Anda dapat menjeda pipa. Melakukan hal itu menonaktifkan panggilan ke layanan pembelajaran mesin Amazon yang mendasarinya dan melanjutkannya bila diinginkan. Namun, perekaman panggilan berjalan saat Anda menjeda pipeline.
Bagian berikut menjelaskan prasyarat untuk membuat konfigurasi analitik panggilan, dan cara membuatnya.
**Topics**
+ [Memahami prasyarat analitik panggilan Amazon Chime SDK](ca-prerequisites.md)
+ [Menggunakan konsol Amazon Chime SDK untuk membuat konfigurasi analitik panggilan](create-config-console.md)
+ [Menggunakan APIs untuk membuat konfigurasi analitik panggilan untuk Amazon Chime SDK](create-config-apis.md)
+ [Mengaitkan konfigurasi dengan Konektor Suara untuk Amazon Chime SDK](ca-associate-vc-steps.md)
# Memahami prasyarat analitik panggilan Amazon Chime SDK
Sebelum Anda membuat konfigurasi analitik panggilan, Anda harus memiliki item berikut. Anda dapat menggunakan AWS konsol untuk membuatnya:
+ Konektor Suara Amazon Chime SDK. Jika tidak, lihat [Membuat Konektor Suara Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/ca-prerequisites.html). Anda juga harus:
+ Aktifkan streaming untuk Konektor Suara. Untuk informasi selengkapnya, lihat [Mengotomatiskan Amazon Chime SDK EventBridge](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html) dengan, di Panduan Administrator Amazon *Chime* SDK
+ Konfigurasikan Konektor Suara untuk menggunakan analitik panggilan. Untuk informasi selengkapnya, lihat [Mengonfigurasi Konektor Suara untuk menggunakan analitik panggilan](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html), di Panduan Administrator *Amazon Chime SDK*.
+ EventBridge Target Amazon. Jika tidak, lihat [Memantau Amazon Chime SDK dengan](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html), Panduan Administrator *Amazon EventBridge Chime* SDK.
+ Peran terkait layanan yang memungkinkan Konektor Suara mengakses tindakan pada target. EventBridge Untuk informasi selengkapnya, lihat [Kebijakan peran tertaut layanan Amazon Chime SDK Voice Connector](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-stream.html), di Panduan Administrator *Amazon Chime* SDK.
+ Aliran Data Kinesis Amazon. Jika tidak, lihat [Membuat dan Mengelola Aliran, di Panduan Pengembang *Amazon Kinesis* Streams](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html). Analisis dan transkripsi suara memerlukan Aliran Data Kinesis.
+ Untuk menganalisis panggilan offline, Anda harus membuat data lake Amazon Chime SDK. Untuk melakukan itu, lihat[Membuat danau data Amazon Chime SDK](ca-data-lake.md), nanti dalam panduan ini.
# Menggunakan konsol Amazon Chime SDK untuk membuat konfigurasi analitik panggilan
Setelah membuat prasyarat yang tercantum di bagian sebelumnya, Anda dapat menggunakan konsol Amazon Chime SDK untuk membuat satu atau beberapa konfigurasi analitik panggilan. Anda juga dapat menggunakan konsol untuk mengaitkan satu atau beberapa Konektor Suara dengan konfigurasi Anda. Ketika Anda menyelesaikan proses itu, analitik panggilan mulai berjalan dengan fitur yang Anda aktifkan saat Anda membuat konfigurasi.
Anda mengikuti langkah-langkah ini untuk membuat konfigurasi analitik panggilan:
1. Tentukan detail konfigurasi, termasuk nama dan tag opsional.
1. Konfigurasikan pengaturan perekaman Anda. Buat konfigurasi analitik panggilan yang mencakup wawasan yang didukung perekaman dan pembelajaran mesin.
1. Konfigurasikan layanan analitik Anda.
1. Pilih tujuan keluaran untuk menggunakan wawasan waktu nyata. Buat data lake opsional untuk melakukan analitik pasca-panggilan.
1. Buat peran layanan baru atau gunakan peran yang ada.
1. Siapkan peringatan waktu nyata yang mengirim notifikasi melalui Amazon EventBridge saat kondisi tertentu terpenuhi.
1. Tinjau pengaturan Anda dan buat konfigurasi
Setelah membuat konfigurasi, Anda mengaktifkan analitik panggilan dengan mengaitkan Konektor Suara dengan konfigurasi. Setelah Anda melakukannya, analitik panggilan dimulai secara otomatis ketika panggilan masuk ke Konektor Suara itu. Untuk informasi lebih lanjut, lihat[Mengaitkan konfigurasi dengan Konektor Suara untuk Amazon Chime SDK](ca-associate-vc-steps.md), nanti di bagian ini.
Bagian berikut menjelaskan cara menyelesaikan setiap langkah proses. Perluas mereka dalam urutan yang tercantum.
## Tentukan detail konfigurasi
**Untuk menentukan detail konfigurasi**
1. [Buka konsol Amazon Chime di https://console.aws.amazon.com/chime-sdk/ rumah.](https://console.aws.amazon.com/chime-sdk/home)
1. Di panel navigasi, di bawah **Call Analytics**, pilih **Konfigurasi**, lalu pilih **Buat** konfigurasi.
1. Di bagian **Informasi dasar**, lakukan hal berikut:
1. Masukkan nama untuk konfigurasi. Nama harus mencerminkan kasus penggunaan Anda dan tag apa pun.
1. (Opsional) Di bawah **Tag**, pilih **Tambahkan tag baru**, lalu masukkan kunci tag dan nilai opsional Anda. Anda menentukan kunci dan nilai. Tag dapat membantu Anda menanyakan konfigurasi.
1. Pilih **Berikutnya**.
## Mengkonfigurasi perekaman
**Untuk mengkonfigurasi perekaman**
+ Pada halaman **Konfigurasi perekaman**, lakukan hal berikut:
1. Pilih kotak centang **Aktifkan perekaman panggilan**. Ini memungkinkan perekaman untuk panggilan Konektor Suara atau aliran KVS dan mengirim data ke bucket Amazon S3 Anda.
1. Di bawah **Format file**, pilih **WAV dengan PCM** untuk kualitas audio terbaik.
— atau —
Pilih **OGG dengan OPUS** untuk mengompres audio dan mengoptimalkan penyimpanan.
1. (Opsional) Jika diperlukan, pilih tautan **Buat bucket Amazon S3** dan ikuti langkah-langkah tersebut untuk membuat bucket Amazon S3.
1. Masukkan URI bucket Amazon S3 Anda, atau pilih **Browse** untuk menemukan bucket.
1. (Opsional) Pilih **Aktifkan peningkatan suara** untuk membantu meningkatkan kualitas audio rekaman Anda.
1. Pilih **Berikutnya**.
## Memahami peningkatan suara
Saat membuat konfigurasi analitik panggilan, Anda dapat mengaktifkan perekaman panggilan dan menyimpan panggilan yang direkam dalam bucket Amazon S3. Sebagai bagian dari itu, Anda juga dapat mengaktifkan peningkatan suara dan meningkatkan kualitas audio panggilan Anda yang disimpan. Peningkatan suara hanya berlaku untuk rekaman yang dihasilkan setelah fitur diaktifkan. Saat kemampuan peningkatan suara aktif, rekaman yang disempurnakan dibuat selain rekaman asli, dan disimpan dalam bucket dan format Amazon S3 yang sama. Peningkatan suara akan menghasilkan rekaman yang disempurnakan untuk panggilan yang berdurasi hingga 30 menit. Rekaman yang disempurnakan tidak akan dihasilkan untuk panggilan yang lebih dari 30 menit.
Panggilan telepon disaring sempit dan diambil sampelnya pada 8. KHz Peningkatan suara meningkatkan laju pengambilan sampel dari 8kHz menjadi 16kHz dan menggunakan model pembelajaran mesin untuk memperluas konten frekuensi dari pita sempit ke pita lebar untuk membuat pidato lebih terdengar alami. Peningkatan suara juga menggunakan model pengurangan kebisingan yang disebut Amazon Voice Focus untuk membantu mengurangi kebisingan latar belakang dalam audio yang disempurnakan.
Peningkatan suara juga menggunakan model pengurangan kebisingan yang disebut Voice Focus. Model ini membantu mengurangi kebisingan latar belakang dalam audio yang disempurnakan. Peningkatan suara menerapkan model ke 16 KHz audio yang ditingkatkan.
**catatan**
Fitur peningkatan suara hanya didukung di Wilayah AS Timur (Virginia N.) dan Wilayah AS Barat (Oregon).
*Metadata rekaman peningkatan suara dipublikasikan melalui KDS yang dikonfigurasi ke dalam tabel katalog data AWS Glue yang ada call\$1analytics\$1recording\$1metadata.* *Untuk mengidentifikasi rekaman rekaman panggilan asli dari rekaman panggilan yang disempurnakan suara, bidang baru yang disebut *detail-subtipe* dengan nilai ditambahkan ke notifikasi KDS dan tabel lem *VoiceEnhancement*call\$1analytics\$1recording\$1metadata.* Untuk informasi selengkapnya tentang skema gudang data, lihat[Model data analitik panggilan untuk Amazon Chime SDK](ca-data-model.md).
### Format file peningkatan suara
Perhatikan hal berikut tentang file rekaman yang disempurnakan.
+ Rekaman yang disempurnakan ditulis ke bucket Amazon S3 yang sama dengan rekaman biasa. Anda mengonfigurasi tujuan dengan memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_S3RecordingSinkConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_S3RecordingSinkConfiguration.html)atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_S3RecordingSinkRuntimeConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_S3RecordingSinkRuntimeConfiguration.html)APIs, atau dengan menggunakan konsol Amazon Chime SDK.
+ Rekaman yang disempurnakan telah **\$1ditingkatkan** ditambahkan ke nama file dasar. nama.
+ Rekaman yang disempurnakan menyimpan format file yang sama dengan rekaman asli. Anda mengonfigurasi format file dengan memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_S3RecordingSinkConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_S3RecordingSinkConfiguration.html)atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_S3RecordingSinkRuntimeConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_S3RecordingSinkRuntimeConfiguration.html) APIs, atau dengan menggunakan konsol Amazon Chime SDK.
Contoh berikut menunjukkan format nama file yang khas.
```
s3://original_file_name_enhanced.wav
```
atau
```
s3://original_file_name_enhanced.ogg
```
## Konfigurasikan layanan analitik
Amazon Transcribe menyediakan transkripsi teks panggilan. Anda kemudian dapat menggunakan transkrip untuk menambah layanan pembelajaran mesin lainnya seperti Amazon Comprehend atau model pembelajaran mesin Anda sendiri.
**catatan**
Amazon Transcribe juga menyediakan pengenalan bahasa otomatis. Namun, Anda tidak dapat menggunakan fitur tersebut dengan model bahasa khusus atau redaksi konten. Selain itu, jika Anda menggunakan identifikasi bahasa dengan fitur lain, Anda hanya dapat menggunakan bahasa yang didukung fitur tersebut. Untuk informasi selengkapnya, lihat [Identifikasi bahasa dengan transkripsi streaming](https://docs.aws.amazon.com/transcribe/latest/dg/lang-id-stream.html), di Panduan Pengembang *Amazon Transcribe*.
Amazon Transcribe Call Analytics adalah API berbasis pembelajaran mesin yang menyediakan transkrip panggilan, sentimen, dan wawasan percakapan waktu nyata. Layanan ini menghilangkan kebutuhan untuk mencatat, dan dapat memungkinkan tindakan segera pada masalah yang terdeteksi. Layanan ini juga menyediakan analitik pasca-panggilan, seperti sentimen penelepon, driver panggilan, waktu non-bicara, interupsi, kecepatan bicara, dan karakteristik percakapan.
**catatan**
Secara default, analitik pasca-panggilan mengalirkan rekaman panggilan ke bucket Amazon S3 Anda. Untuk menghindari pembuatan rekaman duplikat, jangan aktifkan perekaman panggilan dan analitik pasca-panggilan secara bersamaan.
Terakhir, Transcribe Call Analytics dapat secara otomatis menandai percakapan berdasarkan frasa tertentu dan membantu menyunting informasi sensitif dari audio dan teks. Untuk informasi selengkapnya tentang prosesor media analitik panggilan, wawasan yang dihasilkan oleh prosesor ini, dan tujuan keluaran[Panggilan prosesor analitik dan tujuan keluaran untuk Amazon Chime SDK](call-analytics-processor-and-output-destinations.md), lihat, nanti di bagian ini.
**Untuk mengonfigurasi layanan analitik**
1. Pada halaman **Konfigurasi layanan analitik**, pilih kotak centang di samping **Analitik suara** atau **Layanan Transkripsi**. Anda dapat memilih kedua item.
Pilih **Analitik suara**, kotak centang untuk mengaktifkan kombinasi **pencarian Speaker** dan **analisis nada suara**.
Pilih kotak centang **Layanan transkripsi** untuk mengaktifkan Amazon Transcribe atau Transcribe Call Analytics.
1. **Untuk mengaktifkan pencarian Speaker**
+ **Pilih kotak centang **Ya, saya setuju dengan Pengakuan Persetujuan untuk Amazon Chime SDK voice** analytics, lalu pilih Terima.**
1. Untuk mengaktifkan analisis nada suara
+ Pilih kotak centang **Analisis nada suara**.
1. Untuk mengaktifkan Amazon Transcribe
1. Pilih tombol **Amazon Transcribe.**
1. Di bawah **Pengaturan bahasa**, lakukan salah satu hal berikut:
1. Jika penelepon Anda berbicara satu bahasa, pilih **Bahasa tertentu**, lalu buka daftar **Bahasa** dan pilih bahasa.
1. Jika penelepon Anda berbicara beberapa bahasa, Anda dapat mengidentifikasi mereka secara otomatis. Pilih **Deteksi bahasa otomatis**.
1. Buka **opsi Bahasa untuk daftar identifikasi bahasa otomatis** dan pilih setidaknya dua bahasa.
1. (Opsional) Buka daftar **Bahasa pilihan** dan tentukan bahasa pilihan. Ketika bahasa yang Anda pilih pada langkah sebelumnya memiliki skor kepercayaan yang cocok, layanan mentranskripsikan bahasa yang diinginkan.
1. (Opsional) Perluas **pengaturan penghapusan konten**, pilih satu atau beberapa opsi, lalu pilih satu atau beberapa opsi tambahan yang muncul. Teks pembantu menjelaskan setiap opsi.
1. (Opsional) Perluas **Pengaturan tambahan**, pilih satu atau beberapa opsi, lalu pilih satu atau beberapa opsi tambahan yang muncul. Teks pembantu menjelaskan setiap opsi.
1. Untuk mengaktifkan Amazon Transcribe Call Analytics
1. Pilih tombol **Amazon Transcribe Call Analytics**.
1. Buka daftar **Bahasa** dan pilih bahasa.
1. (Opsional) Perluas **pengaturan penghapusan konten**, pilih satu atau beberapa opsi, lalu pilih satu atau beberapa opsi tambahan yang muncul. Teks pembantu menjelaskan setiap opsi.
1. (Opsional) Perluas **Pengaturan tambahan**, pilih satu atau beberapa opsi, lalu pilih satu atau beberapa opsi tambahan yang muncul. Teks pembantu menjelaskan setiap opsi.
1. (Opsional) Perluas **pengaturan analitik pasca-panggilan** dan lakukan hal berikut:
1. Pilih kotak centang **Analisis pasca-panggilan**.
1. Masukkan URI bucket Amazon S3 Anda.
1. Pilih jenis redaksi konten.
1. Ketika Anda selesai membuat pilihan Anda, pilih **Berikutnya**.
## Konfigurasikan detail keluaran
Setelah Anda menyelesaikan langkah-langkah pemrosesan media, Anda memilih tujuan untuk output analitik. Analisis panggilan memberikan wawasan langsung melalui Amazon Kinesis Data Streams, dan secara opsional melalui gudang data di bucket Amazon S3 pilihan Anda. Untuk membuat gudang data, Anda menggunakan CloudFormation Template. Template membantu Anda membuat infrastruktur yang memberikan metadata panggilan dan wawasan ke bucket Amazon S3 Anda. Untuk informasi lebih lanjut tentang pembuatan gudang data, lihat[Membuat danau data Amazon Chime SDK](ca-data-lake.md), nanti di bagian ini. Untuk informasi lebih lanjut tentang skema gudang data, lihat[Model data analitik panggilan untuk Amazon Chime SDK](ca-data-model.md), juga nanti di bagian ini.
Jika Anda mengaktifkan analisis suara di bagian sebelumnya, Anda juga dapat menambahkan tujuan notifikasi analitik suara seperti AWS Lambda, Amazon Simple Queue Service, atau Amazon Simple Notification Service. Langkah-langkah berikut menjelaskan caranya.
**Untuk mengkonfigurasi rincian output**
1. Buka daftar **aliran data Kinesis dan pilih aliran** data Anda.
**catatan**
Jika ingin memvisualisasikan data, Anda harus memilih aliran data Kinesis yang digunakan oleh bucket Amazon S3 dan Amazon Kinesis Data Firehose.
1. (Opsional) Perluas **tujuan pemberitahuan analitik suara tambahan** dan pilih kombinasi tujuan AWS Lambda, Amazon SNS, dan Amazon SQS.
1. (Opsional) Di bawah **Menganalisis dan memvisualisasikan wawasan**, pilih kotak centang **Lakukan analisis historis dengan data lake**. Untuk informasi lebih lanjut tentang data lake, lihat[Membuat danau data Amazon Chime SDK](ca-data-lake.md), nanti di bagian ini.
1. Setelah selesai, silakan pilih **Berikutnya**.
## Konfigurasikan izin akses
Untuk mengaktifkan analitik panggilan, layanan pembelajaran mesin dan sumber daya lainnya harus memiliki izin untuk mengakses media data dan memberikan wawasan. Anda dapat menggunakan peran layanan yang ada atau menggunakan konsol untuk membuat peran baru. Untuk informasi lebih lanjut tentang peran, lihat[Menggunakan peran akses sumber daya analitik panggilan untuk Amazon Chime SDK](call-analytics-resource-access-role.md), nanti di bagian ini.
**Untuk mengonfigurasi izin akses**
1. Pada halaman **Konfigurasi izin akses**, lakukan salah satu hal berikut:
1. Pilih **Buat dan gunakan peran layanan baru**.
1. Di kotak **Sufiks nama peran layanan**, masukkan sufiks deskriptif untuk peran tersebut.
— atau —
1. Pilih **Gunakan peran layanan yang ada**.
1. Buka daftar **peran Layanan** dan pilih peran.
1. Pilih **Berikutnya**.
## (Opsional) Konfigurasikan peringatan waktu nyata
**penting**
Untuk menggunakan peringatan waktu nyata, Anda harus mengaktifkan Amazon Transcribe atau Amazon Transcribe Analytics terlebih dahulu.
Anda dapat membuat seperangkat aturan yang mengirim peringatan waktu nyata ke Amazon EventBridge. Jika wawasan yang dihasilkan oleh Amazon Transcribe atau Amazon Transcribe Call Analytics cocok dengan aturan yang Anda tentukan selama sesi analitik, peringatan akan dikirim. Peringatan memiliki jenis `Media Insights Rules Matched` detail. EventBridge mendukung integrasi dengan layanan hilir seperti Amazon Lambda, Amazon SQS, dan Amazon SNS untuk memicu pemberitahuan bagi pengguna akhir atau memulai logika bisnis khusus lainnya. Untuk informasi lebih lanjut, lihat[Menggunakan EventBridge notifikasi Amazon untuk Amazon Chime SDK](using-eventbridge-notifications.md), nanti di bagian ini.
**Untuk mengkonfigurasi peringatan**
1. Di bawah **Peringatan waktu nyata**, pilih **Peringatan waktu nyata aktif**.
1. Di bawah **Aturan**, pilih **Buat aturan**.
1. Di kotak **Nama aturan**, masukkan nama untuk aturan tersebut.
1. Buka daftar **Jenis aturan** dan pilih jenis aturan yang ingin Anda gunakan.
1. Gunakan kontrol yang muncul untuk menambahkan kata kunci ke aturan dan menerapkan logika, seperti **disebutkan** atau **tidak disebutkan**.
1. Pilih **Berikutnya**.
## Tinjau dan buat
**Untuk membuat konfigurasi**
1. Tinjau pengaturan di setiap bagian. Jika diperlukan pilih **Edit** untuk mengubah pengaturan.
1. Pilih **Buat konfigurasi**.
Konfigurasi Anda muncul di halaman **Konfigurasi** konsol Amazon Chime SDK.
# Menggunakan APIs untuk membuat konfigurasi analitik panggilan untuk Amazon Chime SDK
Anda dapat membuat Konektor Suara dan memanggil konfigurasi analitik secara terprogram, lalu mengaitkannya untuk memulai alur kerja analitik panggilan. Panduan ini mengasumsikan bahwa Anda tahu cara menulis kode.
APIs Yang Anda gunakan bervariasi, tergantung pada jenis alur kerja. Misalnya, untuk merekam audio, pertama-tama Anda memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API untuk membuat konfigurasi analitik panggilan. Anda kemudian memanggil [CreateVoiceConnector](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceConnector.html)untuk membuat Konektor Suara. Terakhir, Anda mengaitkan konfigurasi dengan Konektor Suara dengan menggunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_PutVoiceConnectorStreamingConfiguration.html)API.
Sebaliknya, untuk merekam audio dengan produser aliran video Kinesis, Anda menelepon [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html), lalu memanggil API. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)
Untuk informasi selengkapnya tentang penggunaan konfigurasi analitik panggilan untuk mengaktifkan alur kerja yang berbeda, lihat alur kerja di [Menggunakan konfigurasi analitik panggilan untuk Amazon Chime SDK](using-call-analytics-configurations.md) bagian ini nanti.
# Mengaitkan konfigurasi dengan Konektor Suara untuk Amazon Chime SDK
Setelah Anda menggunakan konsol untuk membuat konfigurasi analitik panggilan, Anda menggunakan konfigurasi dengan mengaitkan Konektor Suara dengannya. Konektor Suara kemudian secara otomatis memanggil layanan analitik yang ditentukan dalam konfigurasi Anda. Konektor Suara memanggil analitik panggilan untuk setiap panggilan.
**Untuk mengaitkan Konektor Suara**
1. [Buka konsol Amazon Chime di https://console.aws.amazon.com/chime-sdk/ rumah.](https://console.aws.amazon.com/chime-sdk/home)
1. **Di panel navigasi, di bawah **SIP Trunking**, pilih Konektor Suara.**
1. Pilih nama Konektor Suara yang ingin Anda kaitkan dengan konfigurasi, lalu pilih tab **Streaming**.
1. Jika belum dipilih, pilih **Mulai untuk memulai** streaming ke Kinesis Video Streams.
1. Di bawah **Call Analytics**, pilih **Activate**, dan pada menu yang muncul, pilih ARN konfigurasi analitik panggilan Anda.
1. Pilih **Simpan**.
**catatan**
Setelah mengaktifkan, menonaktifkan, atau memodifikasi konfigurasi yang terkait dengan Konektor Suara, biarkan 5 menit agar pengaturan baru menyebar melalui layanan dan mulai berlaku.
Untuk informasi selengkapnya tentang konfigurasi analitik panggilan, lihat [Mengelola analitik panggilan](https://docs.aws.amazon.com/chime-sdk/latest/ag/ag-call-analytics.html) di Panduan Administrator *Amazon Chime SDK*.
Untuk informasi selengkapnya tentang penggunaan konfigurasi analitik panggilan untuk mengaktifkan alur kerja yang berbeda, lihat[Menggunakan konfigurasi analitik panggilan untuk Amazon Chime SDK](using-call-analytics-configurations.md), nanti di bagian ini.
# Menggunakan konfigurasi analitik panggilan untuk Amazon Chime SDK
Untuk memproses audio menggunakan konfigurasi analitik panggilan, Anda harus membuat pipeline analitik panggilan, juga dikenal sebagai pipeline wawasan media. Pipeline dibuat selama panggilan untuk menangani audio dan dihentikan pada akhir panggilan. Saluran analitik panggilan memerlukan ARN dari konfigurasi analitik panggilan, dan informasi tentang sumber audio. Konfigurasi analitik panggilan mencakup detail tentang prosesor audio, tujuan wawasan, dan konfigurasi peristiwa peringatan, *tetapi bukan sumber audio*. Ini memungkinkan Anda untuk menggunakan kembali konfigurasi di seluruh alur kerja analitik panggilan yang berbeda, seperti dengan Konektor Suara atau sumber KVS yang berbeda. Pipeline analitik panggilan memanggil layanan pembelajaran mesin yang ditentukan dalam konfigurasi dan merekam audio. Anda dapat menghentikan pipeline secara manual atau otomatis saat panggilan berakhir.
Anda dapat menggunakan pipeline analitik panggilan dalam berbagai kasus penggunaan. Alur kerja berikut menunjukkan cara-cara potensial untuk menggunakan konfigurasi dan pipeline analitik panggilan.
**Topics**
+ [Memahami alur kerja untuk merekam panggilan untuk Amazon Chime SDK](recording-workflows.md)
+ [Memahami alur kerja untuk analitik berbasis pembelajaran mesin untuk Amazon Chime SDK](ml-based-analytics.md)
# Memahami alur kerja untuk merekam panggilan untuk Amazon Chime SDK
Topik di bagian ini mencantumkan dan menjelaskan alur kerja untuk merekam panggilan dan Kinesis Video Streams.
# Merekam panggilan Konektor Suara
Gunakan alur kerja ini saat:
+ Anda sudah menggunakan, atau berencana untuk menggunakan, Konektor Suara untuk membawa media SIP ke dalam analitik panggilan.
**catatan**
Konektor Suara mendukung SIP dan SIPREC. Untuk informasi selengkapnya, lihat [Mengelola Konektor Suara Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html), di Panduan Administrator *Amazon Chime* SDK.
+ Anda ingin merekam panggilan SIP atau SIPREC secara otomatis dengan latensi rendah ke tujuan Amazon Simple Storage Service pilihan Anda.
+ Anda ingin menggunakan konsol Amazon Chime SDK untuk membuat konfigurasi dan mengaitkannya dengan Konektor Suara.
+ Anda ingin menerapkan konfigurasi perekaman yang sama ke setiap panggilan Konektor Suara. Jika Anda ingin menerapkan beberapa konfigurasi ke satu atau beberapa Konektor Suara, lihat bagian berikutnya.
Untuk mengaktifkan pemanggilan secara terprogram, gunakan Amazon Chime SDK berikut. APIs
+ Gunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API untuk membuat konfigurasi analitik panggilan
+ Gunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceConnector.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceConnector.html)untuk membuat Konektor Suara.
+ Gunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html)API untuk mengaitkan konfigurasi dengan Konektor Suara.
Untuk informasi selengkapnya, lihat [Mengonfigurasi Konektor Suara untuk menggunakan analitik panggilan](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html) di Panduan *Administrator Amazon Chime SDK*.
Diagram berikut menunjukkan aliran data saat Konektor Suara memulai sesi perekaman panggilan. Angka dalam diagram sesuai dengan teks bernomor di bawah ini.
![\[Gambar yang menunjukkan aliran data saat Konektor Suara mulai merekam panggilan.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/call-analytics-workflow-1.png)
Dalam diagram:
1. Gunakan konsol Amazon Chime SDK atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API untuk membuat konfigurasi analitik panggilan. Selama proses pembuatan konfigurasi, Anda cukup mengaktifkan perekaman panggilan, memilih format file perekaman yang diinginkan, dan menentukan tujuan Amazon S3 untuk menyimpan file rekaman. Untuk informasi selengkapnya, lihat [Membuat konfigurasi analitik panggilan](https://docs.aws.amazon.com/chime-sdk/latest/ag/create-ca-config.html), di Panduan Administrator *Amazon Chime SDK*.
1. Anda menggunakan konsol Amazon Chime SDK atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html)API untuk mengaitkan konfigurasi dengan Konektor Suara. Untuk menggunakan konsol, lihat [Mengonfigurasi Konektor Suara untuk menggunakan analitik panggilan](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html).
1. Selama panggilan keluar, Konektor Suara menerima audio setiap peserta panggilan.
1. Jika konfigurasi perekaman analitik panggilan dilampirkan ke Konektor Suara, layanan Konektor Suara menggunakan layanan saluran media untuk memulai sesi perekaman analitik panggilan.
1. Layanan pipa media memulai prosesor perekaman panggilan yang memantau panggilan yang sedang berlangsung.
1. Saat panggilan berakhir, layanan saluran media mengirimkan file perekaman panggilan ke bucket Amazon S3 yang ditunjuk dan menyediakan metadata perekaman melalui Amazon Kinesis Data Stream. Jika gudang data diaktifkan, metadata panggilan juga masuk ke gudang data Amazon Simple Storage Service. Dalam kasus di mana SIPREC digunakan untuk memasukkan audio SIP ke dalam analitik panggilan, metadata panggilan menyertakan metadata SIPREC dalam format tabel. Untuk informasi lebih lanjut tentang tabel rekaman, lihat[Memahami tabel katalog AWS Glue data untuk Amazon Chime SDK](glue-tables.md), nanti di bagian ini.
1. Layanan pipa media mengirimkan peristiwa status pipeline ke Amazon default EventBridge. Untuk informasi selengkapnya lihat, [Menggunakan EventBridge notifikasi](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html) dalam panduan ini.
**catatan**
Harap dicatat, Anda harus mengaktifkan streaming Konektor Suara untuk mengaktifkan perekaman dengan Konektor Suara. Fitur ini memungkinkan streaming data panggilan ke Kinesis Video Streams yang dikelola Konektor Suara di akun Anda. Untuk informasi selengkapnya, lihat [Streaming media Konektor Suara Amazon Chime SDK ke Kinesis Video Streams](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html) di Panduan Administrator *Amazon* Chime SDK.
Anda juga dapat menyimpan data panggilan yang dibuat Konektor Suara di Kinesis Video Streams untuk berbagai durasi, mulai dari jam hingga hari atau bahkan bertahun-tahun. Memilih untuk tidak ada retensi data membatasi kegunaan data panggilan untuk konsumsi segera. Biaya Kinesis Video Streams ditentukan berdasarkan bandwidth dan total penyimpanan yang digunakan. Anda dapat menyesuaikan periode penyimpanan data kapan saja dalam konfigurasi streaming Konektor Suara. Untuk mengaktifkan perekaman analitik panggilan, Anda harus memastikan bahwa Kinesis Video Stream menyimpan data cukup lama untuk melakukan analisis panggilan. Anda melakukannya dengan menentukan periode retensi data yang sesuai.
Anda dapat mengaitkan konfigurasi pipeline wawasan panggilan dengan Konektor Suara sebanyak yang Anda inginkan. Anda juga dapat membuat konfigurasi yang berbeda untuk setiap Konektor Suara. Konektor Suara menggunakan AWSService RoleForAmazonChimeVoiceConnector file untuk memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API atas nama Anda satu kali per ID transaksi. *Untuk informasi tentang peran tersebut, lihat [Menggunakan peran terkait layanan Amazon Chime SDK untuk Konektor Suara Amazon Chime SDK di Panduan Administrator SDK Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-stream.html#service-linked-role-permissions-stream).*
# Merekam dengan produsen streaming Video Amazon Kinesis
Anda merekam streaming Video Amazon Kinesis saat:
+ Anda perlu menerapkan konfigurasi yang berbeda ke panggilan alih-alih menggunakan konfigurasi yang sama untuk setiap panggilan Konektor Suara.
+ Anda ingin merekam audio SIP atau non-SIP yang tidak diproses oleh Konektor Suara.
Untuk menggunakan opsi perekaman panggilan ini, Anda perlu mempublikasikan audio ke Kinesis Video Streams (KVS) dan kemudian [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)memanggil API dengan informasi saluran aliran KVS dan ARN konfigurasi analitik panggilan.
**catatan**
Analitik panggilan APIs mendukung maksimal dua saluran audio. Anda juga dapat mengaktifkan streaming Konektor Suara, lalu menggunakan informasi KVS yang dipublikasikan di EventBridge notifikasi Konektor Suara untuk memulai perekaman panggilan.
Saat memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API, Anda dapat memilih apakah akan menentukan nomor fragmen untuk setiap definisi saluran aliran KVS atau tidak. Jika Anda memberikan nomor fragmen, analitik panggilan akan mulai memproses aliran di fragmen tersebut. Jika Anda tidak menentukan ID fragmen, analitik panggilan akan mulai memproses aliran dari fragmen terbaru yang tersedia.
Diagram berikut menunjukkan aliran data saat Konektor Suara memulai sesi perekaman panggilan. Angka dalam diagram sesuai dengan teks bernomor di bawah ini.
![\[Gambar yang menunjukkan aliran data saat Konektor Suara mulai merekam panggilan.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/call-analytics-workflow-2.png)
Dalam diagram:
1. Anda dapat menggunakan konsol Amazon Chime SDK atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API untuk membuat konfigurasi perekaman panggilan.
1. Gunakan AWS SDK untuk membuat aplikasi yang mendorong audio eksternal ke KVS, atau aktifkan streaming Konektor Suara untuk mempublikasikan audio panggilan secara otomatis ke KVS. Untuk informasi selengkapnya, lihat [Streaming media Konektor Suara Amazon Chime SDK ke Kinesis Video Streams](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html) di Panduan Administrator SDK *Amazon* Chime.
1. Jika streaming Konektor Suara diaktifkan, layanan Konektor Suara akan mengirimkan notifikasi ke default EventBridge.
1. Dalam kasus streaming Konektor Suara, aplikasi Anda dapat menggunakan `STARTED` acara streaming Amazon Chime Voice Connector dari EventBridge untuk mengumpulkan informasi aliran KVS tentang kaki panggilan.
1. Setelah aplikasi Anda memiliki informasi audio dari peristiwa streaming Konektor Suara atau sumber eksternal, aplikasi Anda akan memanggil Amazon Chime [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)SDK API.
1. Layanan pipa media memulai prosesor perekaman panggilan yang memantau panggilan yang sedang berlangsung.
1. Layanan pipa media mengirimkan peristiwa status pipeline ke Amazon default EventBridge. Untuk informasi selengkapnya, lihat [Menggunakan EventBridge notifikasi](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html).
1. Setelah panggilan selesai, layanan pipa media akan mengirimkan file rekaman panggilan ke bucket Amazon S3 yang ditunjuk dan menyediakan metadata perekaman melalui Amazon Kinesis Data Stream. Jika gudang data diaktifkan, metadata panggilan juga akan dikirim ke gudang data Amazon S3. Dalam kasus di mana SIPREC digunakan untuk memasukkan audio SIP ke dalam analitik panggilan, metadata panggilan akan menyertakan metadata SIPREC dalam format tabel yang nyaman. Untuk informasi lebih lanjut tentang tabel rekaman, lihat[Memahami tabel katalog AWS Glue data untuk Amazon Chime SDK](glue-tables.md), nanti di bagian ini.
1. Aplikasi Anda dapat memantau pipeline, dan dalam kasus Konektor Suara, status panggilan menggunakan peristiwa yang dipublikasikan ke Amazon EventBridge. Untuk informasi selengkapnya lihat, [Menggunakan EventBridge notifikasi](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html) dalam panduan ini.
1. Untuk menghentikan perekaman, panggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html)API untuk menghentikan perekaman panggilan.
Untuk perekaman dan contoh berbasis API lihat, [perekaman Amazon S3 tenggelam dalam panduan](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-processors-sinks.html#ca-s3-recording-sink) ini.
# Menggunakan CLI untuk mulai merekam
Contoh di bagian ini menjelaskan cara melakukan hal berikut:
+ Gunakan CLI untuk menjalankan konfigurasi analitik panggilan dan memanggil. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)
+ Gunakan CLI untuk menentukan tujuan perekaman format file audio, dan nama file audio.
**Topics**
+ [Menjalankan konfigurasi dan memulai pipeline](#cli-run-config)
+ [Menetapkan tujuan, nama, dan format](#cli-set-buckets-formats)
## Menjalankan konfigurasi dan memulai pipeline
Gunakan perintah berikut untuk menjalankan konfigurasi dan memulai pipeline wawasan media. File pipeline.json berisi pengaturan konfigurasi.
```
aws chime-sdk-media-pipeline create-media-insights-pipeline --cli-input-json file://pipeline.json
```
Contoh berikut menunjukkan `pipeline.json` file tipikal.
```
{
"MediaInsightsPipelineConfigurationArn": arn:aws:chime:region;account_id:media-insights-pipeline-configuration/MyConfiguration,
"KinesisVideoStreamRecordingSourceRuntimeConfiguration": {
"Streams": [
{
"StreamArn": kinesis_video_stream_arn_1
},
{
"StreamArn": kinesis_video_stream_arn_2
}
],
"FragmentSelector": {
"FragmentSelectorType": "selector_type", // Specify "server_timestamp" or "producer_timestamp" as the fragment selector type
"TimestampRange": {
"StartTimestamp": epoch_time_seconds,
"EndTimestamp": epoch_time_seconds
}
}
},
"S3RecordingSinkRuntimeConfiguration": {
"Destination": arn:aws:s3:::bucket_name/prefix/optional_file_name,
"RecordingFileFormat": file_format // Specify "Opus" or "WAV" as the recording file format, if you want to override the configuration
}
}
```
`MediaInsightsPipelineConfigurationArn`Ini adalah ARN konfigurasi yang Anda terima setelah Anda membuat konfigurasi analitik panggilan.
## Menetapkan tujuan, nama, dan format
Contoh berikut menggunakan folder bernama `MyRecordingBucket` sebagai `S3SinkConfiguration.Destination` nilai, dan `Opus` sebagai `RecordingFileFormat` nilai.
```
arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.ogg
```
Contoh berikut menggunakan `MyRecordingBucket` sebagai `S3SinkConfiguration.Destination` nilai, dan `Wav` sebagai `RecordingFileFormat` nilai.
```
arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.wav
```
# Memahami alur kerja untuk analitik berbasis pembelajaran mesin untuk Amazon Chime SDK
Bagian berikut menjelaskan cara menggunakan fitur analisis pembelajaran mesin yang disediakan oleh analitik panggilan Amazon Chime SDK.
**catatan**
Jika Anda berencana untuk menjalankan beberapa analisis pembelajaran mesin pada Kinesis Video Stream yang sama, Anda mungkin perlu meningkatkan batas tingkat koneksi untuk dan untuk streaming video. `GetMedia` `GetMediaForFragmentList` Untuk informasi selengkapnya, lihat batas [Kinesis Video](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html) Streams *di Panduan Pengembang Kinesis Video Streams*.
# Menggunakan Konektor Suara untuk memulai analitik panggilan secara otomatis
Gunakan alur kerja ini saat:
+ Anda ingin pengaturan berbasis konsol.
+ Anda sudah menggunakan atau berencana menggunakan Konektor Suara untuk membawa media SIP ke analitik panggilan. Konektor Suara mendukung SIP serta SIPREC. Untuk informasi selengkapnya tentang mengonfigurasi Konektor Suara, lihat [Mengelola Konektor Suara Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html).
+ Anda ingin menerapkan konfigurasi wawasan media yang sama ke setiap panggilan Konektor Suara.
+ Anda perlu menggunakan analitik suara Amazon Chime SDK, yang memerlukan Konektor Suara atau pipeline wawasan media.
Untuk mengaktifkan alur kerja ini di konsol Amazon Chime SDK, ikuti langkah-langkah untuk membuat konfigurasi perekaman di [Mengonfigurasi Konektor Suara untuk menggunakan analitik](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html) panggilan.
Untuk mengaktifkan alur kerja ini secara terprogram, gunakan APIs: [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API berikut ini untuk membuat konfigurasi analitik panggilan dan kemudian mengaitkan konfigurasi ke Konektor Suara menggunakan API. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html) Untuk informasi selengkapnya, lihat [Mengonfigurasi Konektor Suara untuk menggunakan analitik suara](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html) di Panduan *Administrator Amazon Chime SDK*.
Diagram berikut menunjukkan aliran data saat Konektor Suara memulai sesi analisis panggilan. Angka dalam diagram sesuai dengan teks bernomor di bawah ini.
![\[Image showing the flow of data when a Voice Connector initiates a call.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/call-analytics-workflow-1.png)
Dalam diagram:
1. Anda menggunakan konsol Amazon Chime SDK atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API untuk membuat konfigurasi pipeline wawasan media.
1. Anda menggunakan konsol Amazon Chime SDK atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html)API untuk mengaitkan konfigurasi dengan Konektor Suara. Untuk mengaitkan konfigurasi yang ada dengan Konektor Suara, lihat [Mengonfigurasi Konektor Suara untuk menggunakan analitik panggilan](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html), di Panduan Administrator *SDK Amazon Chime*.
1. Selama panggilan keluar, Konektor Suara menerima audio setiap peserta panggilan.
1. Karena integrasi bawaan dengan analitik panggilan, jika konfigurasi analitik panggilan dilampirkan ke Konektor Suara, layanan Konektor Suara memulai sesi analitik panggilan menggunakan layanan saluran media.
1. Layanan pipa media memanggil satu atau lebih prosesor media seperti yang ditentukan dalam konfigurasi.
1. Layanan pipa media mengirimkan data output ke satu atau lebih tujuan berdasarkan konfigurasi. Misalnya, Anda dapat mengirim analitik real-time melalui Amazon Kinesis Data Stream, dan jika dikonfigurasi, Anda dapat mengirim metadata panggilan dan analitik ke gudang data Amazon S3.
1. Layanan pipa media mengirimkan peristiwa status pipeline ke Amazon default EventBridge. Jika Anda telah mengonfigurasi aturan maka notifikasi untuk mereka akan dikirim ke Amazon EventBridge juga. Untuk informasi selengkapnya lihat, [Menggunakan EventBridge notifikasi](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html).
**catatan**
Prosesor analitik suara hanya dimulai secara otomatis saat Anda memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysisTask.html) APIs.
Anda harus mengaktifkan streaming Konektor Suara untuk menggunakan analitik panggilan dengan Konektor Suara. Fitur ini memungkinkan streaming data panggilan ke Konektor Suara yang dikelola Kinesis Video Streams di akun Anda. Untuk informasi selengkapnya, lihat [Streaming media Konektor Suara Amazon Chime SDK ke Kinesis Video Streams](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html) di Panduan Administrator *Amazon* Chime SDK.
Anda dapat menyimpan data panggilan Konektor Suara di Kinesis Video Streams untuk berbagai jumlah waktu, mulai dari jam hingga tahun. Memilih untuk tidak ada retensi data membatasi kegunaan data panggilan untuk konsumsi segera. Biaya Kinesis Video Streams ditentukan berdasarkan bandwidth dan total penyimpanan yang digunakan. Dimungkinkan untuk menyesuaikan periode retensi data kapan saja dengan mengedit konfigurasi streaming Konektor Suara Anda. Untuk mengaktifkan perekaman analitik panggilan, Anda harus memastikan bahwa Kinesis Video Stream menyimpan data hingga analitik panggilan selesai. Anda melakukannya dengan menentukan periode retensi data yang sesuai.
Anda dapat mengaitkan konfigurasi pipeline wawasan media dengan Konektor Suara sebanyak yang Anda inginkan. Anda juga dapat membuat konfigurasi yang berbeda untuk setiap Konektor Suara. Konektor Suara menggunakan AWSService RoleForAmazonChimeVoiceConnector file untuk memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API atas nama Anda satu kali per ID transaksi. *Untuk informasi tentang peran tersebut, lihat [Menggunakan peran terkait layanan Amazon Chime SDK untuk Konektor Suara Amazon Chime SDK di Panduan Administrator SDK Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-stream.html#service-linked-role-permissions-stream).*
# Menggunakan analitik panggilan APIs dengan Konektor Suara
Gunakan alur kerja ini jika Anda menggunakan Konektor Suara tetapi perlu mengontrol saat Anda menerapkan konfigurasi analitik panggilan dan panggilan mana yang akan menerapkan konfigurasi.
Untuk menggunakan metode ini, Anda perlu membuat EventBridge target untuk peristiwa yang dipublikasikan oleh Konektor Suara, lalu gunakan peristiwa tersebut untuk memicu pipeline APIs analitik panggilan. Untuk informasi selengkapnya, lihat [Mengotomatiskan Amazon Chime SDK EventBridge dengan di Panduan Administrator](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html) Amazon *Chime* SDK.
Diagram berikut menunjukkan cara menerapkan kontrol yang lebih terperinci saat menggunakan analitik panggilan dengan Konektor Suara. Angka dalam diagram sesuai dengan angka dalam teks di bawah ini.
![\[Gambar yang menunjukkan aliran data saat menggunakan panggilan API dengan Konektor Suara.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/analytics-vc-with-apis.png)
Dalam diagram:
1. Anda menggunakan konsol Amazon Chime SDK atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API untuk membuat konfigurasi pipeline wawasan media.
1. Selama panggilan keluar, Konektor Suara akan menerima audio peserta.
1. Konektor Suara mengirimkan audio panggilan ke Kinesis Video Stream dan peristiwa terkait ke. EventBridge Peristiwa ini memiliki metadata streaming dan panggilan.
1. Aplikasi Anda berlangganan EventBridge melalui EventBridge Target.
1. Aplikasi Anda memanggil Amazon Chime [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)SDK API.
1. Layanan pipa media memanggil satu atau lebih prosesor media berdasarkan elemen prosesor dalam konfigurasi pipa wawasan media.
1. Layanan pipa media mengirimkan data output ke satu atau lebih tujuan berdasarkan konfigurasi. Analisis panggilan Amazon Chime SDK akan menyediakan analitik real-time melalui Amazon Kinesis Data Stream dan jika dikonfigurasi analitik metadata panggilan ke gudang data Amazon S3.
1. Layanan pipa media mengirimkan acara ke Amazon EventBridge. Jika Anda telah mengonfigurasi aturan maka notifikasi untuk mereka akan dikirim ke Amazon EventBridge juga.
1. Anda dapat menjeda atau melanjutkan sesi analitik panggilan dengan menjalankan API. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html)
**catatan**
Rekaman panggilan tidak mendukung jeda dan melanjutkan panggilan. Selain itu, tugas analitik suara yang dimulai untuk panggilan juga berhenti saat Anda menjeda sesi. Untuk memulai ulang, Anda harus memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)or [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs.
1. Jika Anda memilih analitik nada suara selama konfigurasi, Anda memulai analitik suara dengan memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs.
# Menggunakan analitik panggilan dengan produsen Kinesis Video Streams
Untuk menggunakan opsi ini, Anda perlu mempublikasikan data audio ke Kinesis Video Streams (KVS) dan kemudian [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)memanggil API dengan informasi saluran aliran KVS.
**catatan**
Analitik panggilan APIs mendukung maksimal dua saluran audio.
Saat memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API, Anda dapat menentukan nomor fragmen untuk setiap definisi saluran aliran KVS. Jika Anda memberikan nomor fragmen, analitik panggilan mulai memproses aliran di fragmen tersebut. Jika tidak, analitik panggilan mulai memproses aliran dari fragmen terbaru yang tersedia.
Analisis panggilan mendukung audio PCM (hanya format audio endian kecil 16-bit yang ditandatangani, yang tidak termasuk WAV) dengan kecepatan sampel audio antara 8kHz dan 48kHz. Audio berkualitas rendah, seperti audio telepon, biasanya sekitar 8.000 Hz. Audio berkualitas tinggi biasanya berkisar dari 16.000 Hz hingga 48.000 Hz. Rasio sampel yang Anda tentukan harus sesuai dengan audio Anda. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_KinesisVideoStreamSourceRuntimeConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_KinesisVideoStreamSourceRuntimeConfiguration.html)di *Referensi API Amazon Chime SDK*.
Kinesis Video Streams Producer SDK menyediakan sekumpulan pustaka yang dapat Anda gunakan untuk mengalirkan data audio ke Kinesis Video Stream. Untuk informasi selengkapnya, lihat Perpustakaan Produser [Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-sdk.html), *di Panduan Pengembang Amazon Kinesis Video Streams*.
Diagram berikut menunjukkan aliran data saat menggunakan analitik panggilan dengan produsen Kinesis Video Stream kustom. Angka dalam diagram sesuai dengan teks bernomor di bawah ini.
![\[Gambar yang menunjukkan aliran data saat menggunakan analitik panggilan dengan produser Kinesis Video Stream.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/analytics-kvs-with-apis.png)
1. Anda menggunakan AWS konsol atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API untuk membuat konfigurasi pipeline wawasan media.
1. Anda menggunakan Kinesis Video Stream Producer untuk menulis audio ke Kinesis Video Streams.
1. Aplikasi Anda memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API.
1. Layanan pipa media membaca audio dari Kinesis Video Streams pelanggan.
1. Layanan pipa media mengirimkan acara ke Amazon EventBridge. Jika Anda telah mengonfigurasi aturan maka notifikasi untuk mereka akan dikirim ke Amazon EventBridge juga.
1. Layanan pipa media memanggil satu atau lebih elemen prosesor.
1. Layanan pipa media mengirimkan data output ke satu atau lebih elemen sink.
1. Anda dapat menjeda atau melanjutkan sesi analitik panggilan dengan menjalankan API. [ UpdateMediaInsightsPipelineStatus](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html)
**catatan**
Rekaman panggilan tidak mendukung jeda dan melanjutkan.
1. Aplikasi Anda dapat memproses EventBridge peristiwa Amazon untuk memicu alur kerja bisnis kustom.
1. Jika Anda memilih analitik suara saat membuat konfigurasi, aplikasi Anda dapat memulai analitik suara dengan memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs.
# Mengelola pipeline analitik panggilan untuk Amazon Chime SDK
Anda dapat membaca, membuat daftar, dan menghapus pipeline wawasan media dengan memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipeline.html), [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_ListMediaPipelines.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_ListMediaPipelines.html), dan. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html) APIs
Saluran pipa wawasan media berhenti jika salah satu dari kondisi berikut terpenuhi:
+ Aliran Video Kinesis mana pun tidak mengirim fragmen baru ke `InProgress` pipa selama 15 detik.
+ [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html)API disebut.
+ Pipa wawasan media dibuat lebih dari 8 jam yang lalu. Sistem menghentikan pipa secara otomatis.
+ Pipa wawasan media dijeda selama lebih dari 2 jam. Sistem menghentikan pipa secara otomatis.
# Menjeda dan melanjutkan pipeline analitik panggilan untuk Amazon Chime SDK
Untuk menjeda dan melanjutkan pipeline wawasan media, panggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html)API dengan tindakan atau`Pause`. `Resume` Untuk melakukannya, Anda meneruskan ID pipeline atau ARN di lapangan. `Identifier`
**Awas**
Peringatan: `UpdateMediaInsightsPipelineStatus` API *menghentikan* semua tugas analitik suara yang dimulai pada pipeline wawasan media saat `Pause` status diberikan. Ketika `Resume` status diberikan, tugas tidak dilanjutkan dan harus dimulai lagi. Anda harus memberikan semua pemberitahuan yang diperlukan dan mendapatkan semua persetujuan yang diperlukan dari pembicara sebelum memulai kembali tugas. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html), di Referensi *API Amazon Chime SDK*.
Saat dijeda, pipeline berhenti mengirim media ke prosesor dan menulis data ke Kinesis Data Streams dan gudang data. Saat Anda `Resume` melakukan pipeline, layanan mengirimkan potongan terbaru yang tersedia di streaming. Saluran pipa wawasan media berhenti secara otomatis ketika dijeda selama lebih dari 2 jam. **Harap dicatat**, rekaman panggilan tidak mendukung jeda dan melanjutkan.
Untuk selengkapnya, lihat topik berikut:
+ [Menggunakan EventBridge notifikasi](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html).
+ [https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_StartSelector.html#KinesisVideo-Type-dataplane_StartSelector-StartSelectorType](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_StartSelector.html#KinesisVideo-Type-dataplane_StartSelector-StartSelectorType)di Panduan Pengembang *Amazon Kinesis Video Streams*.
+ Prosesor [analitik panggilan Amazon Transcribe](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-processors-sinks.html#ca-transcribe-analytics-processor).
**catatan**
Anda ditagih untuk penggunaan analitik panggilan saat pipeline dijeda. Namun, Anda tidak ditagih untuk AWS layanan yang diakses melalui peran akses sumber daya, seperti Amazon Transcribe dan Amazon Kinesis.
Anda dapat membaca, memperbarui, dan menghapus konfigurasi analitik panggilan yang ada menggunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaInsightsPipelineConfiguration.html), [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineConfiguration.html), dan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaInsightsPipelineConfiguration.html) APIs dengan meneruskan nama konfigurasi atau ARN di bidang Identifier.
Anda dapat membuat daftar konfigurasi dengan memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_media-pipelines-chime_ListMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_media-pipelines-chime_ListMediaInsightsPipelineConfiguration.html)API.
# Menggunakan peran akses sumber daya analitik panggilan untuk Amazon Chime SDK
Akun panggilan harus membuat peran akses sumber daya yang digunakan oleh konfigurasi pipeline wawasan media. Anda tidak dapat menggunakan peran lintas akun.
Bergantung pada fitur yang Anda aktifkan saat membuat konfigurasi analitik panggilan, Anda harus menggunakan kebijakan sumber daya tambahan. Perluas bagian berikut untuk mempelajari lebih lanjut.
## Kebijakan minimum yang diperlukan
Peran tersebut membutuhkan kebijakan berikut, minimal:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [{
"Effect": "Allow",
"Action": [
"transcribe:StartCallAnalyticsStreamTranscription",
"transcribe:StartStreamTranscription"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"kinesisvideo:GetDataEndpoint",
"kinesisvideo:GetMedia"
],
"Resource": "arn:aws:kinesisvideo:us-east-1:111122223333:stream/Chime*"
},
{
"Effect": "Allow",
"Action": [
"kinesisvideo:GetDataEndpoint",
"kinesisvideo:GetMedia"
],
"Resource": "arn:aws:kinesisvideo:us-east-1:111122223333:stream/*",
"Condition": {
"StringLike": {
"aws:ResourceTag/AWSServiceName": "ChimeSDK"
}
}
},
{
"Effect": "Allow",
"Action": ["kms:Decrypt"],
"Resource": "arn:aws:kms:us-east-1:111122223333:key/*",
"Condition": {
"StringLike": {
"aws:ResourceTag/AWSServiceName": "ChimeSDK"
}
}
}
]
}
```
------
Anda juga harus menggunakan kebijakan kepercayaan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "mediapipelines.chime.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "111122223333"
},
"ArnLike": {
"aws:SourceARN": "arn:aws:chime:*:111122223333:*"
}
}
}
]
}
```
------
## KinesisDataStreamSinkkebijakan
Jika Anda menggunakan`KinesisDataStreamSink`, tambahkan kebijakan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [{
"Effect": "Allow",
"Action": [
"kinesis:PutRecord"
],
"Resource": [
"arn:aws:kinesis:us-east-1:111122223333:stream/output_stream_name"
]
},
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/*"
],
"Condition": {
"StringLike": {
"aws:ResourceTag/AWSServiceName": "ChimeSDK"
}
}
}
]
}
```
------
## S3RecordingSinkkebijakan
Jika Anda menggunakan`S3RecordingSink`, tambahkan kebijakan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:PutObjectAcl",
"s3:PutObjectTagging"
],
"Resource": [
"arn:aws:s3:::input_bucket_path/*"
]
},
{
"Effect": "Allow",
"Action": [
"kinesisvideo:GetDataEndpoint",
"kinesisvideo:ListFragments",
"kinesisvideo:GetMediaForFragmentList"
],
"Resource": [
"arn:aws:kinesisvideo:us-east-1:111122223333:stream/*"
],
"Condition": {
"StringLike": {
"aws:ResourceTag/AWSServiceName": "ChimeSDK"
}
}
},
{
"Effect": "Allow",
"Action": [
"kinesisvideo:ListFragments",
"kinesisvideo:GetMediaForFragmentList"
],
"Resource": [
"arn:aws:kinesisvideo:us-east-1:111122223333:stream/Chime*"
]
},
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/*"
],
"Condition": {
"StringLike": {
"aws:ResourceTag/AWSServiceName": "ChimeSDK"
}
}
}
]
}
```
------
## Kebijakan Analisis Posting Panggilan
Jika Anda menggunakan fitur Post Call Analytics`AmazonTranscribeCallAnalyticsProcessor`, tambahkan kebijakan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iam:PassRole"
],
"Resource": [
"arn:aws:iam::111122223333:role/transcribe_role_name"
],
"Condition": {
"StringEquals": {
"iam:PassedToService": "transcribe.streaming.amazonaws.com"
}
}
}
]
}
```
------
## VoiceEnhancementSinkConfigurationkebijakan
Jika Anda menggunakan `VoiceEnhancementSinkConfiguration` elemen, tambahkan kebijakan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action":[
"s3:GetObject",
"s3:PutObject",
"s3:PutObjectAcl",
"s3:PutObjectTagging"
],
"Resource":[
"arn:aws:s3:::input_bucket_path/*"
]
},
{
"Effect":"Allow",
"Action":[
"kinesisvideo:GetDataEndpoint",
"kinesisvideo:ListFragments",
"kinesisvideo:GetMediaForFragmentList"
],
"Resource":[
"arn:aws:kinesisvideo:us-east-1:111122223333:stream/*"
],
"Condition":{
"StringLike":{
"aws:ResourceTag/AWSServiceName":"ChimeSDK"
}
}
},
{
"Effect":"Allow",
"Action":[
"kinesisvideo:ListFragments",
"kinesisvideo:GetMediaForFragmentList"
],
"Resource":[
"arn:aws:kinesisvideo:us-east-1:111122223333:stream/Chime*"
]
},
{
"Effect":"Allow",
"Action":[
"kms:GenerateDataKey"
],
"Resource":[
"arn:aws:kms:us-east-1:111122223333:key/*"
],
"Condition":{
"StringLike":{
"aws:ResourceTag/AWSServiceName":"ChimeSDK"
}
}
}
]
}
```
------
## VoiceAnalyticsProcessorkebijakan
Jika Anda menggunakan`VoiceAnalyticsProcessor`, tambahkan kebijakan untuk`LambdaFunctionSink`,`SqsQueueSink`, dan `SnsTopicSink` tergantung pada sink mana yang telah Anda tetapkan.
`LambdaFunctionSink`kebijakan:
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"lambda:InvokeFunction",
"lambda:GetPolicy"
],
"Resource": [
"arn:aws:lambda:us-east-1:111122223333:function:function_name"
],
"Effect": "Allow"
}
]
}
```
`SqsQueueSink`kebijakan
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"sqs:SendMessage",
"sqs:GetQueueAttributes"
],
"Resource": [
"arn:aws:sqs:us-east-1:111122223333:queue_name"
],
"Effect": "Allow"
},
{
"Effect": "Allow",
"Action": ["kms:GenerateDataKey", "kms:Decrypt"],
"Resource": "arn:aws:kms:us-east-1:111122223333:key/*",
"Condition": {
"StringLike": {
"aws:ResourceTag/AWSServiceName": "ChimeSDK"
}
}
}
]
}
```
`SnsTopicSink`kebijakan:
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"sns:Publish",
"sns:GetTopicAttributes"
],
"Resource": [
"arn:aws:sns:us-east-1:111122223333:topic_name"
],
"Effect": "Allow"
},
{
"Effect": "Allow",
"Action": ["kms:GenerateDataKey", "kms:Decrypt"],
"Resource": "arn:aws:kms:us-east-1:111122223333:key/*",
"Condition": {
"StringLike": {
"aws:ResourceTag/AWSServiceName": "ChimeSDK"
}
}
}
]
}
```
# Memahami status analitik panggilan untuk Amazon Chime SDK
Pipeline wawasan media melacak serangkaian status saat Anda melakukan salah satu atau kedua hal berikut:
+ Gunakan beberapa elemen pemrosesan pembelajaran mesin, seperti Amazon Transcribe dan analitik suara.
+ Aktifkan perekaman panggilan dengan atau tanpa pemrosesan pembelajaran mesin.
Untuk mendapatkan status pipeline dan elemen, gunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaPipeline.html)API dan [EventBridgenotifikasi](using-eventbridge-notifications.md).
Untuk mendapatkan status untuk tugas analitik suara, gunakan [target notifikasi analitik dan dan suara](va-notification-targets.md). [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetSpeakerSearchTask.html) APIs
Pipa wawasan media melacak status berikut.
+ **Status Pipeline** — Status keseluruhan dari pipeline analitik panggilan, juga dikenal sebagai saluran wawasan media. Ini ditentukan oleh status elemen.
+ **Status elemen** - Status pemrosesan untuk elemen konfigurasi pipa wawasan media individu.
+ **Status tugas** — Status pemrosesan untuk tugas pipeline wawasan media dimulai untuk analitik suara. Status `VoiceAnalyticsProcessor` elemen ditentukan oleh status tugas. Tidak ada elemen lain dalam pipeline analitik panggilan yang memiliki status tugas.
Untuk informasi lebih lanjut tentang tugas saluran wawasan media, lihat[Memahami terminologi analitik panggilan untuk Amazon Chime SDK](ca-terms-concepts.md), sebelumnya dalam panduan ini.
Tidak semua jenis elemen konfigurasi wawasan media memiliki status elemen. Secara umum, hanya elemen konfigurasi wawasan media dari tipe “prosesor” yang memiliki status elemen. Selain itu, perekaman Amazon S3 dan sink peningkatan suara memiliki status prosesor. Secara khusus, status elemen ada untuk jenis elemen konfigurasi wawasan media berikut:
+ `AmazonTranscribeProcessor`
+ `AmazonTranscribeCallAnalyticsProcessor`
+ `S3RecordingSink`
+ `VoiceAnalyticsProcessor`
+ `VoiceEnhancementSink`
Status pipa ditentukan oleh status elemen sebagai berikut:
| Status pipa | Kondisi |
| --- | --- |
| NotStarted | Semua status elemen tidak dimulai. |
| Inisialisasi | Setidaknya satu elemen sedang menginisialisasi dan sisanya tidak dimulai. |
| InProgress | Setidaknya satu elemen sedang berlangsung. |
| Gagal | Setidaknya satu elemen telah gagal dan elemen yang tersisa dihentikan. |
| Stopping | Lihat [Mengelola pipeline analitik panggilan untuk Amazon Chime SDK](managing-call-analytics-pipelines.md) untuk daftar lengkap kondisi penghentian. |
| Dihentikan | Semua elemen dihentikan. |
| Dijeda | Semua elemen dijeda. |
Tidak seperti status elemen lainnya, `VoiceAnalyticsProcessor` elemen ini memiliki beberapa nuansa. Seperti disebutkan sebelumnya, status `VoiceAnalyticsProcessor` elemen, yang sesuai dengan fitur analitik suara Amazon Chime SDK, ditentukan oleh status tugas yang dibuat dari dan. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)
+ Status elemen dimulai dalam `NotStarted` keadaan, karena `StartSpeakerSearchTask` dan `StartVoiceToneAnalysisTask` harus dipanggil sebelum elemen dapat mengubah status ke`Initializing`, dan kemudian`InProgress`. `VoiceAnalyticsProcessor`
+ `VoiceAnalyticsProcessor`Tetap `InProgress` selama satu tugas dimulai dan [kondisi berhenti](managing-call-analytics-pipelines.md) tidak terpenuhi saat tugas sedang berjalan.
+ Meskipun `VoiceAnalyticsProcessor` mungkin`InProgress`, Anda hanya akan dikenakan biaya selama proses tugas.
+ Untuk membersihkan pipeline wawasan media yang memiliki setidaknya satu tugas analitik suara dimulai dan tidak ada lagi tugas yang berjalan, Anda harus menelepon. `DeleteMediaPipeline`
+ Selama tugas berjalan atau diselesaikan dengan sukses, status `VoiceAnalyticsProcessor` elemen tetap di`InProgress`.
# Memantau pipeline analitik panggilan untuk Amazon Chime SDK dengan Amazon CloudWatch
Anda dapat menggunakan Amazon CloudWatch untuk memantau saluran analitik panggilan Amazon Chime SDK. Anda juga dapat mengatur alarm yang memperhatikan ambang batas tertentu dan mengirim notifikasi atau mengambil tindakan saat ambang batas tersebut terpenuhi. Untuk informasi selengkapnya CloudWatch, lihat [Panduan CloudWatch Pengguna Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
**Topics**
+ [Prasyarat](#monitoring-prereqs)
+ [Metrik analitik panggilan](#monitoring-metrics)
+ [CloudWatch dimensi untuk metrik pipa](#monitoring-dimensions)
## Prasyarat
Untuk menggunakan CloudWatch metrik, Anda harus terlebih dahulu membuat peran terkait layanan saluran media yang memberikan izin untuk memublikasikan metrik layanan ke Amazon. CloudWatch Untuk informasi selengkapnya tentang peran terkait layanan, lihat[Membuat peran terkait layanan untuk pipeline media Amazon Chime SDK](create-pipeline-role.md), dalam panduan ini.
## Metrik analitik panggilan
Analisis panggilan Amazon Chime SDK menerbitkan metrik berikut ke `AWS/ChimeSDK` namespace untuk pipeline wawasan media yang Anda buat menggunakan konfigurasi wawasan media.
| Metrik | Deskripsi |
| --- | --- |
| `MediaInsightsPipelineCreated` | Pipa wawasan media berhasil dibuat. Unit: Jumlah |
| `MediaInsightsPipelineStopped` | Pipa wawasan media berhasil dihentikan. Unit: Jumlah |
| `MediaInsightsPipelineFailed` | Pipa wawasan media gagal. Unit: Jumlah |
| `MediaInsightsPipelineDuration` | Waktu antara pembuatan pipeline dan Stopped/Failed. Unit: Detik |
| `MediaInsightsPipelineBillingDuration` | Durasi penagihan saluran wawasan media. Unit: Jumlah |
| `RecordingFileSize` | Ukuran file rekaman. Unit: Bita |
| `RecordingDuration ` | Durasi rekaman. Unit: Detik |
## CloudWatch dimensi untuk metrik pipa
Tabel berikut mencantumkan CloudWatch dimensi yang dapat Anda gunakan untuk memantau pipeline analitik panggilan.
| Dimensi | Deskripsi |
| --- | --- |
| `MediaInsightsPipelineConfigurationId` | ID konfigurasi pipeline wawasan media. |
| `MediaInsightsPipelineConfigurationName` | Nama konfigurasi pipa wawasan media. |
# Panggilan prosesor analitik dan tujuan keluaran untuk Amazon Chime SDK
Anda hanya dapat menentukan elemen unik satu kali per konfigurasi pipeline wawasan media. Semua prosesor dan sink harus berada di AWS akun yang sama, dan Anda harus membuatnya di AWS Wilayah yang sama dengan titik akhir yang Anda panggil. Misalnya, jika Anda menggunakan `us-east-1` endpoint untuk Amazon Chime SDK Media Pipelines, Anda tidak dapat meneruskan Kinesis Data Stream dari wilayah tersebut. `us-west-2`
Perluas setiap bagian untuk informasi tentang setiap tujuan.
## Tujuan prosesor Amazon Transcribe Call Analytics
Wastafel yang didukung:`KinesisDataStreamSink`.
Anda tidak dapat menggabungkan prosesor ini dengan prosesor Amazon Transcribe. Untuk informasi selengkapnya tentang Amazon Transcribe Call Analytics, lihat [Analitik panggilan real-time](https://docs.aws.amazon.com/transcribe/latest/dg/call-analytics-streaming.html), di Panduan Pengembang *Amazon Transcribe*. Jika Anda mengaktifkan [analitik posting panggilan](https://docs.aws.amazon.com/transcribe/latest/dg/tca-post-call.html) dengan memasukkan `PostCallAnalyticsSettings` dalam panggilan `AmazonTranscribeCallAnalyticsProcessorConfiguration` API, Anda akan menerima artefak di lokasi Amazon S3 yang ditentukan saat pipeline wawasan media berhenti dan pemrosesan selesai.
**catatan**
Jika Anda menjeda pipeline selama lebih dari 35 detik dan kemudian melanjutkannya, artefak pasca-panggilan dibuat dalam file terpisah dengan sesi berbeda IDs di bucket Amazon S3.
Artefak pasca-panggilan termasuk file JSON analitik dan perekaman audio WAV atau file Opus. URL bucket Amazon S3 untuk disunting (jika Anda mengaktifkan redaksi konten) dan file rekaman yang tidak disunting dikirim ke Kinesis Data Stream satu kali untuk setiap sesi Post Call analytics panggilan Amazon Transcribe sebagai bagian dari bagian metadata. `onetimeMetadata`
Analisis panggilan dengan analitik panggilan Amazon Transcribe mengambil input data audio dari Kinesis Video Stream.
+ Pengkodean media yang didukung: PCM menandatangani audio endian kecil 16-bit.
+ Tingkat sampel media yang didukung: Antara 8.000 Hz dan 48.000 Hz.
`StreamConfiguration`masukan untuk proses Amazon Transcribe Analytics:
+ Anda harus menentukan `KinesisVideoStreamArn` untuk setiap aliran.
+ (Opsional) KVS `FragmentNumber` memulai pekerjaan analitik panggilan dengan potongan setelah fragmen tertentu. Jika tidak disediakan, ia menggunakan potongan terbaru pada aliran video Kinesis.
+ `StreamChannelDefinition`Mendefinisikan siapa yang berbicara. Analisis panggilan Amazon Transcribe memerlukan audio dua saluran. Anda harus menentukan speaker mana yang ada di saluran mana saat Anda memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API. Misalnya, jika agen Anda berbicara terlebih dahulu, Anda mengatur `ChannelId` `0` to untuk menunjukkan saluran pertama, dan `ParticipantRole` `AGENT` untuk menunjukkan bahwa agen berbicara.
**catatan**
Bila Anda menggunakan Konektor Suara untuk membuat `MediaInsightsPipeline` dengan prosesor analitik panggilan Amazon Transcribe, audio kaki akun Voice Connector adalah `AGENT` dan audio kaki PSTN adalah untuk. `CUSTOMER` `ParticipantRole`
Untuk Konektor Suara SIPREC, kami mengandalkan metadata SIPREC. Dalam kebanyakan kasus, label aliran dengan nilai leksikografi terendah dianggap sebagai. `AGENT`
Contoh berikut menunjukkan input Kinesis Video Stream untuk satu aliran audio saluran ganda.
```
"StreamChannelDefinition" : {
"NumberOfChannels" : 2
"ChannelDefinitions": [
{
"ChannelId": 0,
"ParticipantRole": "AGENT"
},
{
"ChannelId": 1,
"ParticipantRole": "CUSTOMER"
}
]
}
```
Sebaliknya, contoh berikut menunjukkan dua input mono dari dua aliran Video Kinesis yang berbeda.
```
KVS-1:
"StreamChannelDefinition" : {
"NumberOfChannels" : 1
"ChannelDefinitions": [
{
"ChannelId": 0,
"ParticipantRole": "AGENT"
}
]
}
KVS-2:
"StreamChannelDefinition" : {
"NumberOfChannels" : 1
"ChannelDefinitions": [
{
"ChannelId": 1,
"ParticipantRole": "CUSTOMER"
}
]
}
```
## Output analitik panggilan Amazon Transcribe
Setiap catatan Amazon Transcribe berisi `UtteranceEvent` atau a`CategoryEvent`, tetapi tidak keduanya. `CategoryEvents`memiliki `detail-type` dari`TranscribeCallAnalyticsCategoryEvent`.
Contoh berikut menunjukkan format keluaran metadata satu kali untuk Amazon Transcribe.
```
{
"time": "string", // ISO8601 format
"service-type": "CallAnalytics",
"detail-type": "CallAnalyticsMetadata",
"mediaInsightsPipelineId": "string",
"metadata": "string" // JSON encoded string of the metadata object
}
// metadata object
{
"voiceConnectorId": "string",
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"direction": "string",
"oneTimeMetadata": "string" // JSON encoded string of oneTimeMetadata object
}
// onetimeMetadata object
{
"inviteHeaders": "string", // JSON encoded string of SIP Invite headers key-value pair
"siprecMetadata": "string", // siprec metadata in XML
"siprecMetadataJson": "string", // siprec metadata in JSON (converted from above XML)
// If PostcallSettings are enabled for Amazon Transcribe Call Analytics
"s3RecordingUrl": "string",
"s3RecordingUrlRedacted": "string"
}
// inviteHeaders object
{
"string": "string"
}
```
Contoh berikut menunjukkan format output Amazon Transcribe Call Analytics.
```
{
"time": "string", // ISO8601 format
"service-type": "CallAnalytics",
"detail-type": "TranscribeCallAnalytics",
"mediaInsightsPipelineId": "string",
"metadata": {
"voiceConnectorId": "string",
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"direction": "string"
},
"UtteranceEvent": {
"UtteranceId": "string",
"ParticipantRole": "string",
"IsPartial": boolean,
"BeginOffsetMillis": number,
"EndOffsetMillis": number,
"Transcript": "string",
"Sentiment": "string",
"Items": [{
"Content": "string",
"Confidence": number,
"VocabularyFilterMatch": boolean,
"Stable": boolean,
"ItemType": "string",
"BeginOffsetMillis": number,
"EndOffsetMillis": number,
}, ]
"Entities": [{
"Content": "string",
"Confidence": number,
"Category": "string", // Only PII is supported currently
"Type": "string",
"BeginOffset": number,
"EndOffset": number,
}, ],
"IssuesDetected": [{
"CharacterOffsets": {
"Begin": number,
"End": number
}
}]
},
"CategoryEvent": {
"MatchedCategories": ["string"],
"MatchedDetails": {
"string": {
"TimestampRanges": [{
"BeginOffsetMillis": number,
"EndOffsetMillis": number
}]
}
}
}
}
```
## Metadata pembaruan streaming Konektor Suara Amazon Chime SDK
Jika konfigurasi analitik panggilan dikaitkan dengan Konektor Suara Amazon Chime SDK, payload Pembaruan Konektor Suara berikut akan dikirim saat ada pembaruan streaming Konektor [Suara](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html).
Contoh berikut menunjukkan format metadata pembaruan untuk prosesor Amazon Transcribe dan prosesor Transcribe Call Analytics.
```
{
"time": "string", // ISO8601 format
"service-type": "CallAnalytics",
"detail-type": "CallAnalyticsMetadata",
"callevent-type": "Update",
"metadata": "string" // JSON encoded string of the metadata object
}
// metadata object
{
"voiceConnectorId": "string",
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"direction": "string",
"oneTimeMetadata": "string" // JSON encoded string of oneTimeMetadata object
}
// onetimeMetadata object
{
"sipHeaders": "string", // JSON encoded string of SIP Invite headers key-value pair
"siprecMetadata": "string", // siprec metadata in XML
"siprecMetadataJson": "string" // siprec metadata in JSON (converted from above XML)
}
// sipHeaders object
{
"string": "string"
}
```
Contoh berikut menunjukkan format metadata pembaruan untuk Call Analytics Amazon S3 Recording.
```
{
"time": "string", // ISO8601 format
"service-type": "CallAnalytics",
"detail-type": "Recording",
"callevent-type": "Update",
"metadata": "string" // JSON encoded string of the metadata object
}
// metadata object
{
"voiceConnectorId": "string",
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"direction": "string",
"oneTimeMetadata": "string" // JSON encoded in string of oneTimeMetadata object
}
// onetimeMetadata object
{
"sipHeaders": "string", // JSON encoded string of SIP Invite headers key-value pair
"siprecMetadata": "string", // siprec metadata in XML
"siprecMetadataJson": "string" // siprec metadata in JSON (converted from above XML)
}
// sipHeaders object
{
"string": "string"
}
```
## Metadata perekaman panggilan SIP
Contoh berikut menunjukkan metadata untuk merekam panggilan SIP antara dua orang, Alice dan Bob. Kedua peserta mengirim dan menerima audio dan video. Untuk kesederhanaan, contoh hanya memiliki cuplikan SIP dan SDP, dan SRC merekam aliran setiap peserta ke SRS tanpa pencampuran.
```
INVITE sip:recorder@example.com SIP/2.0
Via: SIP/2.0/TCP src.example.com;branch=z9hG4bKdf6b622b648d9
From: ;tag=35e195d2-947d-4585-946f-09839247
To:
Call-ID: d253c800-b0d1ea39-4a7dd-3f0e20a
Session-ID: ab30317f1a784dc48ff824d0d3715d86
;remote=00000000000000000000000000000000
CSeq: 101 INVITE
Max-Forwards: 70
Require: siprec
Accept: application/sdp, application/rs-metadata,
application/rs-metadata-request
Contact: ;+sip.src
Content-Type: multipart/mixed;boundary=boundary
Content-Length: [length]
Content-Type: application/SDP
...
m=audio 49170 RTP/AVP 0
a=rtpmap:0 PCMU/8000
a=label:96
a=sendonly
...
m=video 49174 RTP/AVPF 96
a=rtpmap:96 H.264/90000
a=label:97
a=sendonly
...
m=audio 51372 RTP/AVP 0
a=rtpmap:0 PCMU/8000
a=label:98
a=sendonly
...
m=video 49176 RTP/AVPF 96
a=rtpmap:96 H.264/90000
a=label:99
a=sendonly
....
Content-Type: application/rs-metadata
Content-Disposition: recording-session
complete2010-12-16T23:41:07Zsip:alice@atlanta.comstructure!structureab30317f1a784dc48ff824d0d3715d86;
remote=47755a9de7794ba387653f2099600ef27+OTCyoxTmqmqyA/1weDAg==
FOO!barAlice
FOO!barBobFOO!bar2010-12-16T23:41:07Z2010-12-16T23:41:07Z2010-12-16T23:41:07Zi1Pz3to5hGk8fuXl+PbwCw==UAAMm5GRQKSCMVvLyl4rFw==8zc6e0lYTlWIINA6GR+3ag==EiXGlc+4TruqqoDaNE76ag==8zc6e0lYTlWIINA6GR+3ag==EiXGlc+4TruqqoDaNE76ag==UAAMm5GRQKSCMVvLyl4rFw==i1Pz3to5hGk8fuXl+PbwCw==
```
Contoh berikut menunjukkan metadata yang diperbarui ketika satu peserta panggilan menunda yang lain. Dalam hal ini, `participant_id srfBElmCRp2QB23b7Mpk0w==` hanya menerima aliran media dan tidak mengirim media apa pun, sehingga elemen `send` XMLnya dihilangkan. Sebaliknya, `participant_id zSfPoSvdSDCmU3A3TRDxAw==` mengirim media ke, tetapi tidak menerima media dari, peserta lain, sehingga elemen `recv` XMLnya dihilangkan.
```
INVITE sip:recorder@example.com SIP/2.0
Via: SIP/2.0/TCP src.example.com;branch=z9hG4bKdf6b622b648d9
From: ;tag=35e195d2-947d-4585-946f-09839247
To:
Call-ID: d253c800-b0d1ea39-4a7dd-3f0e20a
Session-ID: ab30317f1a784dc48ff824d0d3715d86
;remote=f81d4fae7dec11d0a76500a0c91e6bf6
CSeq: 101 INVITE
Max-Forwards: 70
Require: siprec
Accept: application/sdp, application/rs-metadata,
application/rs-metadata-request
Contact: ;+sip.src
Content-Type: multipart/mixed;boundary=foobar
Content-Length: [length]
Content-Type: application/SDP
...
m=audio 49170 RTP/AVP 0
a=rtpmap:0 PCMU/8000
a=label:96
a=sendonly
...
m=video 49174 RTP/AVPF 96
a=rtpmap:96 H.264/90000
a=label:97
a=sendonly
...
m=audio 51372 RTP/AVP 0
a=rtpmap:0 PCMU/8000
a=label:98
a=sendonly
...
m=video 49176 RTP/AVPF 96
a=rtpmap:96 H.264/90000
a=label:99
a=sendonly
....
Content-Type: application/rs-metadata
Content-Disposition: recording-session
partial8zc6e0lYTlWIINA6GR+3ag==EiXGlc+4TruqqoDaNE76ag==8zc6e0lYTlWIINA6GR+3ag==EiXGlc+4TruqqoDaNE76ag==
```
Contoh berikut menunjukkan pembaruan metadata saat panggilan dilanjutkan. Payload sekarang memiliki elemen `send` dan `recv` XMLnya.
```
INVITE sip:recorder@example.com SIP/2.0
Via: SIP/2.0/TCP src.example.com;branch=z9hG4bKdf6b622b648d9
From: ;tag=35e195d2-947d-4585-946f-09839247
To:
Call-ID: d253c800-b0d1ea39-4a7dd-3f0e20a
Session-ID: ab30317f1a784dc48ff824d0d3715d86
;remote=f81d4fae7dec11d0a76500a0c91e6bf6
CSeq: 101 INVITE
Max-Forwards: 70
Require: siprec
Accept: application/sdp, application/rs-metadata,
application/rs-metadata-request
Contact: ;+sip.src
Content-Type: multipart/mixed;boundary=foobar
Content-Length: [length]
Content-Type: application/SDP
...
m=audio 49170 RTP/AVP 0
a=rtpmap:0 PCMU/8000
a=label:96
a=sendonly
...
m=video 49174 RTP/AVPF 96
a=rtpmap:96 H.264/90000
a=label:97
a=sendonly
...
m=audio 51372 RTP/AVP 0
a=rtpmap:0 PCMU/8000
a=label:98
a=sendonly
...
m=video 49176 RTP/AVPF 96
a=rtpmap:96 H.264/90000
a=label:99
a=sendonly
....
Content-Type: application/rs-metadata
Content-Disposition: recording-session
partiali1Pz3to5hGk8fuXl+PbwCw==UAAMm5GRQKSCMVvLyl4rFw==8zc6e0lYTlWIINA6GR+3ag==EiXGlc+4TruqqoDaNE76ag==8zc6e0lYTlWIINA6GR+3ag==EiXGlc+4TruqqoDaNE76ag==i1Pz3to5hGk8fuXl+PbwCw==UAAMm5GRQKSCMVvLyl4rFw==
```
## Tujuan prosesor Amazon Transcribe
Wastafel yang didukung:`KinesisDataStreamSink`.
Anda tidak dapat menggabungkan prosesor ini dengan analitik panggilan Amazon Transcribe. *Untuk informasi selengkapnya tentang input ke, dan output, Amazon Transcribe, lihat Transcribe [streaming audio di Panduan Pengembang](https://docs.aws.amazon.com/transcribe/latest/dg/streaming.html) Amazon Transcribe.*
Sesi analitik panggilan dengan Amazon Transcribe mengambil input data audio dari Kinesis Video Stream.
+ Didukung MediaEncoding: PCM menandatangani audio endian kecil 16-bit.
+ Tingkat MediaSampleRate sampel yang didukung: Antara 8.000 Hz dan 48.000 Hz.
`StreamConfiguration`masukan untuk prosesor Amazon Transcribe:
+ Anda harus menentukan `KinesisVideoStreamArn` untuk setiap aliran.
+ (Opsional) KVS `FragmentNumber` - Memulai pekerjaan analitik panggilan dengan potongan setelah fragmen tertentu. Jika tidak disediakan, itu akan menggunakan potongan terbaru yang tersedia di Kinesis Video Stream.
+ `StreamChannelDefinition`Amazon Transcribe saat ini mendukung audio dengan dua saluran. Anda harus menentukan `NumberOfChannels` di runtime`StreamChannelDefinition`. Selain itu, Anda harus lulus `ChannelId` jika Anda mengirim audio mono dalam dua saluran terpisah. Dalam transkrip Anda, saluran diberi label `ch_0` dan`ch_1`. Contoh berikut menunjukkan input KVS untuk satu aliran saluran audio mono.
```
"StreamChannelDefinition" : {"
NumberOfChannels" : 1
}
```
Contoh berikut menunjukkan input KVS untuk dua input audio mono dalam dua aliran yang berbeda.
```
KVS-1:
"StreamChannelDefinition" : {
"NumberOfChannels" : 1
"ChannelDefinitions": [
{
"ChannelId": 0
}
]
}
KVS-2:
"StreamChannelDefinition" : {
"NumberOfChannels" : 1
"ChannelDefinitions": [
{
"ChannelId": 1
}
]
}
```
**catatan**
Untuk Konektor Suara yang dibuat `MediaInsightsPipeline` dengan prosesor Amazon Transcribe, audio kaki akun Voice Connector ditetapkan `channel-0` dan audio kaki PSTN ke. `channel-1`
Untuk Konektor Suara SIPREC, kami mengandalkan metadata SIPREC. Dalam kebanyakan kasus, label aliran dengan nilai leksikografi terendah ditetapkan. `channel-0`
Untuk prosesor analitik panggilan Amazon Transcribe dan Amazon Transcribe, jika Anda meneruskan dua aliran Video Kinesis, dan setiap aliran berisi saluran audio mono, kami akan memasukkan kedua saluran ke satu aliran audio sebelum memproses data analitik panggilan Transcribe atau Transcribe.
## Keluaran Amazon Transcribe
Contoh berikut menunjukkan format keluaran metadata satu kali untuk Amazon Transcribe.
```
{
"time": "string", // ISO8601 format
"service-type": "CallAnalytics",
"detail-type": "CallAnalyticsMetadata",
"mediaInsightsPipelineId": "string",
"metadata": "string" // JSON encoded string of the metadata object
}
// metadata object
{
"voiceConnectorId": "string",
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"direction": "string",
"oneTimeMetadata": "string" // JSON encoded string of oneTimeMetadata object
}
// onetimeMetadata object
{
"inviteHeaders": "string", // JSON encoded string of SIP Invite headers key-value pair
"siprecMetadata": "string", // siprec metadata in XML
"siprecMetadataJson": "string" // siprec metadata in JSON (converted from above XML)
}
// inviteHeaders object
{
"string": "string"
}
```
Contoh berikut menunjukkan format output Amazon Transcribe.
```
{
"time": "string", // ISO8601 format
"service-type": "CallAnalytics",
"detail-type": "Transcribe",
"mediaInsightsPipelineId": "string",
"metadata": {
"voiceconnectorId": "string",
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"direction": "string"
}
"TranscriptEvent": {
"Transcript": {
"Results": [{
"Alternatives": [{
"Entities": [{
"Category": "string",
"Confidence": number,
"Content": "string",
"EndTime": number,
"StartTime": number,
"Type": "string"
}],
"Items": [{
"Confidence": number,
"Content": "string",
"EndTime": number,
"Speaker": "string",
"Stable": boolean,
"StartTime": number,
"Type": "string",
"VocabularyFilterMatch": boolean
}],
"Transcript": "string"
}],
"ChannelId": "string",
"EndTime": number,
"IsPartial": boolean,
"LanguageCode": "string",
"LanguageIdentification": [{
"LanguageCode": "string",
"Score": number
}],
"ResultId": "string",
"StartTime": number
}]
}
}
}
```
## Tujuan prosesor analitik suara
Wastafel yang didukung:`KinesisDataStreamSink`,`SqsQueueSink`,`SnsTopicSink`, dan`LambdaFunctionSink`.
Anda dapat menggabungkan prosesor ini dengan prosesor analitik panggilan Amazon Transcribe, prosesor Amazon Transcribe, atau perekaman panggilan. Anda harus menggunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs untuk memanggil prosesor analitik suara. Untuk informasi selengkapnya tentang penggunaan analitik suara, lihat [Menggunakan analitik suara Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/dg/voice-analytics.html).
## Menggunakan Kinesis Data Stream sebagai wastafel
Catatan Kinesis Data Stream (KDS) yang dihasilkan oleh analitik panggilan mencakup ID pipa media, tipe detail, metadata, dan bagian khusus prosesor. *Untuk informasi tentang konsumsi data dari Aliran Data Kinesis, lihat [Membaca Data dari Amazon Kinesis Data Streams, dalam panduan](https://docs.aws.amazon.com/streams/latest/dev/building-consumers.html) Pengembang Amazon Kinesis Streams.* Untuk membuat konfigurasi dengan wastafel ini, Anda harus memiliki `kinesis:DescribeStream` izin pada aliran yang ditentukan.
**Metadata**
`metadata`Bagian dari catatan KDS yang dihasilkan berisi setiap pasangan nilai kunci yang ditentukan `CallAnalyticsRuntimeMetadata` selama panggilan API. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) Jika sesi analitik panggilan dimulai oleh Konektor Suara, bagian metadata secara otomatis diisi dengan parameter berikut:
+ `transactionId`
+ `fromNumber`
+ `toNumber`
+ `callId`
+ `voiceConnectorId`
+ `direction`
Selain parameter yang ditunjukkan di atas, bagian metadata untuk sesi analitik panggilan yang dimulai Konektor Suara akan diisi dengan bidang yang `oneTimeMetadata` berisi:
+ `inviteHeaders`
+ `siprecMetadata`
Ini dipublikasikan ke Kinesis Data Streams hanya sekali di awal sesi dan `detail-type` memiliki a. `CallAnalyticsMetadata`
Anda dapat meneruskan pengenal unik di `MediaInsightsRuntimeMetadata` setiap panggilan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API sehingga Anda dapat secara unik mengidentifikasi sumber setiap rekaman yang dikirimkan ke Aliran Data Kinesis Anda.
## Rekaman panggilan Amazon S3
Rekaman analitik panggilan membaca audio dari aliran KVS, merekamnya sebagai file audio, dan mengunggah file ke Bucket Amazon S3 yang ditentukan. Setelah merekam analitik panggilan juga mengirimkan metadata panggilan bersama dengan lokasi file ke KDS. Jika Anda mengaktifkan gudang data, metadata panggilan (termasuk metadata SIPREC jika SIPREC digunakan) dikirim ke gudang data dalam satu set tabel Parket yang dapat Anda kueri.
Seperti prosesor analitik panggilan lainnya, Anda harus terlebih dahulu membuat konfigurasi untuk pipeline. Anda dapat menggunakan Amazon Chime SDK Console atau CLI untuk membuat konfigurasi. Anda kemudian menggunakan CLI untuk membuat pipeline. Untuk informasi lebih lanjut tentang menggunakan konsol untuk membuat konfigurasi perekaman, lihat[Membuat konfigurasi analitik panggilan untuk Amazon Chime SDK](creating-ca-configuration.md), sebelumnya di bagian ini. Untuk informasi selengkapnya tentang penggunaan alur kerja perekaman, lihat[Memahami alur kerja untuk merekam panggilan untuk Amazon Chime SDK](recording-workflows.md), sebelumnya di bagian ini.
**Untuk menggunakan CLI untuk membuat konfigurasi**
Jalankan perintah berikut:
```
aws chime-sdk-media-pipeline create-media-insights-pipeline-configuration --cli-input-json file://configuration.json
```
Contoh berikut menunjukkan file JSON konfigurasi dengan hanya perekaman diaktifkan:
```
{
"MediaInsightsPipelineConfigurationName": configuration_name,
"ResourceAccessRoleArn": role_arn,
"Elements": [
{
"KinesisDataStreamSinkConfiguration": {
"InsightsTarget": KDS_arn //Where recording live metadata will be delivered.
},
"Type": "KinesisDataStreamSink"
},
{
"S3RecordingSinkConfiguration": {
"Destination": "arn:aws:s3:::kvs-recording-testing",
"RecordingFileFormat": file_format // Specify "Opus" or "WAV" as the recording file format.
},
"Type": "S3RecordingSink"
}
]
}
```
Ingat hal berikut:
+ Untuk mengaktifkan perekaman panggilan melalui Kinesis Video Streams, audio harus ditandatangani PCM 16-bit little-endian. Tingkat sampel harus 8KHz.
+ Builder harus menetapkan periode retensi data yang cukup lama untuk Kinesis Video Stream untuk memastikan fragmen dipertahankan dan dikonsumsi oleh analitik panggilan.
+ Jika Anda mengaktifkan perekaman panggilan, baik dengan sendirinya atau dalam kombinasi dengan prosesor lain, Anda harus menyediakan dua Kinesis Video Stream ARNs untuk merekam. Rekaman panggilan tidak mendukung input audio stereo tunggal.
## Output metadata perekaman panggilan Amazon S3
Contoh berikut menunjukkan format keluaran metadata untuk analisis panggilan perekaman Amazon S3.
```
{
"time": "string", // ISO8601 format
"service-type": "CallAnalytics",
"detail-type": "Recording",
"mediaInsightsPipelineId": "string",
"s3MediaObjectConsoleUrl": "string",
"recordingDurationSeconds": "number",
"metadata": "string" // JSON encoded string of the metadata object
}
// metadata object
{
"voiceConnectorId": "string",
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"direction": "string",
"startTime": "string", // ISO8601 format
"endTime": "string", // ISO8601 format
"oneTimeMetadata": "string" // JSON encoded in string of oneTimeMetadata object
}
// onetimeMetadata object
{
"sipHeaders": "string", // JSON encoded string of SIP Invite headers key-value pair
"siprecMetadata": "string", // siprec metadata in XML
"siprecMetadataJson": "string" // siprec metadata in JSON (converted from above XML)
}
// sipHeaders object
{
"string": "string"
}
```
## Aktifkan peningkatan suara
Untuk mengaktifkan peningkatan suara, sertakan `VoiceEnhancementSinkConfiguration` elemen dalam panggilan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API.
Contoh ini menunjukkan elemen khas.
```
{
"Type":"VoiceEnhancementSink",
"VoiceEnhancementSinkConfiguration": {
"Disabled": Boolean (string) // FALSE ==> Voice Enhancement will be performed
}
```
Untuk memperbarui konfigurasi, tambahkan `VoiceEnhancementSinkConfiguration` elemen ke panggilan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineConfiguration.html)API. Ketika Anda melakukannya, [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetMediaInsightsPipelineConfiguration.html)API menyertakan `VoiceEnhancementSinkConfiguration` elemen dalam hasil.
Permintaan contoh ini menunjukkan cara mengaktifkan Peningkatan Suara dan perekaman Amazon S3.
```
POST /media-insights-pipeline-configurations HTTP/1.1
Content-type: application/json
{
"MediaInsightsPipelineConfigurationName":"media_insights_configuration_name",
"ResourceAccessRoleArn":"arn:aws:iam::account_id:role/resource_access_role",
"Elements":[
{
"Type":"S3RecordingSink",
"S3RecordingSinkConfiguration":{
"Destination":"arn:aws:s3:::input_bucket_path",
"RecordingFileFormat":"Wav"
}
},
{
"Type":"VoiceEnhancementSink",
"VoiceEnhancementSinkConfiguration": {
"disabled":"false"
}
}
],
"ClientRequestToken":"client_request_token"
}
```
**catatan**
`VoiceEnhancementSink`Elemen selalu membutuhkan `S3RecordingSink` elemen dalam konfigurasi analitik panggilan.
# Menggabungkan transkripsi dengan sink perekaman untuk Amazon Chime SDK
Anda dapat menggabungkan prosesor Amazon Transcribe dan Amazon Transcribe Call Analytics dengan wastafel perekaman Amazon S3. Builder dapat meneruskan S3 RecordingSinkConfiguration selain prosesor Amazon Transcribe dalam [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)panggilan API, atau dengan menggunakan konsol.
Dalam hubungannya dengan wastafel perekaman Amazon S3, Anda dapat menggunakan Amazon Transcribe atau prosesor Amazon Transcribe Call Analytics, tetapi tidak pernah keduanya. Anda juga dapat menambahkan analitik suara ke konfigurasi yang sama selain wastafel rekaman, dengan atau tanpa prosesor transkripsi.
**catatan**
Anda dapat mengaktifkan perekaman dengan salah satu prosesor yang tercantum di atas. Namun, jika Anda mengaktifkan Amazon Transcribe Call Analytics bersama dengan perekaman panggilan Amazon S3, Anda harus menyediakan dua aliran video Kinesis, dan Anda akan menerima file rekaman duplikat, satu dari Amazon Transcribe Call Analytics dan satu dari rekaman panggilan Amazon S3.
Ingat hal berikut:
+ Anda harus menggunakan yang unik`MediaInsightsPipelineConfigurationName`.
+ Untuk informasi tentang`ResourceAccessRoleArn`, lihat [Menggunakan peran akses sumber daya analitik panggilan untuk Amazon Chime SDK](call-analytics-resource-access-role.md) dalam panduan ini.
+ `Destination`Nilai harus berupa jalur S3 ARN. Bucket Amazon S3 harus dimiliki oleh akun yang sama.
+ Jika Anda menggunakan konfigurasi dengan Transcribe dan perekaman untuk membuat pipeline, jeda dan resume hanya muncul di wawasan yang dihasilkan oleh aliran Data Kinesis. Semua data dalam aliran KVS direkam dan diunggah ke Amazon S3.
+ Jika konfigurasi menggunakan Amazon transcribe atau transcribe call analytics (TCA) selain perekaman, pipeline media insights menyediakan insight transkripsi atau Transcribe Call Analytics secara real time, diikuti oleh perekaman Amazon S3 di akhir panggilan. Jika layanan transkripsi gagal selama analitik panggilan, pekerjaan perekaman S3 masih mencoba dijalankan. Sebaliknya, kegagalan perekaman Amazon S3 tidak memengaruhi wawasan transkripsi, karena berjalan setelah transkripsi selesai.
Contoh ini menunjukkan konfigurasi dengan prosesor Amazon Transcribe dan wastafel perekaman Amazon S3. Contoh ini juga memungkinkan stabilisasi hasil sebagian, yang dapat mengurangi latensi dalam output, tetapi dapat memengaruhi akurasi. Untuk informasi selengkapnya, lihat [Stabilisasi hasil sebagian](https://docs.aws.amazon.com/transcribe/latest/dg/streaming-partial-results.html#streaming-partial-result-stabilization), di Panduan Pengembang *Amazon* Transcribe.
```
{
"MediaInsightsPipelineConfigurationName": unique_configuration_name,
"ResourceAccessRoleArn": role_arn,
"Elements": [{
"AmazonTranscribeProcessorConfiguration": {
"ContentIdentificationType": "string",
"ContentRedactionType": "string",
"EnablePartialResultsStabilization": boolean, //Enables partial result stabilization. Can reduce latency. May impact accuracy.
"FilterPartialResults": boolean, //To control partial utterance events
"LanguageCode": "string",
"LanguageModelName": "string",
"PartialResultsStability": "string",
"PiiEntityTypes": "string",
"ShowSpeakerLabel": boolean,
"VocabularyFilterMethod": "string",
"VocabularyFilterName": "string",
"VocabularyName": "string"
},
"Type": "AmazonTranscribeProcessor"
},
{
"KinesisDataStreamSinkConfiguration": {
"InsightsTarget": KDS_arn //Where recording and insights live metadata will be delivered.
},
"Type": "KinesisDataStreamSink"
},
{
"S3RecordingSinkConfiguration": {
"Destination": S3_Arn,
"RecordingFileFormat": file_format // Specify "Opus" or "WAV" as the recording file format.
},
"Type": "S3RecordingSink"
}
]
}
```
# Menggunakan EventBridge notifikasi Amazon untuk Amazon Chime SDK
Amazon Chime SDK Call Analytics mendukung pengiriman peristiwa ke EventBridge bus default saat status pipeline wawasan media berubah, atau saat kondisi peringatan real-time analitik panggilan terpenuhi. Untuk pembaruan status kesalahan saluran wawasan media, sebaiknya Anda mengonfigurasi EventBridge target untuk memberi tahu Anda jika sumber daya Anda gagal secara asinkron. Notifikasi analitik panggilan memiliki sumber aws.chime dan berbagai jenis detail, yang dibagikan di bagian berikut. Untuk informasi selengkapnya, lihat [Panduan EventBridge Pengguna Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html).
**Topics**
+ [Pembaruan status](#status-updates)
+ [Peringatan waktu nyata](#realtime-alerts)
## Pembaruan status
Pipeline wawasan media mengirim EventBridge pemberitahuan saat sesi analitik panggilan berlangsung dan berakhir dengan sukses atau menemukan kesalahan. Anda menerima EventBridge pemberitahuan dengan jenis detail “Perubahan Status Wawasan Media” saat:
+ Status saluran wawasan media berubah.
+ Status elemen pipeline wawasan media berubah.
+ Setiap elemen pipa dihentikan.
+ Setiap elemen pipa gagal.
Bagian detail selalu mencakup bidang-bidang berikut:
+ `version`
+ `mediaInsightsPipelineArn`
+ `eventType`
Bagian detail juga mencakup `mediaInsightsPipelineElementStatuses` bidang jika pipeline wawasan media berisi beberapa elemen, seperti prosesor analitik dan sink data. Bidang ini menunjukkan status setiap elemen dalam pipa. Status yang mungkin untuk setiap elemen pipa dapat berupa:
+ `NotStarted`
+ `InProgress`
+ `Stopped`
+ `Failed`
Bagian detail juga mencakup pasangan nilai kunci yang ditentukan `MediaInsightsRuntimeMetadata` selama panggilan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API. Jika sesi analitik panggilan dimulai oleh Konektor Suara, bagian metadata diisi dengan parameter berikut secara otomatis:
+ `transactionId`
+ `fromNumber`
+ `toNumber`
+ `callId`
+ `voiceConnectorId`
+ `direction`
Jenis peristiwa berikut mungkin muncul setiap kali pipeline wawasan media berisi satu elemen. Perluas setiap bagian untuk mempelajari lebih lanjut.
### Wawasan media Amazon Chime SDK sedang berlangsung
Contoh ini menunjukkan struktur acara yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"region": "string",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": []
"detail": {
"version": "0",
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsInProgress",
"version": "0",
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"voiceConnectorId": "string",
"direction": "string"
}
}
```
### Wawasan media Amazon Chime SDK dijeda
Contoh ini menunjukkan struktur acara yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"region": "string",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": []
"detail": {
"version": "0",
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsPaused",
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"voiceConnectorId": "string",
"direction": "string"
}
}
```
### Wawasan media Amazon Chime SDK dihentikan
Contoh ini menunjukkan struktur acara yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"region": "string",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": []
"detail": {
"version": "0",
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsStopped",
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"voiceConnectorId": "string",
"direction": "string"
}
}
```
### Media Amazon Chime SDK mengetahui kegagalan sementara
Menunjukkan bahwa layanan mengalami kegagalan sementara dan akan mencoba lagi. Tidak ada tindakan yang diperlukan dari Anda.
Contoh ini menunjukkan struktur acara yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"region": "string",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": []
"detail": {
"version": "0",
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsTemporaryFailure",
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"voiceConnectorId": "string",
"direction": "string"
}
}
```
### Amazon Chime SDK media wawasan kegagalan permanen
Menunjukkan kegagalan yang membutuhkan tindakan dari Anda. Gunakan `failureReason` untuk memecahkan masalah. Kegagalan umum dapat mencakup yang berikut:
+ Izin tidak memadai pada peran akses sumber daya
+ Sumber daya yang hilang atau dihapus
+ Pelambatan dari AWS layanan yang memanggil panggilan analitik atas nama Anda, seperti Amazon Transcribe atau Amazon Kinesis.
+ Format media yang tidak kompatibel pada aliran KVS
Contoh ini menunjukkan struktur acara yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"region": "string",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": []
"detail": {
"version": "0",
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsPermanentFailure",
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"voiceConnectorId": "string",
"direction": "string",
"failureReason": "string"
}
}
```
**catatan**
`failureReason`Bidang ini opsional. Misalnya, alasan tipikal bisa jadi`Access denied when assuming resource access role`.
Jenis peristiwa berikut mungkin muncul setiap kali pipeline wawasan media dibuat, atau upaya pembuatan gagal, untuk sesi analitik panggilan yang dimulai oleh Konektor Suara Amazon Chime SDK. Perluas setiap bagian untuk mempelajari lebih lanjut.
### Wawasan media Amazon Chime SDK dibuat
Contoh ini menunjukkan acara sukses yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"region": "string",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": []
"detail":
{
"version": "0",
"mediaInsightsPipelineConfigurationArn": "string",
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsCreated",
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"voiceConnectorId": "string",
"direction": "string",
}
}
```
### Pembuatan wawasan media Amazon Chime SDK gagal
Contoh ini menunjukkan peristiwa kegagalan yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"region": "string",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": []
"detail":
{
"version": "0",
"mediaInsightsPipelineConfigurationArn": "string",
"eventType": "chime:MediaInsightsCreateFailed",
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"voiceConnectorId": "string",
"direction": "string",
"failureOrigin": "Voice Connector",
"httpStatusCode": "string",
"failureReason": "string"
}
}
```
Jenis peristiwa berikut mungkin muncul ketika pipeline wawasan media berisi beberapa elemen. Contoh notifikasi untuk `AmazonTranscribeProcessor` digabungkan dengan`S3RecordingSink`. Perluas setiap bagian untuk mempelajari lebih lanjut.
### AmazonTranscribeProcessor sedang berlangsung dan S3 RecordingSink belum dimulai
Contoh ini menunjukkan struktur acara yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"region": "string",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": [],
"detail": {
"version": "0",
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsInProgress",
"mediaInsightsPipelineElementStatuses": [
{
"type": "AmazonTranscribeProcessor",
"status": "InProgress",
"updatedOn": 1686184070655
},
{
"type": "S3RecordingSink",
"status": "NotStarted",
"updatedOn": 1686184070655
}
]
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"voiceConnectorId": "string",
"direction": "string"
}
}
```
### AmazonTranscribeProcessor telah berhasil dan S3 RecordingSink sedang berlangsung
Contoh ini menunjukkan struktur acara yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"region": "string",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": [],
"detail": {
"version": "0",
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsInProgress",
"mediaInsightsPipelineElementStatuses": [
{
"type": "AmazonTranscribeProcessor",
"status": "Stopped",
"updatedOn": 1686184070655
},
{
"type": "S3RecordingSink",
"status": "InProgress",
"updatedOn": 1686184070655
}
]
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"voiceConnectorId": "string",
"direction": "string"
}
}
```
### AmazonTranscribeProcessor telah gagal dan S3 RecordingSink sedang berlangsung
Contoh ini menunjukkan struktur acara yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"region": "string",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": [],
"detail": {
"version": "0",
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsInProgress",
"mediaInsightsPipelineElementStatuses": [
{
"type": "AmazonTranscribeProcessor",
"status": "Failed",
"updatedOn": 1686184070655
},
{
"type": "S3RecordingSink",
"status": "InProgress",
"updatedOn": 1686184070655
}
]
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"voiceConnectorId": "string",
"direction": "string"
}
}
```
### AmazonTranscribeProcessor telah gagal dan S3 RecordingSink telah berhasil
Contoh ini menunjukkan struktur acara yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"region": "string",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": [],
"detail": {
"version": "0",
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsPermanentFailure",
"mediaInsightsPipelineElementStatuses": [
{
"type": "AmazonTranscribeProcessor",
"status": "Failed",
"updatedOn": 1686184070655
},
{
"type": "S3RecordingSink",
"status": "Stopped",
"updatedOn": 1686184070655
}
]
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"voiceConnectorId": "string",
"direction": "string",
"failureReason": "string"
}
}
```
### AmazonTranscribeProcessor telah berhasil dan S3 RecordingSink telah gagal
Contoh ini menunjukkan struktur acara yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"region": "string",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": [],
"detail": {
"version": "0",
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsPermanentFailure",
"mediaInsightsPipelineElementStatuses": [
{
"type": "AmazonTranscribeProcessor",
"status": "Stopped",
"updatedOn": 1686184070655
},
{
"type": "S3RecordingSink",
"status": "Failed",
"updatedOn": 1686184070655
}
]
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"voiceConnectorId": "string",
"direction": "string",
"failureReason": "string"
}
}
```
### AmazonTranscribeProcessor dijeda dan S3 belum dimulai RecordingSink
Contoh ini menunjukkan struktur acara yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"region": "string",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": [],
"detail": {
"version": "0",
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsPaused",
"mediaInsightsPipelineElementStatuses": [
{
"type": "AmazonTranscribeProcessor",
"status": "Paused",
"updatedOn": 1686184070655
},
{
"type": "S3RecordingSink",
"status": "NotStarted",
"updatedOn": 1686184070655
}
]
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"voiceConnectorId": "string",
"direction": "string"
}
}
```
### AmazonTranscribeProcessor gagal sementara dan S3 RecordingSink belum dimulai
Contoh ini menunjukkan struktur acara yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"region": "string",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": [],
"detail": {
"version": "0",
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsTemporaryFailure",
"mediaInsightsPipelineElementStatuses": [
{
"type": "AmazonTranscribeProcessor",
"status": "TemporarilyFailed",
"updatedOn": 1686184070655
},
{
"type": "S3RecordingSink",
"status": "NotStarted",
"updatedOn": 1686184070655
}
]
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"voiceConnectorId": "string",
"direction": "string"
}
}
```
### AmazonTranscribeProcessor dan S3 berhasil RecordingSink
Contoh ini menunjukkan struktur acara yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"region": "string",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": [],
"detail": {
"version": "0",
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsStopped",
"mediaInsightsPipelineElementStatuses": [
{
"type": "AmazonTranscribeProcessor",
"status": "Stopped",
"updatedOn": 1686184070655
},
{
"type": "S3RecordingSink",
"status": "Stopped",
"updatedOn": 1686184070655
}
]
"callId": "string",
"transactionId": "string",
"fromNumber": "string",
"toNumber": "string",
"voiceConnectorId": "string",
"direction": "string"
}
}
```
### S3 RecordingSink berhasil dan dalam proses VoiceEnhancement
Contoh ini menunjukkan struktur acara yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "string",
"detail": {
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsInProgress",
"version": "0",
"mediaInsightsPipelineElementStatuses": [
{
"type": "VoiceEnhancementSink",
"status": "InProgress",
"updatedOn": 1686184070655
},
{
"type": "S3RecordingSink",
"status": "Stopped",
"updatedOn": 1686184070655
}
]
}
}
```
### S3 RecordingSink berhasil dan VoiceEnhancement gagal karena panggilan lebih dari 30 menit
Contoh ini menunjukkan struktur acara yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "string",
"detail": {
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsStopped",
"version": "0",
"mediaInsightsPipelineElementStatuses": [
{
"type": "VoiceEnhancement",
"status": "NotSupported",
"updatedOn": 1686184070655,
"statusDetail": "Unsupported recording length"
},
{
"type": "S3RecordingSink",
"status": "Stopped",
"updatedOn": 1686184070655
}
]
}
}
```
### S3 RecordingSink berhasil dan VoiceEnhancement gagal karena panggilan kurang dari 30 menit
Contoh ini menunjukkan struktur acara yang khas.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights State Change",
"source": "aws.chime",
"account": number,
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "string",
"detail": {
"mediaInsightsPipelineArn": "string",
"eventType": "chime:MediaInsightsPermanentFailure",
"version": "0",
"mediaInsightsPipelineElementStatuses": [
{
"type": "VoiceEnhancement",
"status": "Failed",
"updatedOn": 1686184070655
},
{
"type": "S3RecordingSink",
"status": "Stopped",
"updatedOn": 1686184070655
}
]
}
}
```
## Peringatan waktu nyata
**catatan**
Hanya prosesor Amazon Transcribe dan Amazon Transcribe Call Analytics yang mendukung peringatan waktu nyata.
Amazon Chime SDK Call Analytics memungkinkan pengembang untuk mengatur aturan untuk mengirim peringatan real-time melalui prosesor selama sesi analitik. Peringatan dikirim ke Amazon EventBridge dengan jenis `Media Insights Rules Matched` detail. EventBridge mendukung integrasi dengan layanan hilir seperti Lambda, Amazon SQS, dan Amazon SNS untuk memicu pemberitahuan bagi pengguna akhir atau memulai logika bisnis khusus lainnya.
Peringatan waktu nyata diatur sebagai bagian dari `RealTimeAlertConfiguration` bidang untuk. `MediaInsightsPipelineConfiguration` Anda dapat menggunakan konsol Amazon Chime SDK untuk mengonfigurasi bidang, atau Anda dapat memanggil atau. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) APIs
Contoh ini menunjukkan cara membuat atau memperbarui konfigurasi peringatan waktu nyata melalui API.
```
{
"MediaInsightsPipelineConfigurationName": "config_name",
"ResourceAccessRoleArn": "arn:aws:iam::account_id:role/role_name",
"RealTimeAlertConfiguration": {
"Disabled": false,
"Rules": [{
"Type": "KeywordMatch",
"KeywordMatchConfiguration": {
"RuleName": "rule_name_1",
"Keywords": [
"hello",
"thank you"
],
"Negate": false
}
},
{
"Type": "Sentiment",
"RuleName": "rule_name_2",
"SentimentType": "NEGATIVE",
"TimePeriod": 60
},
{
"Type": "IssueDetection",
"RuleName": "rule_name_3"
}
]
},
"Elements": [{
"Type": "AmazonTranscribeCallAnalyticsProcessor",
"AmazonTranscribeCallAnalyticsProcessorConfiguration": {
"LanguageCode": "en-US"
}
},
{
"Type": "KinesisDataStreamSink",
"KinesisDataStreamSinkConfiguration": {
"InsightsTarget": "arn:aws:kinesis:us-east-1:account_id:stream/stream_name"
}
}
]
}
```
Setiap aturan dalam konfigurasi peringatan waktu nyata dipicu secara independen. Anda dapat menerima beberapa EventBridge pemberitahuan jika beberapa ketentuan aturan terpenuhi pada saat yang bersamaan. Untuk membuat daftar aturan untuk peringatan Anda, Anda dapat memilih di antara jenis aturan berikut:
Pencocokan Kata Kunci
Peringatan ketika sekumpulan kata kunci atau frasa tertentu dicocokkan dalam peristiwa ucapan atau transkrip. Anda dapat mengonfigurasi peringatan untuk memancarkan peristiwa jika:
+ Setiap kata kunci yang ditentukan diucapkan, dan `Negate` diatur ke`false`.
+ Semua kata kunci yang ditentukan tidak diucapkan untuk keseluruhan panggilan, jika `Negate` diatur ke. `true`
Amazon Transcribe dan Amazon Transcribe Analytics mendukung jenis aturan ini.
Analisis Sentimen
Peringatan ketika jenis sentimen tertentu sedang berlangsung untuk periode jendela bergulir. Hanya Transcribe Call Analytics yang mendukung aturan ini.
Deteksi Masalah
Peringatan saat masalah terdeteksi dalam acara ucapan. Hanya Transcribe Call Analytics yang mendukung jenis aturan ini.
Contoh berikut menunjukkan peristiwa peringatan real-time untuk `KeywordMatch` aturan.
```
{
"version": "0",
"id": "string",
"detail-type": "Media Insights Rules Matched",
"source": "aws.chime",
"account": number,
"region": "us-east-1",
"time": "yyyy-mm-ddThh:mm:ssZ",
"resources": [],
"detail": {
"version": "0",
"sourceMetadata": {}
"ruleName": "string"
"utteranceId": "string",
"beginTimestamp": "yyyy-mm-ddThh:mm:ssZ",
}
}
```
Beberapa EventBridge bidang khusus untuk jenis aturan yang cocok:
**Bidang pencocokan kata kunci**
`utteranceId`: ID transkrip yang berisi kata kunci yang cocok jika Anda menggunakan Amazon Transcribe Call Analytics. Hanya untuk kata kunci yang diucapkan cocok.
`resultId`: ID transkrip yang berisi kata kunci yang cocok jika Anda menggunakan Amazon Transcribe. Hanya untuk kata kunci yang diucapkan cocok.
`beginTimestamp`: Waktu mulai transkrip yang berisi kata kunci yang cocok. Hanya untuk kata kunci yang diucapkan cocok.
**Bidang analisis sentimen**
`beginTimestamp`: Waktu mulai jendela bergulir untuk sentimen yang cocok.
`endTimestamp`: Waktu akhir jendela bergulir untuk sentimen yang cocok.
# Membuat danau data Amazon Chime SDK
Danau data analitik panggilan Amazon Chime SDK memungkinkan Anda mengalirkan wawasan yang didukung pembelajaran mesin dan metadata apa pun dari Amazon Kinesis Data Stream ke bucket Amazon S3 Anda. Misalnya, menggunakan data lake URLs untuk mengakses rekaman. Untuk membuat data lake, Anda menerapkan satu set AWS CloudFormation template baik dari konsol Amazon Chime SDK atau secara terprogram menggunakan. AWS CLI Data lake memungkinkan Anda untuk menanyakan metadata panggilan dan data analitik suara Anda dengan AWS mereferensikan tabel data Glue di Amazon Athena.
**Topics**
+ [Prasyarat](#data-lake-prereqs)
+ [Terminologi dan konsep data lake](#data-lake-terms)
+ [Membuat beberapa danau data](#creating-multiple-data-lakes)
+ [Data ketersediaan regional danau](#data-lake-regions)
+ [Arsitektur danau data](#data-lake-architecture)
+ [Pengaturan danau data](#data-lake-setup)
## Prasyarat
Anda harus memiliki item berikut untuk membuat danau Amazon Chime SDK:
+ Aliran data Amazon Kinesis. Untuk informasi selengkapnya, lihat [Membuat Stream melalui AWS Management Console](https://docs.aws.amazon.com/streams/latest/dev/how-do-i-create-a-stream.html) di Panduan Pengembang *Amazon Kinesis Streams*.
+ Ember S3. Untuk informasi selengkapnya, lihat [Membuat bucket Amazon S3 pertama Anda di Panduan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html) Pengguna *Amazon S3*.
## Terminologi dan konsep data lake
Gunakan istilah dan konsep berikut untuk memahami cara kerja data lake.
**Amazon Kinesis Data Firehose**
Layanan ekstrak, transformasi, dan muat (ETL) yang andal menangkap, mengubah, dan mengirimkan data streaming ke data lake, penyimpanan data, dan layanan analitik. Untuk informasi selengkapnya, lihat Apa Itu Amazon Kinesis Data Firehose?
**Amazon Athena**
Amazon Athena adalah layanan kueri interaktif yang memungkinkan Anda menganalisis data di Amazon S3 menggunakan SQL standar. Athena tanpa server, jadi Anda tidak memiliki infrastruktur untuk dikelola, dan Anda hanya membayar untuk kueri yang Anda jalankan. Untuk menggunakan Athena, arahkan ke data Anda di Amazon S3, tentukan skema, dan gunakan kueri SQL standar. Anda juga dapat menggunakan grup kerja untuk mengelompokkan pengguna dan mengontrol sumber daya yang dapat mereka akses saat menjalankan kueri. Workgroup memungkinkan Anda mengelola konkurensi kueri dan memprioritaskan eksekusi kueri di berbagai grup pengguna dan beban kerja.
**Katalog Data Glue**
Di Amazon Athena, tabel dan database berisi metadata yang merinci skema untuk data sumber yang mendasarinya. Untuk setiap dataset, tabel harus ada di Athena. Metadata dalam tabel memberi tahu Athena lokasi bucket Amazon S3 Anda. Ini juga menentukan struktur data, seperti nama kolom, tipe data, dan nama tabel. Database hanya menyimpan informasi metadata dan skema untuk kumpulan data.
## Membuat beberapa danau data
Beberapa data lake dapat dibuat dengan menyediakan nama database Glue yang unik untuk menentukan tempat menyimpan wawasan panggilan. Untuk AWS akun tertentu, mungkin ada beberapa konfigurasi analitik panggilan, masing-masing dengan data lake yang sesuai. Ini berarti bahwa pemisahan data dapat diterapkan untuk kasus penggunaan tertentu, seperti menyesuaikan kebijakan retensi, dan kebijakan akses tentang bagaimana data disimpan. Mungkin ada kebijakan keamanan berbeda yang diterapkan untuk akses wawasan, rekaman, dan metadata.
## Data ketersediaan regional danau
Danau data Amazon Chime SDK tersedia di Wilayah berikut.
| Region | Glue meja | Quick |
| --- | --- | --- |
| us-east-1 | Tersedia | Tersedia |
| us-west-2 | Tersedia | Tersedia |
| eu-central-1 | Tersedia | Tersedia |
## Arsitektur danau data
Diagram berikut menunjukkan arsitektur danau data. Angka dalam gambar sesuai dengan teks bernomor di bawah ini.
![\[Program mengalir melalui danau data.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/call-analytics-data-lake-architecture.png)
Dalam diagram, setelah Anda menggunakan AWS konsol untuk menerapkan CloudFormation template dari alur kerja penyiapan konfigurasi pipeline media insights, data berikut akan mengalir ke bucket Amazon S3:
1. Analisis panggilan Amazon Chime SDK akan mulai mengalirkan data real-time ke Kinesis Data Stream pelanggan.
1. Amazon Kinesis Firehose menyangga data waktu nyata ini hingga terakumulasi 128 MB, atau 60 detik berlalu, mana yang pertama. Firehose kemudian menggunakan `amazon_chime_sdk_call_analytics_firehose_schema` dalam Katalog Data Glue untuk mengompres data dan mengubah catatan JSON menjadi file parket.
1. File parket berada di bucket Amazon S3 Anda, dalam format yang dipartisi.
1. Selain data real-time, Amazon Transcribe Call Analytics pasca-panggilan meringkas file.wav (disunting dan tidak disunting, jika ditentukan dalam konfigurasi), dan rekaman panggilan file.wav juga dikirim ke Amazon S3 Bucket Anda.
1. Anda dapat menggunakan Amazon Athena dan SQL standar untuk menanyakan data di bucket Amazon S3.
1. CloudFormation Template juga membuat Katalog Data Glue untuk menanyakan data ringkasan pasca-panggilan ini melalui Athena.
1. Semua data di bucket Amazon S3 juga dapat divisualisasikan menggunakan Quick. QuickSight membangun koneksi dengan bucket Amazon S3 menggunakan Amazon Athena.
Tabel Amazon Athena menggunakan fitur berikut untuk mengoptimalkan kinerja kueri:
**Pembuatan Partisi Data**
Partisi membagi tabel Anda menjadi beberapa bagian dan menyimpan data terkait bersama-sama berdasarkan nilai kolom seperti tanggal, negara, dan wilayah. Partisi bertindak sebagai kolom virtual. Dalam hal ini, CloudFormation template mendefinisikan partisi pada pembuatan tabel, yang membantu mengurangi jumlah data yang dipindai per kueri dan meningkatkan kinerja. Anda juga dapat memfilter berdasarkan partisi untuk membatasi jumlah data yang dipindai oleh kueri. *Untuk informasi selengkapnya, lihat [Mempartisi data di Athena di Panduan Pengguna](https://docs.aws.amazon.com/athena/latest/ug/partitions.html) Amazon Athena.*
Contoh ini menunjukkan struktur partisi dengan tanggal 1 Januari 2023:
1.
```
s3://example-bucket/amazon_chime_sdk_data_lake
/serviceType=CallAnalytics/detailType={DETAIL_TYPE}/year=2023
/month=01/day=01/example-file.parquet
```
1. di mana `DETAIL_TYPE` adalah salah satu dari berikut ini:
1. `CallAnalyticsMetadata`
1. `TranscribeCallAnalytics`
1. `TranscribeCallAnalyticsCategoryEvents`
1. `Transcribe`
1. `Recording`
1. `VoiceAnalyticsStatus`
1. `SpeakerSearchStatus`
1. `VoiceToneAnalysisStatus`
**Optimalkan pembuatan penyimpanan data kolumnar**
Apache Parquet menggunakan kompresi kolom, kompresi berdasarkan tipe data, dan predikat pushdown untuk menyimpan data. Rasio kompresi yang lebih baik atau melewatkan blok data berarti membaca lebih sedikit byte dari bucket Amazon S3 Anda. Itu mengarah pada kinerja kueri yang lebih baik dan pengurangan biaya. Untuk pengoptimalan ini, konversi data dari JSON ke parket diaktifkan di Amazon Kinesis Data Firehose.
**Partisi**
Fitur Athena ini secara otomatis membuat partisi untuk setiap hari untuk meningkatkan kinerja kueri berbasis tanggal.
## Pengaturan danau data
Gunakan konsol Amazon Chime SDK untuk menyelesaikan langkah-langkah berikut.
1. **Mulai konsol Amazon Chime SDK ([ https://console.aws.amazon.com/chime-sdk/home](https://console.aws.amazon.com/chime-sdk/home)) dan di panel navigasi, di bawah **Call Analytics**, pilih Konfigurasi.**
1. Selesaikan Langkah 1, pilih **Berikutnya** dan pada halaman Langkah 2, pilih kotak centang **Voice Analytics**.
1. Di bawah **Rincian keluaran**, pilih kotak centang **Data warehouse untuk melakukan analisis historis**, lalu pilih tautan **Deploy CloudFormation stack**.
Sistem mengirim Anda ke halaman **Quick create stack** di CloudFormation konsol.
1. Masukkan nama untuk tumpukan, lalu masukkan parameter berikut:
1. `DataLakeType`— Pilih **Buat Analisis Panggilan DataLake**.
1. `KinesisDataStreamName`— Pilih aliran Anda. Ini harus menjadi aliran yang digunakan untuk streaming analitik panggilan.
1. `S3BucketURI`— Pilih ember Amazon S3 Anda. URI harus memiliki awalan `s3://bucket-name`
1. `GlueDatabaseName`— Pilih nama Database AWS Glue yang unik. Anda tidak dapat menggunakan kembali database yang ada di AWS akun.
1. Pilih kotak centang pengakuan, lalu pilih **Buat** danau data. Biarkan 10 menit agar sistem membuat danau.
### Pengaturan danau data menggunakan AWS CLI
Gunakan AWS CLI untuk membuat peran dengan izin untuk memanggil CloudFormation tumpukan create. Ikuti prosedur di bawah ini untuk membuat dan mengatur peran IAM. Untuk informasi selengkapnya, lihat [Membuat tumpukan](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-cli-creating-stack.html) di *Panduan AWS CloudFormation Pengguna*.
1. Buat peran yang disebut *AmazonChimeSdkCallAnalytics-Datalake-Provisioning-Role dan lampirkan kebijakan kepercayaan ke peran* yang memungkinkan untuk mengambil peran tersebut. CloudFormation
1. Buat kebijakan kepercayaan IAM menggunakan templat berikut dan simpan file dalam format.json.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "cloudformation.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {}
}
]
}
```
------
1. Jalankan **aws iam create-role** perintah dan teruskan kebijakan kepercayaan sebagai parameter.
```
aws iam create-role \
--role-name AmazonChimeSdkCallAnalytics-Datalake-Provisioning-Role
--assume-role-policy-document file://role-trust-policy.json
```
1. Catat *peran arn* yang dikembalikan dari respons. *peran arn* diperlukan pada langkah berikutnya.
1. Buat kebijakan dengan izin untuk membuat CloudFormation tumpukan.
1. Buat kebijakan IAM menggunakan template berikut dan simpan file dalam format.json. File ini diperlukan saat memanggil create-policy.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DeployCloudFormationStack",
"Effect": "Allow",
"Action": [
"cloudformation:CreateStack"
],
"Resource": "*"
}
]
}
```
------
1. Jalankan **aws iam create-policy** dan lewati buat kebijakan tumpukan sebagai parameter.
```
aws iam create-policy --policy-name testCreateStackPolicy
--policy-document file://create-cloudformation-stack-policy.json
```
1. Catat *peran arn* yang dikembalikan dari respons. *peran arn* diperlukan pada langkah berikutnya.
1. Lampirkan kebijakan **aws iam attach-role-policy** pada peran tersebut.
```
aws iam attach-role-policy --role-name {Role name created above}
--policy-arn {Policy ARN created above}
```
1. Buat CloudFormation tumpukan dan masukkan parameter yang diperlukan:**aws cloudformation create-stack**.
Berikan nilai parameter untuk setiap ParameterKey penggunaan ParameterValue.
```
aws cloudformation create-stack --capabilities CAPABILITY_NAMED_IAM
--stack-name testDeploymentStack
--template-url https://chime-sdk-assets.s3.amazonaws.com/public_templates/AmazonChimeSDKDataLake.yaml
--parameters ParameterKey=S3BucketURI,ParameterValue={S3 URI}
ParameterKey=DataLakeType,ParameterValue="Create call analytics datalake"
ParameterKey=KinesisDataStreamName,ParameterValue={Name of Kinesis Data Stream}
--role-arn {Role ARN created above}
```
#### Sumber daya yang dibuat oleh penyiapan danau data
Tabel berikut mencantumkan sumber daya yang dibuat saat Anda membuat data lake.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/ca-data-lake.html)
# Mengonfigurasi dasbor Cepat untuk Amazon Chime SDK
Setelah menyiapkan data lake, Anda dapat mengonfigurasi dasbor Cepat dengan metrik yang telah ditentukan sebelumnya yang memvisualisasikan data Anda. Anda dapat menggunakan dasbor berikut:
+ **Transcribe Call Analytics \$1 Voice Analytics**. Metrik mencakup ringkasan dan visual terperinci untuk turn-by-turn transkrip, masalah yang terdeteksi, hasil, deteksi entitas, dan kecocokan ID profil suara.
+ **Transcribe \$1 Analisis Suara**. Metrik mencakup ringkasan dan visual terperinci untuk turn-by-turn transkrip, kecocokan kosakata, nada suara, dan kecocokan ID profil suara.
Topik berikut menjelaskan cara mengatur akun Cepat jika Anda belum memilikinya, dan cara mengonfigurasi dasbor.
**Topics**
+ [Membuat QuickSight akun](#create-quicksight-account)
+ [Mengonfigurasi akun Anda QuickSight](#configure-qs-acct)
+ [Membuat QuickSight dasbor](#create-qs-dashboard)
## Membuat QuickSight akun
Langkah-langkah di bagian ini menjelaskan cara membuat akun Cepat. Jika Anda sudah memiliki akun, Anda dapat melompat ke[Membuat QuickSight dasbor](#create-qs-dashboard).
Anda dapat membuat QuickSight akun dengan:
+ Menggunakan CloudFormation template Amazon.
+ Menggunakan konsol Amazon Chime SDK.
### Prasyarat
Kumpulkan informasi berikut sebelum Anda mulai:
+ Nama bucket Amazon S3 analitik panggilan Anda.
+ Alamat email pemberitahuan. Sistem mengirimkan QuickSight pemberitahuan ke alamat ini.
### Menggunakan CloudFormation template untuk membuat akun
Langkah-langkah berikut menjelaskan cara membuat akun Cepat dengan menerapkan CloudFormation template Amazon. Proses ini hanya berlangganan Anda ke akun Enterprise. Untuk informasi tentang harga, lihat [Harga Cepat](https://aws.amazon.com/quicksight/pricing/).
**Untuk menyebarkan template**
1. Mulai AWS konsol dan masuk ke akun AWS Anda.
1. Tempelkan URL berikut ke bilah alamat browser Anda. Pastikan untuk memasukkan Wilayah Anda seperti yang ditunjukkan.
`https://region.console.aws.amazon.com/cloudformation/home?region=region#/stacks/quickcreate?templateURL=https://chime-sdk-assets.s3.amazonaws.com/public_templates/AmazonChimeSDKQuickSightSubscription.yaml`.
1. Pada halaman **Quick create stack**, masukkan yang berikut ini:
1. Di bawah **nama Stack** masukkan nama untuk akun Anda.
1. Di **QuickSightNotificationEmail**bawah alamat email yang Anda kumpulkan sebelumnya.
1. Di bawah **QuickSightSubscriptionForDataVisualization**, pilih **Buat AWS QuickSight akun baru**.
1. Di bawah **S3 BucketName**, masukkan nama bucket Amazon S3 Anda.
1. Pilih yang **saya akui bahwa AWS CloudFormation mungkin membuat sumber daya IAM**. kotak centang.
1. Pilih **Buat tumpukan**.
Sistem membutuhkan waktu sekitar 10 menit untuk membuat tumpukan.
1. Setelah build selesai, pilih **Buka Cepat** dan masukkan alamat email Anda untuk masuk ke akun Anda.
### Menggunakan konsol untuk membuat akun
Langkah-langkah berikut menjelaskan cara menggunakan konsol Amazon Chime SDK untuk membuat akun Cepat. Anda harus menggunakan akun Enterprise atau Enterprise \$1 Q.
**Untuk menggunakan konsol**
1. Mulai konsol Amazon Chime SDK di [ https://console.aws.amazon.com/chime-sdk/rumah](https://console.aws.amazon.com/chime-sdk/home), cari**QuickSight**, dan di hasil pencarian pilih. **QuickSight**
![\[Hasil pencarian yang menautkan ke Quick.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/quicksightsetup-1.png)
1. Pilih **Daftar untuk QuickSight**.
1. Pilih **Enterprise** atau **Enterprise \$1 Q**, lalu pilih **Lanjutkan**.
1. Masukkan nama depan, nama belakang, nomor telepon, dan alamat email yang Anda kumpulkan sebelumnya, lalu pilih **Lanjutkan**.
1. Lakukan hal-hal berikut:
1. Di bawah **Metode otentikasi**, pilih opsi.
**catatan**
Jika Anda memilih opsi dengan pengguna federasi, Anda memerlukan izin IAM yang benar. Untuk informasi selengkapnya, lihat [Mendaftar untuk berlangganan Cepat](https://docs.aws.amazon.com/quicksight/latest/user/signing-up.html) di *Panduan Pengguna Cepat*.
1. Di bawah **QuickSight Wilayah**, pilih Wilayah.
1. Di bawah **Info Akun**, masukkan nama untuk akun dan alamat email yang Anda kumpulkan sebelumnya.
1. Di bawah **QuickSight akses ke AWS Services**, gunakan peran default, atau pilih **Gunakan peran yang ada** dan pilih peran dari daftar.
1. (Opsional) sesuai kebutuhan, di bawah **Izinkan akses dan penemuan otomatis untuk sumber daya ini**, pilih sumber daya tambahan.
1. Setelah selesai, pilih **Selesai**.
1. Setelah build selesai, pilih **Buka Cepat** dan masukkan alamat email Anda untuk masuk ke akun Anda.
## Mengonfigurasi akun Anda QuickSight
Setelah Anda masuk ke QuickSight akun Anda, Anda perlu mengonfigurasi keamanan dan menambahkan diri Anda ke grup yang dibuat oleh proses penyiapan.
**Untuk mengkonfigurasi keamanan**
1. Pilih ikon profil di sudut kanan atas, lalu pilih **Kelola QuickSight** dari menu yang dihasilkan.
![\[Menu dengan QuickSight perintah Kelola.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/quicksightsetup-1-a.png)
1. Di panel navigasi, pilih **Keamanan & izin**.
1. Di bawah **QuickSight akses ke AWS layanan**, pilih **Kelola**, dan pastikan layanan berikut dipilih.
+ Amazon Redshift
+ Amazon RDS
+ Amazon S3
+ Amazon Athena
+ IAM
1. Pilih tautan **Select Amazon S3 bucket**.
1. Pilih kotak centang di samping bucket Amazon S3 Anda, lalu pilih kotak centang di sebelah kanan, di kolom **Tulis izin untuk Athena** Workgroup.
1. Pilih **Selesai**.
1. Pilih **Simpan**.
**Untuk menambahkan diri Anda ke grup**
1. Di panel navigasi, pilih **Kelola grup**, lalu pilih grup dengan **Admin di namanya**. Misalnya, *S3 BucketName* — **Admin**.
1. Pilih **Tambah pengguna**, lalu masukkan alias email Anda di kotak yang muncul.
Nama Anda muncul sebagai **Admin — alias** *Anda*.
1. Pilih **Tambahkan**.
## Membuat QuickSight dasbor
Setelah Anda membuat data lake, Anda dapat membuat QuickSight dasbor yang memvisualisasikan data Anda. Anda dapat menggunakan CloudFormation template Amazon atau konsol Amazon Chime SDK untuk membuat dasbor. Langkah-langkah berikut menjelaskan kedua metode tersebut.
**Untuk menggunakan template**
1. Mulai CloudFormation konsol Amazon.
1. Tempelkan tautan berikut ke bilah alamat browser Anda: `https://region.console.aws.amazon.com/cloudformation/home?region=region#/stacks/quickcreate?templateURL=https://chime-sdk-assets.s3.amazonaws.com/public_templates/AmazonChimeSDKQuickSightDashboards.yaml`
1. Pada halaman **Quick create stack**, di bawah **nama Stack**, masukkan nama untuk akun.
1. Di bawah **ActiveQuickSightAccount**, pilih **Benar**.
1. Di bawah **QuicksightDashboardSelection**, pilih **Call Analytics — Transcribe Call Analytics dan dasbor Voice Analytics** atau **Call Analytics — Transcribe dan** dasbor Voice Analytics.
1. Di bawah **Amazon S3 BucketName**, masukkan URI bucket Amazon S3 Anda.
1. Di bawah **GlueDatabaseName**, masukkan database Glue tempat Anda ingin QuickSight dasbor digunakan.
1. Pilih kotak centang **Saya mengakui bahwa AWS CloudFormation mungkin membuat sumber daya IAM**, lalu pilih **Buat** tumpukan.
**Untuk mengkonfigurasi QuickSight dasbor secara manual**
1. Arahkan ke QuickSight akun Anda.
1. Di pojok kanan atas pilih ikon profil, lalu pilih **Kelola QuickSight**.
![\[Kotak dialog QuickSight akun dan QuickSight perintah Kelola.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/quicksightsetup-1-a.png)
1. Di panel navigasi, pilih **Kelola grup**, lalu pilih grup yang dibuat oleh proses penyiapan.
1. Pilih **Tambah Pengguna**, masukkan alamat email Anda, lalu pilih **Tambah**.
Sistem membutuhkan waktu 10 menit untuk menyebarkan halaman.
1. Gunakan konsol Amazon Chime SDK untuk masuk ke QuickSight akun Anda dan menggunakan dasbor.
# Model data analitik panggilan untuk Amazon Chime SDK
Informasi di bagian ini mencantumkan dan menjelaskan model data analitik panggilan Amazon Chime SDK, sekumpulan tabel dalam katalog data AWS Glue.
**Topics**
+ [Memahami struktur tabel katalog AWS Glue data untuk Amazon Chime SDK](ca-data-model-diagram.md)
+ [Memahami tabel katalog AWS Glue data untuk Amazon Chime SDK](glue-tables.md)
+ [Mengekstrak data dalam katalog AWS Glue data Anda untuk analitik panggilan Amazon Chime SDK](ca-data-model-queries.md)
# Memahami struktur tabel katalog AWS Glue data untuk Amazon Chime SDK
Diagram berikut menunjukkan struktur tabel katalog data AWS Glue yang dibuat untuk analisis panggilan Amazon Chime SDK dan sesi analisis suara.
![\[Tabel dalam katalog data Glue analitik panggilan.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/glue-cat-diag-12-03.jpg)
Bagian selanjutnya mencantumkan dan menjelaskan tabel dan bidang dalam katalog.
# Memahami tabel katalog AWS Glue data untuk Amazon Chime SDK
Tabel berikut mencantumkan dan menjelaskan kolom, tipe data, dan elemen dalam katalog data Glue analitik panggilan Amazon Chime SDK.
**Topics**
+ [call\$1analytics\$1metadata](#ca-glue-metadata)
+ [call\$1analytics\$1recording\$1metadata](#ca-glue-analytics-recording)
+ [transcribe\$1call\$1analytics](#ca-glue-transcribe-ca)
+ [transcribe\$1call\$1analytics\$1category\$1events](#ca-glue-transcribe-ca-events)
+ [transcribe\$1call\$1analytics\$1post\$1call](#ca-glue-transcribe)
+ [mentranskripsikan](#ca-glue-transcribe)
+ [voice\$1analytics\$1status](#ca-glue-va-status)
+ [speaker\$1search\$1status](#ca-glue-speaker-status)
+ [voice\$1tone\$1analysis\$1status](#ca-glue-tone-status)
## call\$1analytics\$1metadata
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/glue-tables.html)
## call\$1analytics\$1recording\$1metadata
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/glue-tables.html)
## transcribe\$1call\$1analytics
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/glue-tables.html)
## transcribe\$1call\$1analytics\$1category\$1events
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/glue-tables.html)
## transcribe\$1call\$1analytics\$1post\$1call
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/glue-tables.html)
## mentranskripsikan
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/glue-tables.html)
## voice\$1analytics\$1status
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/glue-tables.html)
## speaker\$1search\$1status
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/glue-tables.html)
## voice\$1tone\$1analysis\$1status
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/glue-tables.html)
# Mengekstrak data dalam katalog AWS Glue data Anda untuk analitik panggilan Amazon Chime SDK
Gunakan contoh kueri ini untuk mengekstrak dan mengatur data dalam katalog data Glue analitik panggilan Amazon Chime SDK.
**catatan**
Untuk informasi tentang menghubungkan ke Amazon Athena dan menanyakan katalog data Glue Anda, lihat [Menyambung ke Amazon Athena](https://docs.aws.amazon.com/athena/latest/ug/connect-with-odbc.html) dengan ODBC.
Perluas setiap bagian sesuai kebutuhan.
## Mengekstrak nilai dari metadata (tipe data STRING) dalam tabel call\$1analytics\$1metadata
`call_analytics_metadata`memiliki `metadata` bidang dalam format string JSON. Gunakan [fungsi json\$1extract\$1scalar](https://docs.aws.amazon.com/athena/latest/ug/extracting-data-from-JSON.html) di Athena untuk menanyakan elemen dalam string ini.
```
SELECT
json_extract_scalar(metadata,'$.voiceConnectorId') AS "VoiceConnector ID",
json_extract_scalar(metadata,'$.fromNumber') AS "From Number",
json_extract_scalar(metadata,'$.toNumber') AS "To Number",
json_extract_scalar(metadata,'$.callId') AS "Call ID",
json_extract_scalar(metadata,'$.direction') AS Direction,
json_extract_scalar(metadata,'$.transactionId') AS "Transaction ID"
FROM
"GlueDatabaseName"."call_analytics_metadata"
```
## Menanyakan SIPRECMetadata pembaruan di tabel call\$1analytics\$1metadata
`call_analytics_metadata`Bidang ini memiliki bidang metadata dalam format string JSON. `metadata`memiliki objek bersarang lain yang disebut`oneTimeMetadata`, objek ini berisi SIPRec Metadata dalam XHTML asli dan mengubah format JSON. Gunakan `json_extract_scalar` fungsi di Athena untuk query elemen dalam string ini.
```
SELECT
json_extract_scalar(metadata,'$.voiceConnectorId') AS "VoiceConnector ID",
json_extract_scalar(metadata,'$.fromNumber') AS "From Number",
json_extract_scalar(metadata,'$.toNumber') AS "To Number",
json_extract_scalar(metadata,'$.callId') AS "Call ID",
json_extract_scalar(metadata,'$.direction') AS Direction,
json_extract_scalar(metadata,'$.transactionId') AS "Transaction ID",
json_extract_scalar(json_extract_scalar(metadata,'$.oneTimeMetadata'),'$.siprecMetadata') AS "siprec Metadata XML",
json_extract_scalar(json_extract_scalar(metadata,'$.oneTimeMetadata'),'$.siprecMetadataJson') AS "Siprec Metadata JSON",
json_extract_scalar(json_extract_scalar(metadata,'$.oneTimeMetadata'),'$.inviteHeaders') AS "Invite Headers"
FROM
"GlueDatabaseName"."call_analytics_metadata"
WHERE
callevent-type = "update";
```
## Mengekstrak nilai dari metadata (tipe data STRING) dalam tabel call\$1analytics\$1recording\$1metadata
`call_analytics_recording_metadata`memiliki bidang metadata dalam format string JSON. Gunakan [fungsi json\$1extract\$1scalar](https://docs.aws.amazon.com/athena/latest/ug/extracting-data-from-JSON.html) di Athena untuk menanyakan elemen dalam string ini.
```
SELECT
json_extract_scalar(metadata,'$.voiceConnectorId') AS "VoiceConnector ID",
json_extract_scalar(metadata,'$.fromNumber') AS "From Number",
json_extract_scalar(metadata,'$.toNumber') AS "To Number",
json_extract_scalar(metadata,'$.callId') AS "Call ID",
json_extract_scalar(metadata,'$.direction') AS Direction,
json_extract_scalar(metadata,'$.transactionId') AS "Transaction ID"
FROM
"GlueDatabaseName"."call_analytics_recording_metadata"
WHERE
detail-subtype = "Recording"
```
## Mengekstrak nilai dari detail (tipe data STRUCT) dalam tabel voice\$1analytics\$1status
`voice_analytics_status`memiliki bidang detail dalam tipe `struct` data. Contoh berikut menunjukkan bagaimana untuk query bidang tipe `struct` data:
```
SELECT
detail.transactionId AS "Transaction ID",
detail.voiceConnectorId AS "VoiceConnector ID",
detail.siprecmetadata AS "Siprec Metadata",
detail.inviteheaders AS "Invite Headers",
detail.streamStartTime AS "Stream Start Time"
FROM
"GlueDatabaseName"."voice_analytics_status"
```
## Bergabung dengan tabel voice\$1analytics\$1status dan call\$1analytics\$1metadata
Contoh query berikut bergabung `call_analytics_metadata` dan`voice_analytics_status`:
```
SELECT
a.detail.transactionId AS "Transaction ID",
a.detail.voiceConnectorId AS "VoiceConnector ID",
a.detail.siprecmetadata AS "Siprec Metadata",
a.detail.inviteheaders AS "Invite Headers",
a.detail.streamStartTime AS "Stream Start Time"
json_extract_scalar(b.metadata,'$.fromNumber') AS "From Number",
json_extract_scalar(b.metadata,'$.toNumber') AS "To Number",
json_extract_scalar(b.metadata,'$.callId') AS "Call ID",
json_extract_scalar(b.metadata,'$.direction') AS Direction
FROM
"GlueDatabaseName"."voice_analytics_status" a
INNER JOIN
"GlueDatabaseName"."call_analytics_metadata" b
ON a.detail.transactionId = json_extract_scalar(b.metadata,'$.transactionId')
```
## Mengekstrak transkrip dari tabel transcribe\$1call\$1analytics\$1post\$1call
transcribe\$1call\$1analytics\$1post\$1call memiliki bidang transkrip dalam format struct dengan array bersarang. Gunakan kueri berikut untuk menghapus sarang array:
```
SELECT
jobstatus,
languagecode,
IF(CARDINALITY(m.transcript)=0 OR CARDINALITY(m.transcript) IS NULL, NULL, e.transcript.id) AS utteranceId,
IF(CARDINALITY(m.transcript)=0 OR CARDINALITY(m.transcript) IS NULL, NULL, e.transcript.content) AS transcript,
accountid,
channel,
sessionid,
contentmetadata.output AS "Redaction"
FROM
"GlueDatabaseName"."transcribe_call_analytics_post_call" m
CROSS JOIN UNNEST
(IF(CARDINALITY(m.transcript)=0, ARRAY[NULL], transcript)) AS e(transcript)
```
## Bergabung dengan tabel transcribe\$1call\$1analytics\$1post\$1call dan call\$1analytics\$1metadata
Kueri berikut bergabung dengan transcribe\$1call\$1analytics\$1post\$1call dan call\$1analytics\$1metadata:
```
WITH metadata AS(
SELECT
from_iso8601_timestamp(time) AS "Timestamp",
date_parse(date_format(from_iso8601_timestamp(time), '%m/%d/%Y %H:%i:%s') , '%m/%d/%Y %H:%i:%s') AS "DateTime",
date_parse(date_format(from_iso8601_timestamp(time) , '%m/%d/%Y') , '%m/%d/%Y') AS "Date",
date_format(from_iso8601_timestamp(time) , '%H:%i:%s') AS "Time",
mediainsightspipelineid,
json_extract_scalar(metadata,'$.toNumber') AS "To Number",
json_extract_scalar(metadata,'$.voiceConnectorId') AS "VoiceConnector ID",
json_extract_scalar(metadata,'$.fromNumber') AS "From Number",
json_extract_scalar(metadata,'$.callId') AS "Call ID",
json_extract_scalar(metadata,'$.direction') AS Direction,
json_extract_scalar(metadata,'$.transactionId') AS "Transaction ID",
REGEXP_REPLACE(REGEXP_EXTRACT(json_extract_scalar(metadata,'$.oneTimeMetadata.s3RecordingUrl'), '[^/]+(?=\.[^.]+$)'), '\.wav$', '') AS "SessionID"
FROM
"GlueDatabaseName"."call_analytics_metadata"
),
transcript_events AS(
SELECT
jobstatus,
languagecode,
IF(CARDINALITY(m.transcript)=0 OR CARDINALITY(m.transcript) IS NULL, NULL, e.transcript.id) AS utteranceId,
IF(CARDINALITY(m.transcript)=0 OR CARDINALITY(m.transcript) IS NULL, NULL, e.transcript.content) AS transcript,
accountid,
channel,
sessionid,
contentmetadata.output AS "Redaction"
FROM
"GlueDatabaseName"."transcribe_call_analytics_post_call" m
CROSS JOIN UNNEST
(IF(CARDINALITY(m.transcript)=0, ARRAY[NULL], transcript)) AS e(transcript)
)
SELECT
jobstatus,
languagecode,
a.utteranceId,
transcript,
accountid,
channel,
a.sessionid,
"Redaction"
"Timestamp",
"DateTime",
"Date",
"Time",
mediainsightspipelineid,
"To Number",
"VoiceConnector ID",
"From Number",
"Call ID",
Direction,
"Transaction ID"
FROM
"GlueDatabaseName"."transcribe_call_analytics_post_call" a
LEFT JOIN
metadata b
ON
a.sessionid = b.SessionID
```
## Menanyakan objek media URLs untuk perekaman panggilan peningkatan suara
Contoh query berikut bergabung dengan `Voice enhancement call recording` URL:
```
SELECT
json_extract_scalar(metadata,'$.voiceConnectorId') AS "VoiceConnector ID",
json_extract_scalar(metadata,'$.fromNumber') AS "From Number",
json_extract_scalar(metadata,'$.toNumber') AS "To Number",
json_extract_scalar(metadata,'$.callId') AS "Call ID",
json_extract_scalar(metadata,'$.direction') AS Direction,
json_extract_scalar(metadata,'$.transactionId') AS "Transaction ID",
s3MediaObjectConsoleUrl
FROM
{GlueDatabaseName}."call_analytics_recording_metadata"
WHERE
detail-subtype = "VoiceEnhancement"
```
# Menggunakan analitik suara Amazon Chime SDK
Fitur analisis suara Amazon Chime SDK memungkinkan Anda menerapkan penelusuran speaker dan analisis nada suara. Anda menggunakan penelusuran pembicara untuk mengidentifikasi dan mendaftarkan penelepon baru, dan untuk mengidentifikasi penelepon berulang dan menetapkan skor kepercayaan pada identifikasi tersebut. Anda menggunakan analisis nada suara untuk memprediksi sentimen penelepon sebagai`negative`,`neutral`, atau. `positive`
Anda menjalankan analisis suara sebagai komponen opsional dari sesi analitik panggilan Amazon Chime SDK.
Analisis suara berfungsi dengan pipeline wawasan media atau panggilan Amazon Chime SDK Voice Connectors. Sebaiknya gunakan [Media Pipelines SDK](media-pipelines.md) dan menjalankan tugas pada pipeline wawasan media untuk kontrol yang lebih baik atas, dan informasi tentang, tugas.
Anda dapat menggunakan Konektor Suara untuk memastikan kompatibilitas mundur, tetapi kami hanya memperbarui saluran wawasan media APIs dengan fitur-fitur baru.
Untuk informasi selengkapnya tentang membuat dan menggunakan Konektor Suara, lihat [Mengelola Konektor Suara Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html) di Panduan Administrator SDK *Amazon Chime*.
Analisis suara juga menyediakan:
+ Pemrosesan tugas asinkron. Tugas berjalan secara independen satu sama lain.
+ Kontrol saat Anda memproses wawasan.
Anda dapat memulai analisis suara dengan menelepon [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)dan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs.
Topik berikut menjelaskan cara menggunakan analitik suara.
**Topics**
+ [Memahami arsitektur analitik suara untuk Amazon Chime SDK](va-architecture.md)
+ [Memahami alur kerja penelusuran speaker untuk Amazon Chime SDK](va-data-flow.md)
+ [Contoh alur kerja analisis nada suara untuk Amazon Chime SDK](va-tone-flow.md)
+ [Polling untuk hasil tugas untuk Amazon Chime SDK](va-task-result-poll.md)
+ [Memahami notifikasi untuk Amazon Chime SDK](va-notification-targets.md)
+ [Memahami kebijakan penyimpanan data, opt-out, dan penyimpanan data untuk Amazon Chime SDK](va-opt-out.md)
+ [Menggunakan suara APIs untuk menjalankan analisis suara untuk Amazon Chime SDK](va-in-voice-namespace.md)
# Memahami arsitektur analitik suara untuk Amazon Chime SDK
Topik di bagian ini memberikan ikhtisar arsitektur analitik suara Amazon Chime SDK, termasuk aliran data untuk setiap fitur.
Diagram ini memberikan pandangan tingkat tinggi tentang bagaimana data mengalir melalui analitik suara.
![\[Diagram yang menunjukkan aliran data tingkat tinggi melalui analitik suara.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/va-architecture-kvs.png)
Dalam diagram:
1. Audio dialirkan ke Kinesis Video Stream untuk penelepon dan agen. Anda dapat menggunakan produser Kinesis Video Streams atau streaming Amazon Chime SDK Voice Connector untuk melakukannya. *Untuk informasi selengkapnya, lihat [Memahami alur kerja untuk analitik berbasis pembelajaran mesin untuk Amazon Chime SDK](ml-based-analytics.md) di panduan ini, dan [Streaming media Konektor Suara Amazon Chime SDK ke Kinesis di](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html) Panduan Administrator SDK Amazon Chime.*
1. Aplikasi atau pembuat memicu pencarian speaker, analisis nada suara, atau keduanya, untuk aliran audio setelah pemanggil menyetujui.
1. Selama panggilan, analitik suara mengirimkan notifikasi ke target, baik Amazon Simple Queue Service (SQS), Amazon Simple Notification Service (SNS), Lambda, atau Amazon Kinesis AWS Data Streams.
Selain itu, analitik suara menyediakan alat ini untuk mengelola data yang dihasilkannya.
**Profil suara**
Kombinasi penyematan suara, ID unik penyematan, dan tanggal kedaluwarsanya. Profil suara kedaluwarsa setelah tiga tahun karena alasan keamanan, dan karena suara berubah seiring waktu. Untuk menghindari pembuatan ulang profil suara, hubungi [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UpdateVoiceProfile.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UpdateVoiceProfile.html)API. Untuk informasi selengkapnya tentang tanggal kedaluwarsa, lihat. [Memahami retensi data untuk analitik suara Amazon Chime SDK](va-data-retention.md)
Untuk mendaftarkan penyematan suara, atau memperbarui penyematan suara yang terdaftar, Anda harus menelepon [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceProfile.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceProfile.html)atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UpdateVoiceProfile.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UpdateVoiceProfile.html) APIs dalam waktu 24 jam setelah panggilan berakhir.
**Domain profil suara**
Koleksi profil suara.
# Memahami alur kerja penelusuran speaker untuk Amazon Chime SDK
Di bagian ini, kami menunjukkan contoh data dan aliran program untuk analisis pencarian speaker Amazon Chime SDK.
Fungsi pencarian speaker melibatkan pembuatan penyematan suara, yang dapat digunakan membandingkan suara pemanggil dengan data suara yang disimpan sebelumnya. Pengumpulan, penggunaan, penyimpanan, dan penyimpanan pengenal biometrik dan informasi biometrik dalam bentuk cetak suara digital mungkin memerlukan persetujuan pemanggil melalui rilis tertulis. Persetujuan tersebut diperlukan berdasarkan berbagai undang-undang negara bagian, termasuk undang-undang biometrik di Illinois, Texas, Washington, dan undang-undang privasi negara bagian lainnya. Sebelum menggunakan fitur pencarian speaker, Anda harus memberikan semua pemberitahuan, dan mendapatkan semua persetujuan sebagaimana diwajibkan oleh hukum yang berlaku, dan berdasarkan [ketentuan layanan AWS](https://aws.amazon.com/service-terms/) yang mengatur penggunaan fitur oleh Anda.
Diagram berikut menunjukkan contoh aliran data melalui tugas analisis pencarian pembicara. Deskripsi bernomor di bawah diagram menggambarkan setiap langkah proses. Diagram mengasumsikan Anda telah mengonfigurasi Konektor Suara Amazon Chime SDK dengan konfigurasi analitik panggilan yang memiliki file. `VoiceAnalyticsProcessor` Untuk informasi selengkapnya, lihat [Merekam panggilan Konektor Suara](record-vc-calls.md).
![\[Diagram yang menunjukkan aliran data melalui analisis pencarian pembicara.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/speaker-search-workflow-2.png)
1. Anda atau administrator sistem membuat domain profil suara untuk menyimpan penyematan suara dan profil suara. Untuk informasi selengkapnya tentang membuat domain profil suara, lihat [Membuat domain profil suara](https://docs.aws.amazon.com/chime-sdk/latest/ag/create-vp-domain.html), di Panduan Administrator *Amazon Chime SDK*. Anda juga dapat menggunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceProfileDomain.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceProfileDomain.html)API.
1. Penelepon melakukan panggilan menggunakan nomor telepon yang ditetapkan ke Amazon Chime SDK Voice Connector. Atau, agen menggunakan nomor Konektor Suara untuk melakukan panggilan keluar.
1. Layanan Amazon Chime SDK Voice Connector membuat ID transaksi dan mengaitkannya dengan panggilan.
1. Dengan asumsi aplikasi Anda berlangganan EventBridge event, aplikasi Anda akan memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API dengan konfigurasi pipeline dengan media insights dan Kinesis Video Stream ARNs untuk panggilan Konektor Suara.
Untuk informasi lebih lanjut tentang penggunaan EventBridge, lihat[Memahami alur kerja untuk analitik berbasis pembelajaran mesin untuk Amazon Chime SDK](ml-based-analytics.md).
1. Aplikasi Anda—seperti sistem Respons Suara Interaktif—atau agen memberikan pemberitahuan kepada penelepon mengenai perekaman panggilan dan penggunaan penyematan suara untuk analitik suara dan meminta persetujuan mereka untuk berpartisipasi.
1. Setelah pemanggil memberikan persetujuan, aplikasi atau agen Anda dapat memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask.html)API melalui [Voice SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) jika Anda memiliki Konektor Suara dan ID transaksi. Atau, jika Anda memiliki ID pipeline media insights alih-alih ID transaksi, Anda memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)API di [Media pipelines](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Media_Pipelines.html) SDK.
Setelah penelepon memberikan persetujuan, aplikasi atau agen Anda akan memanggil `StartSpeakerSearchTask` API. Anda harus meneruskan ID Konektor Suara, ID transaksi, dan ID domain profil suara ke API. ID tugas pencarian speaker dikembalikan untuk mengidentifikasi tugas asinkron.
**catatan**
[Sebelum menjalankan `StartSpeakerSearchTask` API di salah satu dari ini SDKs, Anda harus memberikan pemberitahuan yang diperlukan, dan mendapatkan persetujuan yang diperlukan, sebagaimana diwajibkan oleh hukum dan berdasarkan ketentuan layanan AWS.](https://aws.amazon.com/service-terms/)
1. Sistem mengakumulasi 10 detik dari suara penelepon. Penelepon harus berbicara setidaknya untuk jumlah waktu itu. Sistem tidak menangkap atau menganalisis keheningan.
1. Saluran wawasan media membandingkan pidato dengan profil suara di domain dan mencantumkan 10 kecocokan kepercayaan tinggi teratas. Jika tidak menemukan kecocokan, Konektor Suara akan membuat profil suara.
1. Layanan saluran media insights mengirimkan peristiwa notifikasi ke target notifikasi yang dikonfigurasi.
1. Penelepon terus berbicara dan memberikan tambahan 10 detik pidato non-diam.
1. Saluran wawasan media menghasilkan penyematan suara pendaftaran yang dapat Anda gunakan untuk membuat profil suara atau memperbarui profil suara yang ada.
1. Pipeline wawasan media mengirimkan `VoiceprintGenerationSuccessful` notifikasi ke target notifikasi yang dikonfigurasi.
1. Aplikasi Anda memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceProfile.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceProfile.html)atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UpdateVoiceProfile.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UpdateVoiceProfile.html) APIs untuk membuat atau memperbarui profil.
1. Aplikasi Anda memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetSpeakerSearchTask.html)API sesuai kebutuhan untuk mendapatkan status terbaru dari tugas pencarian speaker.
# Contoh alur kerja analisis nada suara untuk Amazon Chime SDK
**penting**
Analisis nada suara melibatkan membuat prediksi pada sentimen pembicara berdasarkan informasi linguistik dan nada. Anda tidak boleh menggunakan analisis sentimen dengan cara apa pun yang dilarang oleh hukum, termasuk dalam kaitannya dengan pengambilan keputusan tentang individu yang akan menghasilkan dampak hukum atau serupa signifikan pada individu tersebut (misalnya, terkait dengan pekerjaan, perumahan, kelayakan kredit, atau penawaran keuangan, dll.).
Analisis nada suara menganalisis suara orang-orang yang sedang menelepon dan memprediksi sentimen mereka, baik, atau`positive`. `negative` `neutral`
Diagram berikut menunjukkan contoh alur kerja untuk analisis nada suara. Item bernomor di bawah gambar menggambarkan setiap langkah proses.
**catatan**
Diagram mengasumsikan Anda telah mengonfigurasi Konektor Suara Amazon Chime SDK dengan konfigurasi analitik panggilan yang memiliki file. `VoiceAnalyticsProcessor` Untuk informasi selengkapnya, lihat [Merekam panggilan Konektor Suara](record-vc-calls.md).
![\[Diagram yang menunjukkan aliran data melalui analisis nada suara.\]](http://docs.aws.amazon.com/id_id/chime-sdk/latest/dg/images/voice-tone-workflow-v2.png)
Dalam diagram:
1. Penelepon melakukan panggilan menggunakan nomor telepon yang ditetapkan ke Amazon Chime SDK Voice Connector. Atau, agen menggunakan nomor Konektor Suara untuk melakukan panggilan keluar.
1. Layanan Konektor Suara membuat ID transaksi dan mengaitkannya dengan panggilan.
1. Aplikasi Anda—seperti sistem Respons Suara Interaktif—atau agen memberikan pemberitahuan kepada penelepon mengenai perekaman panggilan dan penggunaan penyematan suara untuk analitik suara dan meminta persetujuan mereka untuk berpartisipasi.
1. Dengan asumsi aplikasi Anda berlangganan EventBridge event, aplikasi Anda akan memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API dengan konfigurasi pipeline dengan media insights dan Kinesis Video Stream ARNs untuk panggilan Konektor Suara.
Untuk informasi lebih lanjut tentang penggunaan EventBridge, lihat[Memahami alur kerja untuk analitik berbasis pembelajaran mesin untuk Amazon Chime SDK](ml-based-analytics.md).
1. Setelah pemanggil memberikan persetujuan, aplikasi atau agen Anda dapat memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask.html)API melalui [Voice SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) jika Anda memiliki Konektor Suara dan ID transaksi. Atau, jika Anda memiliki ID pipeline media insights alih-alih ID transaksi, Anda memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)API di [Media pipelines](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Media_Pipelines.html) SDK.
Setelah penelepon memberikan persetujuan, aplikasi atau agen Anda akan memanggil `StartSpeakerSearchTask` API. Anda harus meneruskan ID Konektor Suara, ID transaksi, dan ID domain profil suara ke API. ID tugas pencarian speaker dikembalikan untuk mengidentifikasi tugas asinkron.
1. Pengguna berbicara sepanjang panggilan.
1. Agen berbicara sepanjang panggilan.
1. Setiap 5 detik, saluran wawasan media menggunakan model pembelajaran mesin untuk menganalisis 30 detik terakhir ucapan dan memprediksi nada pemanggil untuk interval itu, dan untuk seluruh panggilan sejak pertama kali `StartVoiceToneAnalysisTask` dipanggil.
1. Saluran wawasan media mengirimkan pemberitahuan dengan informasi tersebut ke target notifikasi yang dikonfigurasi. Anda dapat mengidentifikasi notifikasi berdasarkan ARN streaming dan ID salurannya. Untuk informasi lebih lanjut, lihat[Memahami notifikasi untuk Amazon Chime SDK](va-notification-targets.md), nanti di bagian ini.
1. Ulangi langkah 9 dan 10 hingga panggilan berakhir.
1. Di akhir panggilan, saluran wawasan media mengirimkan satu pemberitahuan terakhir dengan prediksi nada rata-rata saat ini selama 30 detik terakhir, ditambah nada rata-rata dari seluruh panggilan.
1. Aplikasi Anda memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetVoiceToneAnalysisTask.html)API sesuai kebutuhan untuk mendapatkan status terbaru dari tugas analisis nada suara.
**catatan**
`GetVoiceToneAnalysisTask`API tidak mengalirkan data nada.
**catatan**
[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetVoiceToneAnalysisTask.html)API tidak mengembalikan data nada suara.
# Polling untuk hasil tugas untuk Amazon Chime SDK
**penting**
Secara default, analisis suara membuat hasil tersedia selama 7 hari, kemudian menghapus data secara otomatis. Anda harus menyimpan data tugas Anda jika Anda ingin menggunakannya untuk waktu yang lebih lama, atau untuk mematuhi undang-undang penyimpanan data. Untuk informasi lebih lanjut, lihat[Memahami retensi data untuk analitik suara Amazon Chime SDK](va-data-retention.md), nanti di panduan ini.
Analisis suara mencoba memastikan setidaknya satu pengiriman dari setiap hasil tugas. Namun, masalah jaringan dapat meningkatkan latensi. [Untuk mengatasi masalah potensial, atau jika Anda lebih suka proses sinkron, Anda dapat menggunakan yang berikut APIs di SDK [pipeline Media atau Voice SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Media_Pipelines.html):](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html)
+ [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetSpeakerSearchTask.html)
+ [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_GetVoiceToneAnalysisTask.html)
**penting**
`GetVoiceToneAnalysisTask`API hanya mengembalikan status tugas. Itu tidak mengembalikan hasil tugas. Untuk melihat hasil, gunakan target notifikasi Amazon SQS, Amazon SNS, atau AWS Lambda.
`GetSpeakerSearchTask`API mendapatkan hasil terbaru secara sinkron untuk ID tugas, pesan tertunda, atau pesan yang tidak berurutan. Namun, sebaiknya gunakan target notifikasi dan pemrosesan asinkron. Melakukannya mengkonsumsi lebih sedikit sumber daya komputasi.
# Memahami notifikasi untuk Amazon Chime SDK
Analisis suara secara otomatis mengirimkan peristiwa ke target saat penelusuran speaker atau tugas analisis nada suara dimulai, saat dijalankan, dan saat selesai. Anda menggunakan target notifikasi untuk menerima peristiwa tersebut. Sebaiknya gunakan beberapa target notifikasi jika alur kerja atau aplikasi Anda membutuhkan ketersediaan tinggi.
Selain itu, Anda harus menggunakan peran IAM dengan kebijakan yang diperlukan untuk mengakses target notifikasi Anda. Untuk informasi selengkapnya, lihat [Menggunakan peran akses sumber daya analitik panggilan untuk Amazon Chime SDK](call-analytics-resource-access-role.md).
**catatan**
Untuk Amazon SQS dan Amazon SNS, kami tidak mendukung antrian. first-in-first-out Akibatnya, pesan mungkin tidak beres. Sebaiknya periksa stempel waktu untuk memesan pesan sesuai kebutuhan, dan menyimpan pesan di penyimpanan data seperti Amazon DynamoDB. Anda juga dapat menggunakan Dapatkan APIs dijelaskan [Polling untuk hasil tugas untuk Amazon Chime SDK](va-task-result-poll.md) untuk menerima hasil terbaru.
Tabel berikut mencantumkan peristiwa dan jenis detailnya yang sesuai.
| Acara pemberitahuan | Jenis detail |
| --- | --- |
| Metadata analitik suara | `VoiceAnalyticsStatus` |
| Pencarian speaker | `SpeakerSearchStatus` |
| Analisis nada suara | `VoiceToneAnalysisStatus` |
# Memahami kebijakan IAM untuk target notifikasi untuk Amazon Chime SDK
Anda harus menggunakan kebijakan dalam peran IAM dalam konfigurasi Call Analytics yang memungkinkan akses ke target notifikasi Amazon SQS, Amazon SNS, AWS Lambda, atau Amazon KDS Anda. Untuk informasi selengkapnya, lihat [Menggunakan peran akses sumber daya analitik panggilan untuk Amazon Chime SDK](call-analytics-resource-access-role.md) dalam panduan ini.
## Acara pencarian pembicara
Acara pencarian pembicara memiliki jenis `SpeakerSearchStatus` detail.
Amazon Chime SDK Voice Connectors mengirimkan acara pencarian pembicara berikut:
+ Kecocokan identifikasi
+ Generasi penyematan suara
Acara dapat memiliki status berikut:
+ `IdentificationSuccessful`— Berhasil mengidentifikasi setidaknya satu ID profil suara yang cocok dengan skor kepercayaan tinggi di domain profil suara yang diberikan.
+ `IdentificationFailure`— Gagal melakukan identifikasi. Penyebab: penelepon tidak berbicara setidaknya 10 detik, kualitas audio buruk.
+ `IdentificationNoMatchesFound`— Tidak dapat menemukan kecocokan kepercayaan tinggi di domain profil suara yang diberikan. Penelepon mungkin baru, atau suara mereka mungkin telah berubah.
+ `VoiceprintGenerationSuccessful`— Sistem menghasilkan penyematan suara menggunakan 20 detik audio non-senyap.
+ `VoiceprintGenerationFailure`— Sistem gagal menghasilkan penyematan suara. Penyebab: penelepon tidak berbicara setidaknya selama 20 detik, kualitas audio buruk.
### Kecocokan identifikasi
Setelah [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask)API dipanggil untuk diberikan`transactionId`, layanan Konektor Suara mengembalikan pemberitahuan kecocokan identifikasi setelah 10 detik ucapan tanpa suara. Layanan mengembalikan 10 pertandingan teratas, bersama dengan ID profil suara dan skor kepercayaan mulai dari [0, 1]. Semakin tinggi skor kepercayaan, semakin besar kemungkinan pembicara dari panggilan tersebut cocok dengan ID profil suara. Jika model pembelajaran mesin tidak menemukan kecocokan, `detailStatus` bidang notifikasi berisi`IdentificationNoMatchesFound`.
Contoh berikut menunjukkan pemberitahuan untuk kecocokan yang berhasil.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-111122223333",
"detail-type": "SpeakerSearchStatus",
"service-type": "VoiceAnalytics",
"source": "aws.chime",
"account": "111122223333",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-east-1",
"resources": [],
"detail": {
"taskId": "uuid",
"detailStatus": "IdentificationSuccessful",
"speakerSearchDetails" : {
"results": [
{
"voiceProfileId": "vp-505e0992-82da-49eb-9d4a-4b34772b96b6",
"confidenceScore": "0.94567856",
},
{
"voiceProfileId": "vp-fba9cbfa-4b8d-4f10-9e41-9dfdd66545ab",
"confidenceScore": "0.82783350",
},
{
"voiceProfileId": "vp-746995fd-16dc-45b9-8965-89569d1cf787",
"confidenceScore": "0.77136436",
}
]
},
"mediaInsightsPipelineId": "87654321-33ca-4dc6-9cdf-abcde6612345",
"sourceArn": "arn:aws:chime:us-east-1:111122223333:media-pipeline/87654321-33ca-4dc6-9cdf-abcde6612345",
"streamArn": "arn:aws:kinesisvideo:us-east-1:111122223333:stream/my-stream/0123456789012",
"channelId": 0
}
}
```
### Generasi penyematan suara
Setelah 10 detik ucapan non-senyap tambahan, Konektor Suara mengirimkan pemberitahuan pembuatan penyematan suara ke target notifikasi. Anda dapat mendaftarkan penyematan suara baru di profil suara, atau memperbarui cetakan yang sudah ada di profil suara.
Contoh berikut menunjukkan pemberitahuan untuk kecocokan yang berhasil, artinya Anda dapat memperbarui profil suara terkait.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-111122223333",
"detail-type": "SpeakerSearchStatus",
"service-type": "VoiceAnalytics",
"source": "aws.chime",
"account": "111122223333",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-east-1",
"resources": [],
"detail": {
"taskId": "guid",
"detailStatus": "VoiceprintGenerationSuccess",
"mediaInsightsPipelineId": "87654321-33ca-4dc6-9cdf-abcde6612345",
"sourceArn": "arn:aws:chime:us-east-1:111122223333:media-pipeline/87654321-33ca-4dc6-9cdf-abcde6612345",
"streamArn": "arn:aws:kinesisvideo:us-east-1:111122223333:stream/my-stream/0123456789012",
"channelId": 0
}
}
```
## Peristiwa analisis nada suara
Peristiwa analisis nada suara memiliki jenis `VoiceToneAnalysisStatus` detail. Analisis dapat mengembalikan status ini:
+ `VoiceToneAnalysisSuccessful`— Berhasil menganalisis suara penelepon dan agen menjadi probabilitas sentimen — positif, negatif, atau netral.
+ `VoiceToneAnalysisFailure`— Gagal melakukan analisis nada. Ini bisa terjadi jika penelepon hang tanpa berbicara selama 10 detik, atau jika kualitas audio menjadi terlalu buruk.
+ `VoiceToneAnalysisCompleted`— Berhasil menganalisis suara pengguna dan agen ke dalam probabilitas sentimen untuk seluruh panggilan. Ini adalah acara terakhir, dikirim ketika analisis nada suara selesai.
Contoh berikut menunjukkan peristiwa analisis nada suara yang khas.
```
{
"detail-type": "VoiceToneAnalysisStatus",
"service-type": "VoiceAnalytics",
"source": "aws.chime",
"account": "216539279014",
"time": "2022-08-26T17:55:15.563441Z",
"region": "us-east-1",
"detail": {
"taskId": "uuid",
"detailStatus": "VoiceToneAnalysisSuccessful",
"voiceToneAnalysisDetails": {
"currentAverageVoiceTone": {
"startTime": "2022-08-26T17:55:15.563Z",
"endTime": "2022-08-26T17:55:45.720Z",
"voiceToneLabel": "neutral",
"voiceToneScore": {
"neutral": "0.83",
"positive": "0.13",
"negative": "0.04"
}
},
"overallAverageVoiceTone": {
"startTime": "2022-08-26T16:23:13.344Z",
"endTime": "2022-08-26T17:55:45.720Z",
"voiceToneLabel": "positive",
"voiceToneScore": {
"neutral": "0.25",
"positive": "0.65",
"negative": "0.1"
}
}
},
"startFragmentNumber": "01234567890123456789",
"mediaInsightsPipelineId": "87654321-33ca-4dc6-9cdf-abcde6612345",
"sourceArn": "arn:aws:chime:us-east-1:111122223333:media-pipeline/87654321-33ca-4dc6-9cdf-abcde6612345",
"streamArn": "arn:aws:kinesisvideo:us-east-1:111122223333:stream/my-stream/0123456789012",
"channelId": 0
},
"version": "0",
"id": "Id-f928dfe3-f44b-4965-8a17-612f9fb92d59"
}
```
## Acara ringkasan pasca-panggilan
Acara ringkasan panggilan pos dikirim 5 menit setelah panggilan berakhir. Ringkasan ini memberikan ikhtisar tugas pencarian pembicara yang terjadi selama panggilan.
Contoh berikut menunjukkan ringkasan panggilan pos dengan kecocokan profil suara terbaik, identitas pembicara yang dikonfirmasi, dan daftar profil suara yang dibuat atau diperbarui melalui panggilan `UpdateVoiceProfile` API `CreateVoiceProfile` dan yang dilakukan selama panggilan.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-111122223333",
"detail-type": "VoiceAnalyticsStatus",
"service-type": "VoiceAnalytics",
"source": "aws.chime",
"account": "111122223333",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-east-1",
"resources": [],
"detail": {
"detailStatus": "PostCallVoiceAnalytics",
"callId": "22e8dee8-bbd7-4f94-927b-2d0ebaeddc1c",
"transactionId": "daaeb6bf-2fe2-4e51-984e-d0fbf2f09436",
"voiceConnectorId": "abcdef1ghij2klmno3pqr4",
"isCaller": true | false,
"speakerSearchResults": {
"bestMatchedVoiceProfileId": "vp-04c25ba1-a059-4fd3-8495-4ac91b55e2bf",
"customerValidatedCallerIdentity": "vp-04c25ba1-a059-4fd3-8495-4ac91b55e2bf",
"createVoiceProfileTransactions": [
{
"voiceProfileId": "vp-04c25ba1-a059-4fd3-8495-4ac91b55e2bf",
"requestTimestamp": "2022-12-14T18:38:38.796Z"
},
{
"voiceProfileId": "vp-04c25ba1-a059-4fd3-8495-4ac91b55e2bf",
"requestTimestamp": "2022-12-14T18:38:38.796Z",
}
],
"updateVoiceProfileTransactions": [
{
"voiceProfileId": "vp-04c25ba1-a059-4fd3-8495-4ac91b55e2bf",
"requestTimestamp": "2022-12-14T18:38:38.796Z",
},
{
"voiceProfileId": "vp-04c25ba1-a059-4fd3-8495-4ac91b55e2bf",
"requestTimestamp": "2022-12-14T18:38:38.796Z",
}
]
}
}
}
```
# Contoh analisis suara Fungsi Lambda untuk Amazon Chime SDK
Kode Python dalam contoh berikut memproses notifikasi yang diterima dari Konektor Suara. Anda dapat menambahkan kode ke fungsi AWS Lambda. Anda juga dapat menggunakannya untuk memicu antrean Amazon SQS, topik Amazon SNS, atau Amazon Kinesis Data Stream. Anda kemudian dapat menyimpan notifikasi dalam pemrosesan `EventTable` for future. Untuk format notifikasi yang tepat, lihat[Memahami notifikasi untuk Amazon Chime SDK](va-notification-targets.md).
```
import base64
import boto3
import json
import logging
import time
from datetime import datetime
from enum import Enum
log = logging.getLogger()
log.setLevel(logging.INFO)
dynamo = boto3.client("dynamodb")
EVENT_TABLE_NAME = "EventTable"
class EventType(Enum):
"""
This example code uses a single Lambda processor to handle either
triggers from SQS, SNS, Lambda, or Kinesis. You can adapt it to fit your
desired infrastructure depending on what you prefer. To distinguish
where we get events from, we use an EventType enum as an
example to show the different ways of parsing the notifications.
"""
SQS = "SQS"
SNS = "SNS"
LAMBDA = "LAMBDA"
KINESIS = "KINESIS"
class AnalyticsType(Enum):
"""
Define the various analytics event types that this Lambda will
handle.
"""
SPEAKER_SEARCH = "SpeakerSearch"
VOICE_TONE_ANALYSIS = "VoiceToneAnalysis"
ANALYTICS_READY = "AnalyticsReady"
UNKNOWN = "UNKNOWN"
class DetailType(Enum):
"""
Define the various detail types that Voice Connector's voice
analytics feature can return.
"""
SPEAKER_SEARCH_TYPE = "SpeakerSearchStatus"
VOICE_TONE_ANALYSIS_TYPE = "VoiceToneAnalysisStatus"
ANALYTICS_READY = "VoiceAnalyticsStatus"
def handle(event, context):
"""
Example of how to handle incoming Voice Analytics notification messages
from Voice Connector.
"""
logging.info(f"Received event of type {type(event)} with payload {event}")
is_lambda = True
# Handle triggers from SQS, SNS, and KDS. Use the below code if you would like
# to use this Lambda as a trigger for an existing SQS queue, SNS topic or Kinesis
# stream.
if "Records" in event:
logging.info("Handling event from SQS or SNS since Records exists")
is_lambda = False
for record in event.get("Records", []):
_process_record(record)
# If you would prefer to have your Lambda invoked directly, use the
# below code to have the Voice Connector directly invoke your Lambda.
# In this scenario, there are no "Records" passed.
if is_lambda:
logging.info(f"Handling event from Lambda")
event_type = EventType.LAMBDA
_process_notification_event(event_type, event)
def _process_record(record):
# SQS and Kinesis use eventSource.
event_source = record.get("eventSource")
# SNS uses EventSource.
if not event_source:
event_source = record.get("EventSource")
# Assign the event type explicitly based on the event source value.
event_type = None
if event_source == "aws:sqs":
event = record["body"]
event_type = EventType.SQS
elif event_source == "aws:sns":
event = record["Sns"]["Message"]
event_type = EventType.SNS
elif event_source == "aws:kinesis":
raw_data = record["kinesis"]["data"]
raw_message = base64.b64decode(raw_data).decode('utf-8')
event = json.loads(raw_message)
event_type = EventType.KINESIS
else:
raise Exception(f"Event source {event_source} is not supported")
_process_notification_event(event_type, event)
def _process_notification_event(
event_type: EventType,
event: dict
):
"""
Extract the attributes from the Voice Analytics notification message
and store it as a DynamoDB item to process later.
"""
message_id = event.get("id")
analytics_type = _get_analytics_type(event.get("detail-type"))
pk = None
if analytics_type == AnalyticsType.ANALYTICS_READY.value or analytics_type == AnalyticsType.UNKNOWN.value:
transaction_id = event.get("detail").get("transactionId")
pk = f"transactionId#{transaction_id}#notificationType#{event_type.value}#analyticsType#{analytics_type}"
else:
task_id = event.get("detail").get("taskId")
pk = f"taskId#{task_id}#notificationType#{event_type.value}#analyticsType#{analytics_type}"
logging.info(f"Generated PK {pk}")
_create_request_record(pk, message_id, json.dumps(event))
def _create_request_record(pk: str, sk: str, body: str):
"""
Record this notification message into the Dynamo db table
"""
try:
# Use consistent ISO8601 date format.
# 2019-08-01T23:09:35.369156 -> 2019-08-01T23:09:35.369Z
time_now = (
datetime.utcnow().isoformat()[:-3] + "Z"
)
response = dynamo.put_item(
Item={
"PK": {"S": pk},
"SK": {"S": sk},
"body": {"S": body},
"createdOn": {"S": time_now},
},
TableName=EVENT_TABLE_NAME,
)
logging.info(f"Added record in table {EVENT_TABLE_NAME}, response : {response}")
except Exception as e:
logging.error(f"Error in adding record: {e}")
def _get_analytics_type(detail_type: str):
"""
Get analytics type based on message detail type value.
"""
if detail_type == DetailType.SPEAKER_SEARCH_TYPE.value:
return AnalyticsType.SPEAKER_SEARCH.value
elif detail_type == DetailType.VOICE_TONE_ANALYSIS_TYPE.value:
return AnalyticsType.VOICE_TONE_ANALYSIS.value
elif detail_type == DetailType.ANALYTICS_READY.value:
return AnalyticsType.ANALYTICS_READY.value
else:
return AnalyticsType.UNKNOWN.value
```
**penting**
Anda harus menerima persetujuan sebelum menelepon [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask)atau [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysis.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysis.html) APIs. Kami menyarankan Anda mempertahankan acara di area penahanan, seperti Amazon DynamoDB, hingga Anda menerima persetujuan.
# Memahami kebijakan penyimpanan data, opt-out, dan penyimpanan data untuk Amazon Chime SDK
Amazon Chime SDK menggunakan data suara untuk menyediakan dan meningkatkan layanan pencarian speaker. Sebagai bagian dari itu, kami menggunakan audio pendaftaran, cuplikan rekaman yang digunakan untuk membuat penyematan suara, untuk melatih pembelajaran mesin dan model kecerdasan buatan kami. Anda dapat memilih untuk tidak menggunakan data Anda untuk melatih model, dan topik di bagian ini menjelaskan caranya.
**Topics**
+ [Memahami penyimpanan data untuk penelusuran speaker untuk Amazon Chime SDK](speaker-search-data-storage.md)
+ [Menangani pilihan keluar untuk pencarian speaker untuk Amazon Chime SDK](va-handle-opt-outs.md)
+ [Memahami retensi data untuk analitik suara Amazon Chime SDK](va-data-retention.md)
# Memahami penyimpanan data untuk penelusuran speaker untuk Amazon Chime SDK
Amazon Chime SDK menyimpan data berikut untuk penelusuran speaker:
+ Penyematan suara yang melekat pada profil suara yang kami gunakan untuk menyediakan fungsionalitas pencarian speaker.
+ Audio pendaftaran, cuplikan pidato yang direkam digunakan untuk membuat penyematan suara untuk setiap profil suara. Kami menggunakan rekaman audio pendaftaran untuk:
+ Perbarui model pencarian speaker, bagian penting dari penyediaan fitur pencarian speaker.
+ Latih model pembelajaran mesin untuk mengembangkan dan meningkatkan layanan. Penggunaan audio pendaftaran untuk pelatihan bersifat opsional, dan Anda dapat memilih keluar dari penggunaan ini dengan memilih kebijakan opt-out seperti yang dijelaskan di bagian berikut.
# Menangani pilihan keluar untuk pencarian speaker untuk Amazon Chime SDK
Anda dapat menangani opt-out untuk pengguna akhir dan seluruh organisasi. Memilih keluar memiliki efek sebagai berikut:
+ Setelah Anda memilih keluar, analitik suara tidak akan menggunakan audio pendaftaran baru apa pun untuk pelatihan model, dan tidak akan menggunakan audio pendaftaran apa pun yang dikumpulkan dan disimpan sebelum Anda memilih keluar.
+ Setelah Anda memilih keluar, analitik suara akan menyimpan dan menggunakan audio pendaftaran untuk menyediakan layanan pencarian speaker.
**Awas**
Tindakan opt-out berikut tidak dapat diubah. Anda tidak dapat memulihkan data yang dihapus.
**Menangani opt-out pengguna akhir**
Saat pengguna akhir ingin memilih keluar dari pencarian speaker, hubungi [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_DeleteVoiceProfile.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_DeleteVoiceProfile.html)API. Tindakan ini menghapus profil suara, ditambah penyematan suara dan audio pendaftaran.
Untuk menghapus grup penyematan suara, panggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_DeleteVoiceProfileDomain.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_DeleteVoiceProfileDomain.html)API untuk menghapus domain. Tindakan ini menghapus *semua* profil suara di domain.
**Menangani opt-out di tingkat organisasi**
Untuk menangani opt-out untuk seluruh organisasi, gunakan kebijakan opt-out AWS Organisasi. Gunakan nama `chimesdkvoiceanalytics` layanan. Untuk informasi tentang kebijakan, lihat kebijakan [opt-out layanan AI](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html) di *Panduan Pengguna AWS Organizations*.
**catatan**
Untuk menggunakan kebijakan opt-out, AWS akun Anda harus dikelola secara terpusat oleh Organizations. AWS Jika Anda belum membuat organisasi untuk AWS akun Anda, lihat [Membuat dan mengelola organisasi](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org.html) di *Panduan Pengguna AWS Organizations*.
# Memahami retensi data untuk analitik suara Amazon Chime SDK
Secara default, analitik suara Amazon Chime SDK menghapus penyematan suara setelah 3 tahun. Kami melakukan ini karena suara orang berubah seiring waktu, dan juga untuk keamanan. Anda dapat menggunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UpdateVoiceProfile.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UpdateVoiceProfile.html)API untuk memperbarui penyematan suara yang kedaluwarsa.
Hasil dari [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask.html)dan juga [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysisTask.html)akan tersedia dari masing-masing [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetSpeakerSearchTask.html)dan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetVoiceToneAnalysisTask.html) APIs untuk maksimal 7 hari.
Penyematan suara yang dihasilkan dari a [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask.html)tersedia untuk persistensi melalui [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceProfile.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceProfile.html)dan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UpdateVoiceProfile.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UpdateVoiceProfile.html) APIs selama 24 jam, setelah itu dihapus dan tidak tersedia.
Untuk menghapus hasil, dan untuk menangani penarikan persetujuan dari pelanggan Anda, lihat bagian sebelumnya.
# Menggunakan suara APIs untuk menjalankan analisis suara untuk Amazon Chime SDK
Untuk kompatibilitas mundur, Anda dapat menggunakan Amazon Chime SDK APIs Voice untuk memulai dan mengelola analitik suara. Namun, hanya saluran wawasan media APIs untuk analitik suara yang menyediakan fitur baru, jadi kami sangat menyarankan untuk menggunakannya.
Bagian berikut menjelaskan perbedaan antara pipa APIs wawasan suara dan media.
## Menghentikan tugas
Jika Anda menggunakan Konektor Suara untuk memulai tugas analitik suara, lalu Anda menggunakan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html)API untuk menjeda pipeline, tugas akan terus berjalan. Untuk menghentikan tugas, Anda harus memanggil [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StopSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StopSpeakerSearchTask.html)dan [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StopVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StopVoiceToneAnalysisTask.html) APIs.
## Memahami perbedaan notifikasi
Saat Anda menggunakan suara APIs untuk menjalankan analisis suara, notifikasi berbeda dari notifikasi yang dihasilkan oleh pipeline wawasan media.
+ Acara siap analitik suara hanya tersedia untuk tugas yang dimulai menggunakan suara APIs.
+ Anda perlu menggunakan`voiceConnectorId`,`transactionId`, atau `callId` bidang dalam notifikasi untuk mengaitkan tugas analitik suara dengan panggilan. Jika Anda menggunakan pipeline wawasan media untuk menjalankan analisis suara, Anda menggunakan `channelId` bidang `mediaInsightsPipelineId` and `streamArn` or untuk mengaitkan tugas dengan panggilan.
Topik berikut menjelaskan cara menggunakan notifikasi dengan suara APIs.
**Topics**
+ [Acara siap analitik suara](#va-ready-events)
+ [Acara pencarian pembicara](#va-speaker-search-events)
+ [Peristiwa analisis nada suara](#va-tone-status)
### Acara siap analitik suara
Acara siap analitik suara memiliki jenis `VoiceAnalyticsStatus` detail.
Anda menggunakan Amazon Chime SDK Voice Connectors untuk memulai tugas analitik. Saat menerima acara siap analitik suara, Anda dapat memicu penelusuran speaker atau tugas analisis nada suara untuk panggilan tersebut, yang diidentifikasi oleh properti berikut:
+ `voiceConnectorId`
+ `transactionId`
**catatan**
Pemberitahuan ini diberikan hanya jika Anda memiliki konfigurasi saluran wawasan media dengan analitik suara diaktifkan dan dikaitkan dengan Konektor Suara. Pemberitahuan ini TIDAK diberikan saat pelanggan memanggil `CreateMediaInsightsPipeline` API dan meluncurkan tugas pencarian speaker atau tugas analisis nada suara melalui Media Pipelines SDK.
Header SIP yang dikembalikan oleh Konektor Suara berisi file. `transactionId` Jika Anda tidak memiliki akses ke header SIP, acara `AnalyticsReady` notifikasi juga berisi `voiceConnectorId` dan`transactionId`. Itu memungkinkan Anda untuk secara terprogram menerima informasi dan menelepon [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask), atau. [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysis.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysis.html) APIs
Saat analitik suara siap untuk diproses, Konektor Suara mengirimkan acara dengan `"detailStatus": "AnalyticsReady"` target notifikasi sebagai badan JSON. Jika Anda menggunakan Amazon SNS atau Amazon SQS, badan tersebut akan muncul di bidang “Rekaman” di payload Amazon SNS atau Amazon SQS.
Contoh berikut menunjukkan tubuh JSON yang khas.
```
{
"detail-type": "VoiceAnalyticsStatus",
"version": "0",
"id": "Id-f928dfe3-f44b-4965-8a17-612f9fb92d59",
"source": "aws.chime",
"account": "123456789012",
"time": "2022-08-26T17:55:15.563441Z",
"region": "us-east-1",
"resources": [],
"detail": {
"detailStatus": "AnalyticsReady",
"callDetails": {
"isCaller": false,
"transactionId": "daaeb6bf-2fe2-4e51-984e-d0fbf2f09436",
"voiceConnectorId": "fuiopl1fsv9caobmqf2vy7"
}
}
}
```
Pemberitahuan ini memungkinkan Anda untuk memicu panggilan balik tambahan ke aplikasi Anda, dan untuk menangani persyaratan hukum apa pun, seperti pemberitahuan dan persetujuan, sebelum memanggil tugas APIs analitik suara.
### Acara pencarian pembicara
Acara pencarian pembicara memiliki jenis `SpeakerSearchStatus` detail.
Amazon Chime SDK Voice Connectors mengirimkan acara pencarian pembicara berikut:
+ Kecocokan identifikasi
+ Generasi penyematan suara
Acara dapat memiliki status berikut:
+ `IdentificationSuccessful`— Berhasil mengidentifikasi setidaknya satu ID profil suara yang cocok dengan skor kepercayaan tinggi di domain profil suara yang diberikan.
+ `IdentificationFailure`— Gagal melakukan identifikasi. Penyebab: penelepon tidak berbicara setidaknya 10 detik, kualitas audio buruk.
+ `IdentificationNoMatchesFound`— Tidak dapat menemukan kecocokan kepercayaan tinggi di domain profil suara yang diberikan. Penelepon mungkin baru, atau suara mereka mungkin telah berubah.
+ `VoiceprintGenerationSuccessful`— Sistem menghasilkan penyematan suara menggunakan 20 detik audio non-senyap.
+ `VoiceprintGenerationFailure`— Sistem gagal menghasilkan penyematan suara. Penyebab: penelepon tidak berbicara setidaknya selama 20 detik, kualitas audio buruk.
#### Kecocokan identifikasi
Setelah [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask)API dipanggil untuk diberikan`transactionId`, layanan Konektor Suara mengembalikan pemberitahuan kecocokan identifikasi setelah 10 detik ucapan tanpa suara. Layanan mengembalikan 10 pertandingan teratas, bersama dengan ID profil suara dan skor kepercayaan mulai dari [0, 1]. Semakin tinggi skor kepercayaan, semakin besar kemungkinan pembicara dari panggilan tersebut cocok dengan ID profil suara. Jika model pembelajaran mesin tidak menemukan kecocokan, `detailStatus` bidang notifikasi berisi`IdentificationNoMatchesFound`.
Contoh berikut menunjukkan pemberitahuan untuk kecocokan yang berhasil.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-111122223333",
"detail-type": "SpeakerSearchStatus",
"service-type": "VoiceAnalytics",
"source": "aws.chime",
"account": "111122223333",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-east-1",
"resources": [],
"detail": {
"taskId": "uuid",
"detailStatus": "IdentificationSuccessful",
"speakerSearchDetails" : {
"results": [
{
"voiceProfileId": "vp-505e0992-82da-49eb-9d4a-4b34772b96b6",
"confidenceScore": "0.94567856",
},
{
"voiceProfileId": "vp-fba9cbfa-4b8d-4f10-9e41-9dfdd66545ab",
"confidenceScore": "0.82783350",
},
{
"voiceProfileId": "vp-746995fd-16dc-45b9-8965-89569d1cf787",
"confidenceScore": "0.77136436",
}
]
},
"isCaller": false,
"voiceConnectorId": "abcdef1ghij2klmno3pqr4",
"transactionId": "daaeb6bf-2fe2-4e51-984e-d0fbf2f09436"
}
}
```
#### Generasi penyematan suara
Setelah 10 detik ucapan non-senyap tambahan, Konektor Suara mengirimkan pemberitahuan pembuatan penyematan suara ke target notifikasi. Anda dapat mendaftarkan penyematan suara baru di profil suara, atau memperbarui cetakan yang sudah ada di profil suara.
Contoh berikut menunjukkan pemberitahuan untuk kecocokan yang berhasil, artinya Anda dapat memperbarui profil suara terkait.
```
{
"version": "0",
"id": "12345678-1234-1234-1234-111122223333",
"detail-type": "SpeakerSearchStatus",
"service-type": "VoiceAnalytics",
"source": "aws.chime",
"account": "111122223333",
"time": "yyyy-mm-ddThh:mm:ssZ",
"region": "us-east-1",
"resources": [],
"detail": {
"taskId": "guid",
"detailStatus": "VoiceprintGenerationSuccess",
"isCaller": false,
"transactionId": "12345678-1234-1234",
"voiceConnectorId": "abcdef1ghij2klmno3pqr"
}
}
```
### Peristiwa analisis nada suara
Peristiwa analisis nada suara memiliki jenis `VoiceToneAnalysisStatus` detail. Analisis dapat mengembalikan status ini:
+ `VoiceToneAnalysisSuccessful`— Berhasil menganalisis suara penelepon dan agen menjadi probabilitas sentimen — positif, negatif, atau netral.
+ `VoiceToneAnalysisFailure`— Gagal melakukan analisis nada. Ini bisa terjadi jika penelepon hang tanpa berbicara selama 10 detik, atau jika kualitas audio menjadi terlalu buruk.
+ `VoiceToneAnalysisCompleted`— Berhasil menganalisis suara pengguna dan agen ke dalam probabilitas sentimen untuk seluruh panggilan. Ini adalah acara terakhir, dikirim ketika analisis nada suara selesai.
Contoh berikut menunjukkan peristiwa analisis nada suara yang khas.
```
{
"detail-type": "VoiceToneAnalysisStatus",
"service-type": "VoiceAnalytics",
"source": "aws.chime",
"account": "216539279014",
"time": "2022-08-26T17:55:15.563441Z",
"region": "us-east-1",
"detail": {
"taskId": "uuid",
"detailStatus": "VoiceToneAnalysisSuccessful",
"voiceToneAnalysisDetails": {
"currentAverageVoiceTone": {
"startTime": "2022-08-26T17:55:15.563Z",
"endTime": "2022-08-26T17:55:45.720Z",
"voiceToneLabel": "neutral",
"voiceToneScore": {
"neutral": "0.83",
"positive": "0.13",
"negative": "0.04"
}
},
"overallAverageVoiceTone": {
"startTime": "2022-08-26T16:23:13.344Z",
"endTime": "2022-08-26T17:55:45.720Z",
"voiceToneLabel": "positive",
"voiceToneScore": {
"neutral": "0.25",
"positive": "0.65",
"negative": "0.1"
}
}
},
"isCaller": true,
"transactionId": "daaeb6bf-2fe2-4e51-984e-d0fbf2f09436",
"voiceConnectorId": "fuiopl1fsv9caobmqf2vy7"
},
"version": "0",
"id": "Id-f928dfe3-f44b-4965-8a17-612f9fb92d59"
}
```
# Kuota layanan analitik panggilan untuk Amazon Chime SDK
Tabel di bagian ini mencantumkan kuota layanan untuk analitik panggilan Amazon Chime SDK.
Untuk informasi lebih lanjut tentang Wilayah analitik panggilan, lihat[Wilayah AWS yang tersedia untuk Amazon Chime SDK](sdk-available-regions.md), sebelumnya dalam panduan ini.
Amazon Chime SDK call analytics dan voice analytics memiliki kuota layanan berikut.
| Sumber daya | Batas default | Dapat Disesuaikan |
| --- | --- | --- |
| Konfigurasi Pipa Wawasan Media per wilayah | 100 | Ya |
| Saluran Pipa Wawasan Media Aktif per wilayah | 20 | Ya |
| Domain profil suara per wilayah | 3 | Ya |
| Profil suara per domain profil suara | 20 | Ya |
| Tugas pencarian speaker aktif per wilayah | 25 | Ya |
| Tugas analisis nada suara aktif per wilayah | 25 | Ya |
| Panggilan Konektor Suara Aktif dengan analitik suara per wilayah | 25 | Ya |
| Tugas pencarian speaker aktif per panggilan Konektor Suara per ID transaksi | 1 | Tidak |
| Tugas analisis nada suara aktif per panggilan Konektor Suara per ID transaksi | 1 | Tidak |
| Panggilan API bersamaan maksimum per domain profil suara | 1 | Ya |
| Panggilan API bersamaan maksimum per profil suara | 1 | Ya |
| Panggilan API bersamaan maksimum per tugas pencarian speaker | 1 | Ya |
| Panggilan API bersamaan maksimum per tugas analisis nada suara | 1 | Ya |
*Untuk informasi selengkapnya tentang tarif API dan kuota, lihat [titik akhir dan kuota Amazon Chime SDK di Referensi Umum](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html).AWS *
**catatan**
Jika Anda melebihi kuota untuk Wilayah mana pun, Anda menerima pengecualian **Batas Sumber Daya Terlampaui**. Anda dapat menggunakan halaman **Service Quotas** di AWS konsol untuk meminta kenaikan, atau Anda dapat menghubungi perwakilan [dukungan pelanggan](https://docs.aws.amazon.com/awssupport/latest/user/getting-started.html) Anda.
Beberapa analitik panggilan APIs membuat sumber daya dan permintaan API untuk AWS layanan lain. Jumlah tambahan tersebut terhadap kuota akun Anda. Jika Anda meminta kuota atau transactions-per-second peningkatan dari analitik panggilan, Anda juga harus meminta kenaikan untuk AWS layanan lain tersebut. Jika tidak, permintaan Anda mungkin dibatasi dan gagal.