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, lihat bagian berikut.

Anda dapat menerima notifikasi untuk peristiwa melalui beberapa saluran, termasuk email, notifikasi obrolan AWS Chatbot, atau notifikasi push AWS Console Mobile Application. Anda juga dapat melihat notifikasi di Pusat Notifikasi Konsol. Jika Anda ingin mengatur notifikasi, Anda dapat menggunakannya Notifikasi Pengguna AWS. Notifikasi Pengguna AWS mendukung agregasi, yang dapat mengurangi jumlah notifikasi yang Anda terima selama acara tertentu.

Mendefinisikan aturan EventBridge

Untuk menentukan EventBridge aturan, gunakan AWS Management Console. Saat Anda menentukan aturan, gunakan Amazon Transcribe sebagai nama layanan. Untuk contoh cara membuat EventBridge aturan, lihat Amazon EventBridge aturan.

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

• 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 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 selaluaws.transcribe.

• detail-type—Pengidentifikasi untuk detail acara. Karena Amazon Transcribe, ini selaluTranscribe Job State Change.

• detail—Status pekerjaan baru dari pekerjaan transkripsi. Dalam contoh ini, aturan memulai peristiwa ketika status pekerjaan berubah menjadi COMPLETED atauFAILED.

Amazon Transcribe acara

Amazon EventBridge mencatat beberapa Amazon Transcribe peristiwa:

• Acara pekerjaan transkripsi

• Acara identifikasi bahasa

• Acara Panggilan Analytics

• Panggilan acara pasca-panggilan Analytics

• Acara kosakata

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 selaluaws.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 berubahFAILED, dan menjelaskan alasan untuk FAILED status atau status.

  • Setiap jenis acara memiliki bidang unik tambahan yang ditampilkan di bawahdetail. Bidang unik ini didefinisikan dalam bagian berikut setelah setiap contoh peristiwa.

Acara pekerjaan transkripsi

Ketika status pekerjaan berubah dari IN_PROGRESS ke COMPLETED atauFAILED, 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. FailureReasonBidang ditambahkan di bawah detail jika status pekerjaan transkripsi Anda. FAILED

Perhatikan bahwa peristiwa ini hanya berlaku untuk operasi StartTranscriptionJobAPI.

{
    "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 atauFAILED.

Acara identifikasi bahasa

Saat Anda mengaktifkan identifikasi bahasa otomatis Amazon Transcribe , buat peristiwa saat status identifikasi bahasa adalah COMPLETED atauFAILED. Untuk mengidentifikasi pekerjaan yang mengubah status dan memulai acara di target Anda, gunakan JobName bidang acara. Sebuah Amazon Transcribe acara berisi informasi berikut. FailureReasonBidang ditambahkan di bawah detail jika status identifikasi bahasa AndaFAILED.

Perhatikan bahwa peristiwa ini hanya berlaku untuk operasi StartTranscriptionJobAPI saat LanguageIdSettingsparameter 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 harusTranscriptionJob.

• JobName: Nama unik dari pekerjaan transkripsi Anda.

• LanguageIdentificationStatus: Status identifikasi bahasa dalam pekerjaan transkripsi. Ini bisa COMPLETED atauFAILED.

Acara Panggilan Analytics

Ketika status pekerjaan Call Analytics berubah dari IN_PROGRESS ke COMPLETED atauFAILED, 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. FailureReasonKolom ditambahkan di bawah detail jika status pekerjaan Call Analytics AndaFAILED.

Perhatikan bahwa peristiwa ini hanya berlaku untuk operasi StartCallAnalyticsJobAPI.

{
    "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"),
        "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 atauFAILED.

• AnalyticsJobDetails: Detail pekerjaan transkripsi Call Analytics Anda, termasuk informasi tentang fitur analitik yang dilewati.

Panggilan acara pasca-panggilan Analytics

Saat transkripsi analitik pasca-panggilan mengubah status dari IN_PROGRESS ke COMPLETED atauFAILED, 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 StartCallAnalyticsStreamTranscriptionAPI saat PostCallAnalyticsSettingsparameter 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://DOC-EXAMPLE-BUCKET/my-output-files/my-redacted-file.JSON",
            "TranscriptFileUri": "s3://DOC-EXAMPLE-BUCKET/my-output-files/my-file.JSON"
        },
        "Media": {
            "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/my-output-files/my-redacted-file.WAV",
            "RedactedMediaFileUri": "s3://DOC-EXAMPLE-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 atauFAILED.

• Transcript: URI transkrip Anda yang disunting dan tidak disunting.

• Media: URI file audio Anda yang disunting dan tidak disunting.

Acara kosakata

Ketika status kosakata kustom berubah dari PENDING ke READY atauFAILED, 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. FailureReasonBidang ditambahkan di bawah detail jika status kosakata kustom Anda. FAILED

Perhatikan bahwa peristiwa ini hanya berlaku untuk operasi CreateVocabularyAPI.

{
    "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 khusus Anda. Ini bisa READY atauFAILED.