Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan Amazon EventBridge dengan Amazon Transcribe
Dengan Amazon EventBridge, Anda dapat menanggapi perubahan status dalam Amazon Transcribe pekerjaan Anda dengan memulai acara di tempat lain Layanan AWS. Saat pekerjaan transkripsi berubah status, EventBridge secara otomatis mengirimkan peristiwa ke aliran peristiwa. Anda membuat aturan yang menentukan peristiwa yang ingin Anda pantau dalam aliran peristiwa dan tindakan yang EventBridge harus diambil ketika peristiwa tersebut terjadi. Misalnya, merutekan acara ke layanan lain (atau target), yang kemudian dapat mengambil tindakan. Anda dapat, misalnya, mengonfigurasi aturan untuk merutekan acara ke AWS Lambda fungsi saat pekerjaan transkripsi berhasil diselesaikan. Untuk menentukan [EventBridge aturan](#defining-rules), lihat bagian berikut.
Anda dapat menerima pemberitahuan untuk acara melalui beberapa saluran, termasuk email, [Pengembang Amazon Q dalam pemberitahuan obrolan aplikasi](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html) obrolan, atau pemberitahuan [AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html)push. Anda juga dapat melihat notifikasi di [Pusat Notifikasi Konsol](https://console.aws.amazon.com/notifications/). Jika Anda ingin mengatur notifikasi, Anda dapat menggunakannya [Notifikasi Pengguna AWS](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html). Notifikasi Pengguna AWS mendukung agregasi, yang dapat mengurangi jumlah notifikasi yang Anda terima selama acara tertentu.
## Mendefinisikan aturan EventBridge
Untuk menentukan EventBridge aturan, gunakan [Konsol Manajemen AWS](https://console.aws.amazon.com/events). Saat Anda menentukan aturan, gunakan Amazon Transcribe sebagai nama layanan. Untuk contoh cara membuat EventBridge aturan, lihat [Amazon EventBridge aturan](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html).
Sebelum menggunakan EventBridge, perhatikan definisi berikut:
+ **Peristiwa** —Sebuah peristiwa menunjukkan perubahan status salah satu pekerjaan transkripsi Anda. Misalnya, ketika `TranscriptionJobStatus` suatu pekerjaan berubah dari `IN_PROGRESS` ke`COMPLETED`.
+ **Target** — Target adalah target lain Layanan AWS yang memproses suatu peristiwa. Misalnya, AWS Lambda atau Amazon Simple Notification Service (Amazon SNS). Target menerima peristiwa dalam format JSON.
+ **Aturan** —Aturan cocok dengan peristiwa masuk yang EventBridge ingin Anda perhatikan dan merutekkannya ke target atau target untuk diproses. Jika aturan merutekan peristiwa ke beberapa target, semua target memproses peristiwa secara paralel. Aturan dapat menyesuaikan JSON yang dikirim ke target.
Amazon EventBridge peristiwa dipancarkan atas dasar upaya terbaik. Untuk informasi selengkapnya tentang membuat dan mengelola acara di EventBridge, lihat [Amazon EventBridge acara](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) di *Panduan Amazon EventBridge Pengguna*.
Berikut ini adalah contoh EventBridge aturan untuk Amazon Transcribe itu dimulai ketika status pekerjaan transkripsi berubah menjadi `COMPLETED` atau. `FAILED`
```
{
"source": [
"aws.transcribe"
],
"detail-type": [
"Transcribe Job State Change"
],
"detail": {
"TranscriptionJobStatus": [
"COMPLETED",
"FAILED"
]
}
}
```
Aturan berisi bidang-bidang berikut:
+ `source`—Sumber acara. Karena Amazon Transcribe, ini selalu`aws.transcribe`.
+ `detail-type`—Pengidentifikasi untuk detail acara. Karena Amazon Transcribe, ini selalu`Transcribe Job State Change`.
+ `detail`—Status pekerjaan baru dari pekerjaan transkripsi. Dalam contoh ini, aturan memulai peristiwa ketika status pekerjaan berubah menjadi `COMPLETED` atau`FAILED`.
## Amazon Transcribe acara
Amazon EventBridge mencatat beberapa Amazon Transcribe peristiwa:
+ [Acara pekerjaan transkripsi](#job-event)
+ [Acara identifikasi bahasa](#lang-id-event)
+ [Acara Panggilan Analytics](#analytics-event)
+ [Panggilan acara pasca-panggilan Analytics](#analytics-stream-event)
+ [Acara kosakata](#vocab-event)
Semua peristiwa ini berisi bidang bersama berikut:
+ `version`: Versi data acara. Nilai ini selalu `0`.
+ `id`: Pengidentifikasi unik yang dihasilkan oleh EventBridge untuk acara tersebut.
+ `detail-type`: Pengenal untuk rincian acara. Misalnya, `Transcribe Job State Change`.
+ `source`: Sumber acara. Untuk Amazon Transcribe ini selalu`aws.transcribe`.
+ `account`: Akun AWS ID akun yang menghasilkan panggilan API.
+ `time`: Tanggal dan waktu acara disampaikan.
+ `region`: Wilayah AWS Di mana permintaan dibuat.
+ `resources`: Sumber daya yang digunakan oleh panggilan API. Karena Amazon Transcribe, bidang ini selalu kosong.
+ `detail`: Detail tambahan tentang acara tersebut.
+ `FailureReason`: Bidang ini hadir jika status atau status berubah`FAILED`, dan menjelaskan alasan untuk `FAILED` status atau status.
+ Setiap jenis acara memiliki bidang unik tambahan yang ditampilkan di bawah`detail`. Bidang unik ini didefinisikan dalam bagian berikut setelah setiap contoh peristiwa.
### Acara pekerjaan transkripsi
Ketika status pekerjaan berubah dari `IN_PROGRESS` ke `COMPLETED` atau`FAILED`, Amazon Transcribe menghasilkan peristiwa. Untuk mengidentifikasi pekerjaan yang mengubah status dan memulai acara di target Anda, gunakan `TranscriptionJobName` bidang acara. Sebuah Amazon Transcribe acara berisi informasi berikut. `FailureReason`Bidang ditambahkan di bawah `detail` jika status pekerjaan transkripsi Anda. `FAILED`
Perhatikan bahwa peristiwa ini hanya berlaku untuk operasi [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html)API.
```
{
"version": "0",
"id": "event ID",
"detail-type":"Transcribe Job State Change",
"source": "aws.transcribe",
"account": "111122223333",
"time": "timestamp",
"region": "us-west-2",
"resources": [],
"detail": {
"TranscriptionJobName": "my-first-transcription-job",
"TranscriptionJobStatus": "COMPLETED" (or "FAILED")
}
}
```
+ `TranscriptionJobName`: Nama unik yang Anda pilih untuk pekerjaan transkripsi Anda.
+ `TranscriptionJobStatus `: Status pekerjaan transkripsi. Ini bisa `COMPLETED` atau`FAILED`.
### Acara identifikasi bahasa
Saat Anda mengaktifkan [identifikasi bahasa otomatis](lang-id.md) Amazon Transcribe , buat peristiwa saat status identifikasi bahasa adalah `COMPLETED` atau`FAILED`. Untuk mengidentifikasi pekerjaan yang mengubah status dan memulai acara di target Anda, gunakan `JobName` bidang acara. Sebuah Amazon Transcribe acara berisi informasi berikut. `FailureReason`Bidang ditambahkan di bawah `detail` jika status identifikasi bahasa Anda`FAILED`.
Perhatikan bahwa peristiwa ini hanya berlaku untuk operasi [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html)API saat [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html)parameter disertakan.
```
{
"version": "0",
"id": "event ID",
"detail-type": "Language Identification State Change",
"source": "aws.transcribe",
"account": "111122223333",
"time": "timestamp",
"region": "us-west-2",
"resources": [],
"detail": {
"JobType": "TranscriptionJob",
"JobName": "my-first-lang-id-job",
"LanguageIdentificationStatus": "COMPLETED" (or "FAILED")
}
}
```
+ `JobType`: Untuk pekerjaan transkripsi, nilai ini harus`TranscriptionJob`.
+ `JobName`: Nama unik dari pekerjaan transkripsi Anda.
+ `LanguageIdentificationStatus`: Status identifikasi bahasa dalam pekerjaan transkripsi. Ini bisa `COMPLETED` atau`FAILED`.
### Acara Panggilan Analytics
Ketika status pekerjaan [Call Analytics](call-analytics.md) berubah dari `IN_PROGRESS` ke `COMPLETED` atau`FAILED`, Amazon Transcribe menghasilkan peristiwa. Untuk mengidentifikasi pekerjaan Analytics Panggilan yang mengubah status dan memulai acara di target Anda, gunakan `JobName` bidang acara. Sebuah Amazon Transcribe acara berisi informasi berikut. `FailureReason`Kolom ditambahkan di bawah `detail` jika status pekerjaan Call Analytics Anda`FAILED`.
Perhatikan bahwa peristiwa ini hanya berlaku untuk operasi [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html)API.
```
{
"version": "0",
"id": "event ID",
"detail-type": "Call Analytics Job State Change",
"source": "aws.transcribe",
"account": "111122223333",
"time": "timestamp",
"region": "us-west-2",
"resources": [],
"detail": {
"JobName": "my-first-analytics-job",
"JobStatus": "COMPLETED" (or "FAILED"),
"FailureReason": "failure reason", // only present when JobStatus is FAILED
"AnalyticsJobDetails": { // only when you enable optional features such as Generative Call Summarization
"Skipped": []
}
}
}
```
+ `JobName`: Nama unik dari pekerjaan transkripsi Call Analytics Anda.
+ `JobStatus`: Status pekerjaan transkripsi Call Analytics Anda. Ini bisa salah satu `COMPLETED` atau`FAILED`.
+ `FailureReason`: Bidang ini hadir hanya ketika `JobStatus` ada`FAILED`, dan menjelaskan alasan kegagalan.
+ `AnalyticsJobDetails`: Detail pekerjaan transkripsi Call Analytics Anda, termasuk informasi tentang fitur analitik yang dilewati.
### Panggilan acara pasca-panggilan Analytics
Saat transkripsi [analitik pasca-panggilan](tca-post-call.md) mengubah status dari `IN_PROGRESS` ke `COMPLETED` atau`FAILED`, Amazon Transcribe menghasilkan peristiwa. Untuk mengidentifikasi pekerjaan pasca-panggilan Analytics Panggilan yang mengubah status dan memulai acara di target Anda, gunakan bidang acara. `StreamingSessionId`
Perhatikan bahwa peristiwa ini hanya berlaku untuk operasi [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html)API saat [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html)parameter disertakan.
Sebuah `COMPLETED` acara berisi informasi berikut:
```
{
"version": "0",
"id": "event ID",
"detail-type": "Call Analytics Post Call Job State Change",
"source": "aws.transcribe",
"account": "111122223333",
"time": "timestamp",
"region": "us-west-2",
"resources": [],
"detail": {
"StreamingSessionId": "session-id",
"PostCallStatus": "COMPLETED",
"Transcript": {
"RedactedTranscriptFileUri": "s3://amzn-s3-demo-bucket/my-output-files/my-redacted-file.JSON",
"TranscriptFileUri": "s3://amzn-s3-demo-bucket/my-output-files/my-file.JSON"
},
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/my-output-files/my-redacted-file.WAV",
"RedactedMediaFileUri": "s3://amzn-s3-demo-bucket/my-output-files/my-redacted-file.WAV"
}
}
}
```
Sebuah `FAILED` acara berisi informasi berikut:
```
{
"version": "0",
"id": "event ID",
"detail-type": "Call Analytics Post Call Job State Change",
"source": "aws.transcribe",
"account": "111122223333",
"time": "timestamp",
"region": "us-west-2",
"resources": [],
"detail": {
"StreamingSessionId": "session-id",
"PostCallStatus": "FAILED"
}
}
```
+ `StreamingSessionId`: Nomor identifikasi yang ditetapkan untuk permintaan transkripsi Call Analytics real-time Anda.
+ `PostCallStatus`: Status transkripsi Analytics Panggilan pasca-panggilan Anda. Ini bisa salah satu `COMPLETED` atau`FAILED`.
+ `Transcript`: URI transkrip Anda yang disunting dan tidak disunting.
+ `Media`: URI file audio Anda yang disunting dan tidak disunting.
### AWS HealthScribe acara analitik pasca aliran
Ketika status berubah untuk operasi analitik AWS HealthScribe pasca-aliran, seperti [ClinicalNoteGenerationResult](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_ClinicalNoteGenerationResult.html)perubahan dari `IN_PROGRESS` ke`COMPLETED`, AWS HealthScribe menghasilkan peristiwa dengan informasi berikut:
```
{
"version":"0",
"id":"event ID",
"detail-type":"MedicalScribe Post Stream Analytics Update",
"source":"aws.transcribe",
"account":"111122223333",
"time":"timestamp",
"region":"us-east-1",
"resources":[],
"detail":{
"SessionId": ,
"UpdateType": "ClinicalNoteGenerationResult",
"ClinicalNoteGenerationResult": {
"ClinicalNoteOutputLocation": s3://amzn-s3-demo-bucket/clinical-note-output-files/clinical-notes.JSON,
"TranscriptOutputLocation": s3://amzn-s3-demo-bucket/my-output-files/my-file.JSON,
"Status": ,
"FailureReason":
}
}
}
```
+ `UpdateType`: Jenis operasi analitik pasca-aliran yang menghasilkan acara. Isi objek hasil bervariasi tergantung pada`UpdateType`.
+ `SessionId`: Nomor identifikasi untuk AWS HealthScribe streaming Anda. Gunakan ID ini untuk mengidentifikasi sesi streaming yang berasal dan kemudian temukan analitik pasca-aliran yang menghasilkan acara.
+ `Status`: Status operasi analitik pasca-aliran. Ini dapat berupa `IN_PROGRESS`, `COMPLETED`, atau `FAILED`.
+ `ClinicalNoteOutputLocation`: URI dari bucket Amazon S3 keluaran untuk. `ClinicalNoteGenerationResult`
+ `TranscriptOutputLocation`: URI transkrip Anda.
### Acara kosakata
Ketika status [kosakata kustom](custom-vocabulary.md) berubah dari `PENDING` ke `READY` atau`FAILED`, Amazon Transcribe menghasilkan peristiwa. Untuk mengidentifikasi kosakata khusus yang mengubah status dan memulai acara di target Anda, gunakan bidang acara. `VocabularyName` Sebuah Amazon Transcribe acara berisi informasi berikut. `FailureReason`Bidang ditambahkan di bawah `detail` jika status kosakata kustom Anda. `FAILED`
**catatan**
Peristiwa ini hanya berlaku untuk operasi [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)API.
```
{
"version": "0",
"id": "event ID",
"detail-type": "Vocabulary State Change",
"source": "aws.transcribe",
"account": "111122223333",
"time": "timestamp",
"region": "us-west-2",
"resources": [],
"detail": {
"VocabularyName": "unique-vocabulary-name",
"VocabularyState": "READY" (or "FAILED")
}
}
```
+ `VocabularyName`: Nama unik kosakata kustom Anda.
+ `VocabularyState`: Status pemrosesan kosakata kustom Anda. Ini bisa `READY` atau`FAILED`.