

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Contoh alur kerja analisis nada suara untuk Amazon Chime SDK
<a name="va-tone-flow"></a>

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