Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memulai transkripsi Analisis Panggilan waktu nyata
Sebelum memulai transkripsi Analisis Panggilan real-time, Anda harus membuat semua [kategori](tca-categories-stream.md) yang Amazon Transcribe ingin Anda cocokkan dalam panggilan Anda.
**catatan**
Transkrip Call Analytics tidak dapat dicocokkan secara surut dengan kategori baru. Hanya kategori yang Anda buat *sebelum* memulai transkripsi Call Analytics yang dapat diterapkan ke output transkripsi tersebut.
Jika Anda telah membuat satu atau beberapa kategori, dan audio Anda cocok dengan semua aturan dalam setidaknya satu kategori Anda, Amazon Transcribe tandai output Anda dengan kategori yang cocok. Jika Anda memilih untuk tidak menggunakan kategori, atau jika audio Anda tidak cocok dengan aturan yang ditentukan dalam kategori Anda, transkrip Anda tidak ditandai.
Untuk menyertakan analitik pasca-panggilan dengan transkripsi Analytics Panggilan real-time Anda, Anda harus menyediakan Amazon S3 bucket dalam permintaan menggunakan parameter. `OutputLocation` Anda juga harus menyertakan a `DataAccessRoleArn` yang memiliki izin menulis ke bucket yang ditentukan. Transkrip terpisah diproduksi dan disimpan dalam bucket yang ditentukan setelah menyelesaikan sesi streaming Call Analytics waktu nyata Anda.
Dengan Analytics Panggilan real-time, Anda juga memiliki opsi untuk membuat peringatan kategori waktu nyata; lihat [Membuat peringatan waktu nyata untuk kecocokan kategori](#tca-create-alert-stream) untuk instruksi.
Untuk memulai transkripsi Analytics Panggilan real-time, Anda dapat menggunakan **Konsol Manajemen AWS**, **HTTP/2**, atau **WebSockets**; lihat contoh berikut:
**penting**
Saat ini, Konsol Manajemen AWS satu-satunya menawarkan demo untuk Analytics Panggilan real-time dengan contoh audio yang dimuat sebelumnya. Jika Anda ingin menggunakan audio Anda sendiri, Anda harus menggunakan API (HTTP/2, WebSockets, atau SDK).
## Konsol Manajemen AWS
Gunakan prosedur berikut untuk memulai permintaan Call Analytics. Panggilan yang cocok dengan semua karakteristik yang ditentukan oleh kategori diberi label dengan kategori tersebut.
**catatan**
Hanya demo yang tersedia di Konsol Manajemen AWS. Untuk memulai transkripsi analitik real-time khusus, Anda harus menggunakan [API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html).
1. Di panel navigasi, di bawah Amazon Transcribe Call Analytics, pilih **Analisis panggilan real-time**.
![\[Amazon Transcribe tangkapan layar konsol: halaman demo 'analisis panggilan streaming'.\]](http://docs.aws.amazon.com/id_id/transcribe/latest/dg/images/analytics-start-stream.png)
1. Untuk **Langkah 1: Tentukan audio input**, pilih file uji demo dari menu tarik-turun.
![\[Amazon Transcribe tangkapan layar konsol: pilihan tarik-turun untuk audio input demo.\]](http://docs.aws.amazon.com/id_id/transcribe/latest/dg/images/analytics-start-stream-settings1.png)
1. Untuk **Langkah 2: Tinjau kategori panggilan**, Anda memiliki opsi untuk meninjau kategori Analisis Panggilan real-time yang sebelumnya Anda buat. Semua kategori Analisis Panggilan real-time diterapkan ke transkripsi Anda.
Memilih **kategori Tampilan** membuka panel baru yang menampilkan kategori Analytics Panggilan real-time Anda yang ada dan menyediakan tautan untuk membuat yang baru.
![\[Amazon Transcribe tangkapan layar konsol: halaman 'kategori analitik panggilan'.\]](http://docs.aws.amazon.com/id_id/transcribe/latest/dg/images/analytics-start-stream-settings2.png)
1. Untuk **Langkah 3: Konfigurasikan input dan output**, Anda memiliki opsi untuk menerapkan pengaturan tambahan.
Memilih **Konfigurasi pengaturan lanjutan** membuka panel baru tempat Anda dapat menentukan pengaturan redaksi konten.
![\[Amazon Transcribe tangkapan layar konsol: panel pengaturan lanjutan, semuanya runtuh.\]](http://docs.aws.amazon.com/id_id/transcribe/latest/dg/images/analytics-start-stream-settings3.png)
Setelah Anda membuat semua pilihan Anda, pilih **Simpan** untuk kembali ke halaman utama.
1. Untuk menerapkan analitik tambahan, Anda dapat beralih di Analytics **Pasca-Panggilan**. Ini memberi Anda analitik yang sama dengan transkripsi analitik pasca-panggilan, termasuk interupsi, kenyaringan, waktu non-bicara, kecepatan bicara, waktu bicara, masalah, item tindakan, dan hasil. Output analitik pasca-panggilan disimpan dalam file terpisah dari transkrip Analytics Panggilan real-time Anda.
![\[Amazon Transcribe tangkapan layar konsol: panel analitik pasca-panggilan, diciutkan.\]](http://docs.aws.amazon.com/id_id/transcribe/latest/dg/images/analytics-start-stream-post-call1.png)
Jika Anda menerapkan analitik pasca-panggilan, Anda harus menentukan tujuan file Amazon S3 keluaran dan IAM peran. Anda dapat memilih untuk mengenkripsi output Anda secara opsional.
![\[Amazon Transcribe tangkapan layar konsol: panel analitik pasca-panggilan, diperluas.\]](http://docs.aws.amazon.com/id_id/transcribe/latest/dg/images/analytics-start-stream-post-call1a.png)
1. Pilih **Mulai streaming**.
## Aliran HTTP/2
Contoh ini membuat permintaan HTTP/2 dengan Call Analytics diaktifkan. Untuk informasi lebih lanjut tentang menggunakan streaming HTTP/2 dengan Amazon Transcribe, lihat. [Menyiapkan aliran HTTP/2](streaming-setting-up.md#streaming-http2) Untuk detail selengkapnya tentang parameter dan header khusus untuk Amazon Transcribe, lihat [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html).
Contoh ini mencakup [analitik pasca-panggilan](tca-post-call.md). Jika Anda tidak ingin analitik pasca-panggilan, hapus `PostCallAnalyticsSettings` bagian dari permintaan.
Perhatikan bahwa peristiwa konfigurasi yang ditampilkan dalam contoh berikut harus diteruskan sebagai peristiwa pertama dalam aliran.
```
POST /stream-transcription HTTP/2
host: transcribestreaming.us-west-2.amazonaws.com
X-Amz-Target: com.amazonaws.transcribe.Transcribe.StartCallAnalyticsStreamTranscription
Content-Type: application/vnd.amazon.eventstream
X-Amz-Content-Sha256: string
X-Amz-Date: 20220208T235959Z
Authorization: AWS4-HMAC-SHA256 Credential=access-key/20220208/us-west-2/transcribe/aws4_request, SignedHeaders=content-type;host;x-amz-content-sha256;x-amz-date;x-amz-target;x-amz-security-token, Signature=string
x-amzn-transcribe-language-code: en-US
x-amzn-transcribe-media-encoding: flac
x-amzn-transcribe-sample-rate: 16000
transfer-encoding: chunked
{
"AudioStream": {
"AudioEvent": {
"AudioChunk": blob
},
"ConfigurationEvent": {
"ChannelDefinitions": [
{
"ChannelId": 0,
"ParticipantRole": "AGENT"
},
{
"ChannelId": 1,
"ParticipantRole": "CUSTOMER"
}
],
"PostCallAnalyticsSettings": {
"OutputLocation": "s3://amzn-s3-demo-bucket/my-output-files/",
"DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole"
}
}
}
}
```
Definisi parameter dapat ditemukan di [Referensi API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html); parameter yang umum untuk semua operasi AWS API tercantum di bagian [Parameter Umum](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html).
## WebSocket aliran
Contoh ini membuat URL presigned yang menggunakan Call Analytics dalam WebSocket aliran. Jeda baris telah ditambahkan untuk keterbacaan. Untuk informasi selengkapnya tentang penggunaan WebSocket stream dengan Amazon Transcribe, lihat[Menyiapkan WebSocket aliran](streaming-setting-up.md#streaming-websocket). Untuk detail lebih lanjut tentang parameter, lihat [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html).
Contoh ini mencakup [analitik pasca-panggilan](tca-post-call.md). Jika Anda tidak ingin analitik pasca-panggilan, hapus `PostCallAnalyticsSettings` bagian dari permintaan.
Perhatikan bahwa peristiwa konfigurasi yang ditampilkan dalam contoh berikut harus diteruskan sebagai peristiwa pertama dalam aliran.
```
GET wss://transcribestreaming.us-west-2.amazonaws.com:8443/call-analytics-stream-transcription-websocket?
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20220208%2Fus-west-2%2Ftranscribe%2Faws4_request
&X-Amz-Date=20220208T235959Z
&X-Amz-Expires=300
&X-Amz-Security-Token=security-token
&X-Amz-Signature=string
&X-Amz-SignedHeaders=content-type%3Bhost%3Bx-amz-date
&language-code=en-US
&media-encoding=flac
&sample-rate=16000
{
"AudioStream": {
"AudioEvent": {
"AudioChunk": blob
},
"ConfigurationEvent": {
"ChannelDefinitions": [
{
"ChannelId": 0,
"ParticipantRole": "AGENT"
},
{
"ChannelId": 1,
"ParticipantRole": "CUSTOMER"
}
],
"PostCallAnalyticsSettings": {
"OutputLocation": "s3://amzn-s3-demo-bucket/my-output-files/",
"DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole"
}
}
}
}
```
Definisi parameter dapat ditemukan di [Referensi API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html); parameter yang umum untuk semua operasi AWS API tercantum di bagian [Parameter Umum](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html).
**Tip**
HTTP/2 di atas dan WebSocket contoh termasuk analitik pasca-panggilan. Jika Anda tidak ingin analitik pasca-panggilan, hapus `PostCallAnalyticsSettings` bagian dari permintaan.
Jika Anda mengaktifkan`PostCallAnalyticsSettings`, Anda harus mengirim acara konfigurasi sebagai acara pertama. Acara konfigurasi Anda mencakup pengaturan untuk `ChannelDenifitions` dan`PostStreamAnalyticsSettings`, seperti yang ditunjukkan pada contoh sebelumnya.
Data biner diteruskan sebagai pesan biner dengan `content-type application/octet-stream` dan peristiwa konfigurasi diteruskan sebagai pesan teks dengan`content-type application/json`.
Untuk informasi selengkapnya, lihat [Menyiapkan transkripsi streaming](streaming-setting-up.md).
## Membuat peringatan waktu nyata untuk kecocokan kategori
Untuk mengatur peringatan waktu nyata, Anda harus terlebih dahulu membuat [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptFilter.html)kategori dengan `REAL_TIME` bendera. Bendera ini memungkinkan kategori Anda diterapkan ke transkripsi Analisis Panggilan real-time.
Untuk petunjuk tentang membuat kategori baru, lihat[Membuat kategori untuk transkripsi waktu nyata](tca-categories-stream.md).
Saat Anda memulai transkripsi Analisis Panggilan real-time, semua kategori yang memiliki `REAL_TIME` tanda secara otomatis diterapkan ke output transkripsi Anda di tingkat segmen. Jika `TranscriptFilterType` kecocokan terjadi, itu muncul di bawah `CategoryEvent` bagian transkrip Anda. Anda kemudian dapat menggunakan parameter ini dan sub-parameternya, `MatchedCategories` dan`MatchedDetails`, untuk mengatur peringatan real-time kustom.
Berikut adalah contoh output transkripsi Call Analytics real-time untuk `CategoryEvent` kecocokan:
```
"CategoryEvent": {
"MatchedCategories": [ "shipping-complaint" ],
"MatchedDetails": {
"my package never arrived" : {
"TimestampRanges": [
{
"BeginOffsetMillis": 19010,
"EndOffsetMillis": 22690
}
]
}
}
},
```
Contoh sebelumnya mewakili kecocokan teks yang tepat dengan pidato "*paket saya tidak pernah tiba*,” yang mewakili aturan dalam kategori 'pengiriman-keluhan'.
Anda dapat mengatur peringatan waktu nyata untuk menyertakan kombinasi parameter yang tercantum. Misalnya, Anda dapat menyetel peringatan agar hanya menyertakan frasa yang cocok (`MatchedDetails`) atau hanya nama kategori (`MatchedCategories`). Atau Anda dapat mengatur peringatan Anda untuk menyertakan semua parameter.
Cara Anda mengatur peringatan waktu nyata tergantung pada antarmuka organisasi dan jenis peringatan yang Anda inginkan. Misalnya, Anda dapat mengatur `CategoryEvent` kecocokan untuk mengirim pemberitahuan pop-up, email, teks, atau peringatan lain yang dapat diterima sistem Anda.