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

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

Amazon EventBridge での の使用 Amazon Transcribe

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

イベントの通知は、Eメール、チャットアプリケーション内の Amazon Q Developerのチャット通知、AWS Console Mobile Applicationのプッシュ通知などの複数のチャネルで受け取ることができます。「コンソール通知センター」で通知を確認することもできます。通知を設定する場合は、. AWS User Notifications supports 集計を使用できます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 を照合し、処理のためにターゲットにルーティングします。ルールによってイベントが複数のターゲットにルーティングされた場合、すべてのターゲットではそのイベントが並行して処理されます。ルールでは、ターゲットに送信される JSON をカスタマイズできます。

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

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

{
    "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 に対して によって生成された一意の識別子。

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

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

ジョブの状態が から COMPLETEDまたは IN_PROGRESSに変わると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に変わるなど、a AWS HealthScribe ストリーム後分析オペレーションの状態が変わるとCOMPLETED、 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: の出力 Amazon S3 バケットの URIClinicalNoteGenerationResult。

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

語彙イベント

カスタム語彙の状態が から READYまたは PENDINGに変わると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 です。