での Amazon EventBridge の使用Amazon Transcribe - Amazon Transcribe
EventBridge ルールの定義Amazon Transcribe のイベント

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

での Amazon EventBridge の使用Amazon Transcribe

Amazon EventBridge を使用すると、他の AWS のサービス でイベントを開始させることで Amazon Transcribe ジョブの状態の変化に対応できます。書き起こしジョブの状態が変わると、EventBridge は自動的にイベントをイベントストリームに送信します。イベントストリーム内でモニタリングするイベントと、それらのイベントが発生したときに EventBridge によって実行されるアクションを定義するルールを作成します。例えば、イベントを別のサービス (ターゲット) にルーティングし、そこからアクションが実行されるようにできます。この場合、文字起こしジョブが正常に完了したときにイベントを AWS Lambda 関数にルーティングするように、ルールを設定できます。EventBridge ルールを定義するには、以下のセクションを参照してください。

イベントの通知は、Eメール、チャットアプリケーション内の Amazon Q Developerのチャット通知、AWS Console Mobile Applicationのプッシュ通知などの複数のチャネルで受け取ることができます。「コンソール通知センター」で通知を確認することもできます。通知を設定する場合は、AWS User Notifications を使用できます。AWS User Notifications は、集約をサポートしているため、特定のイベント中に受け取る通知の数を減らすことができます。

EventBridge ルールの定義

EventBridge ルールを定義するには、 AWS マネジメントコンソール を使用します。ルールを定義するときは、サービス名として Amazon Transcribe を使用します。EventBridge ルールの作成方法の例については、「Amazon EventBridge ルール」を参照してください。

EventBridge を使用する前に、次の定義に注意してください。

  • イベント - イベントは、文字起こしジョブのいずれかの状態の変化を示します。例えば、ジョブの TranscriptionJobStatus が IN_PROGRESS から COMPLETED に変わります。

  • ターゲット - ターゲットは、イベントを処理する別の AWS のサービス です。たとえば、AWS Lambda や Amazon Simple Notification Service (Amazon SNS) です。ターゲットは、JSON 形式のイベントを受け取ります。

  • ルール - ルールに一致するイベントは EventBridge のモニタリング対象であり、処理のために 1 つまたは複数のターゲットにルーティングされます。ルールによってイベントが複数のターゲットにルーティングされた場合、すべてのターゲットではそのイベントが並行して処理されます。ルールでは、ターゲットに送信される JSON をカスタマイズできます。

Amazon EventBridge イベントは、ベストエフォートベースで出力されます。EventBridge でのイベントの作成と管理について詳しくは、Amazon EventBridge ユーザーガイドの「Amazon EventBridge イベント」を参照してください。

以下は、文字起こしジョブのステータスが COMPLETED または FAILED に変わったときに開始される、Amazon Transcribe の EventBridge ルールの例です。

{
    "source": [
        "aws.transcribe"
    ],
    "detail-type": [
        "Transcribe Job State Change"
    ],
    "detail": {
        "TranscriptionJobStatus": [
            "COMPLETED",
            "FAILED"
        ]
    }
}

ルールには以下のフィールドがあります。

  • source - イベントのソース。Amazon Transcribe の場合、これは常に aws.transcribe です。

  • detail-type - イベントの詳細の識別子。Amazon Transcribe の場合、これは常に Transcribe Job State Change です。

  • detail - 文字起こしジョブの新しいステータス。この例のルールでは、ジョブのステータスが COMPLETED または FAILED に変わったときにイベントが開始されます。

Amazon Transcribe のイベント

Amazon EventBridge は複数の Amazon Transcribe イベントを記録します。

これらのイベントにはすべて、以下の共有フィールドが含まれます。

  • version: イベントデータのバージョン。この値は常に 0 です。

  • id: イベントに対して EventBridge によって生成された固有 ID。

  • detail-type: イベントの詳細の識別子。例えば、Transcribe Job State Change。

  • source: イベントのソース。Amazon Transcribe の場合、これは常に aws.transcribe です。

  • account: API コールを生成したアカウントの AWS アカウント ID。

  • time: イベントが配信された日時。

  • region: リクエストが行われたAWS リージョン。

  • resources: API コールによって使用されたリソース。Amazon Transcribe の場合、このフィールドは常に空です。

  • detail: イベントに関するその他の詳細

    • FailureReason: このフィールドは、状態またはステータスが FAILED に変化した場合に表示され、FAILED の状態またはステータスになった理由が説明されます。

    • 各イベントタイプには、detail の下に表示される追加の固有のフィールドがあります。これらの固有のフィールドは、各イベント例の後に続く以下のセクションで定義されています。

文字起こしジョブイベント

ジョブの状態が IN_PROGRESS から COMPLETED または FAILED に変化すると、Amazon Transcribe はイベントを生成します。ターゲットの状態を変更してイベントを開始させたジョブを特定するには、イベントの TranscriptionJobName フィールドを使用します。Amazon Transcribe イベントには、以下の情報が含まれています。文字起こしジョブのステータスが FAILED の場合、detail の下に FailureReason フィールドが追加されます。

