Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # 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 complete 2010-12-16T23:41:07Z sip:alice@atlanta.com structure! structure ab30317f1a784dc48ff824d0d3715d86; remote=47755a9de7794ba387653f2099600ef2 7+OTCyoxTmqmqyA/1weDAg== FOO! bar Alice FOO! bar Bob FOO! bar 2010-12-16T23:41:07Z 2010-12-16T23:41:07Z 2010-12-16T23:41:07Z i1Pz3to5hGk8fuXl+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 partial 8zc6e0lYTlWIINA6GR+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 partial i1Pz3to5hGk8fuXl+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.