このイベントは StartTranscriptionJob 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: 文字起こしジョブに選択した固有の名前。

  • TranscriptionJobStatus : 文字起こしのジョブのステータス。これは、COMPLETED または FAILED です。

言語識別イベント

自動言語識別を有効にすると、Amazon Transcribe は、言語識別の状態が COMPLETED または FAILED の場合にイベントを生成します。ターゲットの状態を変更してイベントを開始させたジョブを特定するには、イベントの JobName フィールドを使用します。Amazon Transcribe イベントには、以下の情報が含まれています。言語識別ステータスが FAILED の場合、detail の下に FailureReason フィールドが追加されます。

このイベントは、LanguageIdSettings パラメータが含まれている場合の StartTranscriptionJob API オペレーションにのみ適用されることに注意してください。

{
    "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: 文字起こしジョブの場合、この値は TranscriptionJob でなければなりません。

  • JobName: 文字起こしジョブの固有の名前。

  • LanguageIdentificationStatus: 文字起こしジョブにおける言語識別のステータス。これは、COMPLETED または FAILED です。

コール分析イベント

コール分析ジョブの状態が IN_PROGRESS から COMPLETED または FAILED に変化すると、Amazon Transcribe はイベントを生成します。ターゲットで状態を変更してイベントを開始させたコール分析ジョブを特定するには、イベントの JobName フィールドを使用します。Amazon Transcribe イベントには、以下の情報が含まれています。コール分析ジョブのステータスが FAILED の場合、detail の下に FailureReason フィールドが追加されます。

このイベントは StartCallAnalyticsJob 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: コール分析文字起こしジョブの固有の名前。

  • JobStatus: コール分析文字起こしジョブのステータス。COMPLETED または FAILED のいずれかとなります。

  • FailureReason: このフィールドは JobStatus が FAILED の場合にのみ存在し、失敗の理由を示します。

  • AnalyticsJobDetails: スキップされた分析機能に関する情報を含む、コール分析文字起こしジョブの詳細。

コール分析通話後のイベント

通話後分析文字起こしが IN_PROGRESS から COMPLETED または FAILED の状態に変化すると、Amazon Transcribe はイベントを生成します。ターゲットで状態を変更してイベントを開始させたコール分析通話後ジョブを特定するには、イベントの StreamingSessionId フィールドを使用します。

このイベントは、PostCallAnalyticsSettings パラメータが含まれている場合の StartCallAnalyticsStreamTranscription API オペレーションにのみ適用されることに注意してください。

COMPLETED イベントには、以下の情報が含まれています。

{
    "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"
        }
    }
}

FAILED イベントには、以下の情報が含まれています。

{
    "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: リアルタイムコール分析文字起こしリクエストに割り当てられる識別番号。

  • PostCallStatus: 通話後コール分析文字起こしジョブのステータス。COMPLETED または FAILED のいずれかとなります。

  • Transcript: 編集済みおよび未編集のトランスクリプトの URI。

  • Media: 編集済みおよび未編集の音声ファイルの URI。

AWS HealthScribe ストリーム後分析イベント

ClinicalNoteGenerationResult が IN_PROGRESS から COMPLETED に変わるなど、AWS HealthScribe ストリーム後分析オペレーションの状態が変わると、AWS HealthScribe は次の情報を含むイベントを生成します。

{
   "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": <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": <IN_PROGRESS | COMPLETED | FAILED>,
          "FailureReason": <failure_reason>
    }
   }
}

  • UpdateType: イベントを生成したストリーム後分析オペレーションのタイプ。結果オブジェクトの内容は、UpdateType によって異なります。

  • SessionId: AWS HealthScribe ストリームの識別番号。この ID を使用して、元のストリーミングセッションを識別し、イベントを生成したストリーム後分析を検索します。

  • Status: ストリーム後分析オペレーションのステータス。これは、IN_PROGRESS、COMPLETED、または FAILED です。

  • ClinicalNoteOutputLocation: ClinicalNoteGenerationResult の出力 Amazon S3 バケットの URI。

  • TranscriptOutputLocation: トランスクリプトの URI。

語彙イベント

カスタム語彙の状態が PENDING から READY または FAILED に変化すると、Amazon Transcribe はイベントを生成します。ターゲットの状態を変更してイベントを開始させたカスタム語彙を特定するには、イベントの VocabularyName フィールドを使用します。Amazon Transcribe イベントには、以下の情報が含まれています。カスタム語彙の状態が FAILED の場合、detail の下に FailureReason フィールドが追加されます。

注記

このイベントは CreateVocabulary 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: カスタム語彙の固有の名前です。

  • VocabularyState: カスタム語彙の処理状態。これは、READY または FAILED です。