Utilizzo Amazon EventBridge con Amazon Transcribe - Amazon Transcribe
Definizione delle regole EventBridgeAmazon Transcribe eventi

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo Amazon EventBridge con Amazon Transcribe

Con Amazon EventBridge, puoi rispondere ai cambiamenti di stato nei tuoi Amazon Transcribe lavori avviando eventi in altri. AWS services Quando un processo di trascrizione cambia stato, invia EventBridge automaticamente un evento a un flusso di eventi. È possibile creare regole che definiscono gli eventi che si desidera monitorare nel flusso eventi e l'operazione che EventBridge deve eseguire quando tali eventi si verificano. Ad esempio, l'instradamento dell'evento a un altro servizio (o destinazione), che può quindi eseguire un'operazione. È possibile, ad esempio, configurare una regola per indirizzare un evento a una AWS Lambda funzione quando un processo di trascrizione viene completato correttamente. Per definire le regole EventBridge, consulta le seguenti sezioni.

È possibile ricevere notifiche per gli eventi tramite più canali, tra cui e-mail, notifiche chat AWS Chatbot o notifiche push AWS Console Mobile Application. È anche possibile visualizzare le notifiche nel Centro notifiche della console. Se desideri configurare le notifiche, puoi usare. Notifiche all'utente AWS Notifiche all'utente AWS supporta l'aggregazione, che può ridurre il numero di notifiche ricevute durante eventi specifici.

Definizione delle regole EventBridge

Per definire EventBridge le regole, utilizzare il AWS Management Console. Quando si definisce una regola, utilizzare Amazon Transcribe come nome del servizio. Per un esempio di come creare una EventBridge regola, vedi Amazon EventBridge rules.

Prima dell'uso EventBridge, prendete nota delle seguenti definizioni:

  • Evento: un evento indica una modifica dello stato di uno dei processi di trascrizione. Ad esempio, quando il TranscriptionJobStatus di un processo passa da IN_PROGRESS a COMPLETED.

  • Target: un target è un altro AWS service che elabora un evento. Ad esempio, AWS Lambda o Amazon Simple Notification Service (Amazon SNS). Un target riceve eventi in formato JSON.

  • Regola: una regola abbina gli eventi in arrivo che si desidera EventBridge monitorare e li indirizza verso una o più destinazioni per l'elaborazione. Se una regola instrada un evento su più destinazioni, tutte le destinazioni elaborano l'evento in parallelo. Una regola è in grado di personalizzare il JSON inviato al target.

Amazon EventBridge gli eventi vengono emessi con la massima diligenza possibile. Per ulteriori informazioni sulla creazione e la gestione di eventi in EventBridge, consulta Amazon EventBridge gli eventi nella Guida per l'Amazon EventBridge utente.

Di seguito è riportato un esempio di EventBridge regola Amazon Transcribe che viene avviata quando lo stato di un processo di trascrizione cambia in o. COMPLETED FAILED

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

La regola contiene i seguenti campi:

  • source: l'origine dell'evento. Perché questo Amazon Transcribeè sempre. aws.transcribe

  • detail-type: un identificativo dei dettagli dell'evento. Per Amazon Transcribe, è sempre Transcribe Job State Change.

  • detail: il nuovo stato del processo di trascrizione. In questo esempio, la regola avvia un evento quando lo stato del processo passa a COMPLETED o FAILED.

Amazon Transcribe eventi

Amazon EventBridge registra diversi Amazon Transcribe eventi:

Questi eventi contengono tutti i seguenti campi condivisi:

  • version: la versione dei dati dell'evento. Questo valore è sempre 0.

  • id: un identificatore univoco generato da EventBridge per l'evento.

  • detail-type: un identificativo dei dettagli dell'evento. Ad esempio, Transcribe Job State Change.

  • source: l'origine dell'evento. Perché Amazon Transcribe questo è sempreaws.transcribe.

  • account: L' Account AWS ID dell'account che ha generato la chiamata API.

  • time: la data e l'ora di consegna dell'evento.

  • region: Il Regione AWS codice in cui viene effettuata la richiesta.

  • resources: le risorse utilizzate dalla chiamata API. Perché Amazon Transcribe, questo campo è sempre vuoto.

  • detail: dettagli aggiuntivi relativi all'evento.

    • FailureReason: questo campo è presente se lo stato cambia in FAILED e descrive il motivo dello stato FAILED.

    • Ogni tipo di evento ha campi unici aggiuntivi che vengono visualizzati sotto detail. Questi campi unici sono definiti nelle sezioni seguenti dopo ogni esempio di evento.

Eventi del processo di trascrizione

Quando lo stato di un lavoro cambia IN_PROGRESS da COMPLETED oFAILED, Amazon Transcribe genera un evento. Per identificare il processo che ha modificato lo stato e ha avviato l'evento nel target, usa il campo TranscriptionJobName dell'evento. Un Amazon Transcribe evento contiene le seguenti informazioni. Viene aggiunto un campo FailureReason sotto detail se lo stato del processo di trascrizione è FAILED.

Tieni presente che questo evento si applica solo all'operazione API StartTranscriptionJob.

{
    "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: il nome univoco che hai scelto per il tuo processo di trascrizione.

  • TranscriptionJobStatus : lo stato del processo di trascrizione. Questa può essere un COMPLETED o un FAILED.

Eventi di identificazione della lingua

Quando si abilita l'identificazione automatica della lingua, Amazon Transcribe genera un evento quando lo stato di identificazione della lingua è COMPLETED o FAILED. Per identificare il processo che ha modificato lo stato e ha avviato l'evento nel target, usa il campo JobName dell'evento. Un evento Amazon Transcribe contiene le seguenti informazioni: Viene aggiunto un campo FailureReason sotto detail se lo stato di identificazione della lingua è FAILED.

Tieni presente che questo evento si applica solo all'operazione API StartTranscriptionJob quando il parametro LanguageIdSettings è incluso.

{
    "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: per i processi di trascrizione, questo valore deve essere TranscriptionJob.

  • JobName: il nome univoco del tuo processo di trascrizione.

  • LanguageIdentificationStatus: lo stato dell'identificazione della lingua in un processo di trascrizione. Questa può essere un COMPLETED o un FAILED.

Eventi di analisi delle chiamate

Quando lo stato di un processo di analisi delle chiamate passa da IN_PROGRESS a COMPLETED o FAILED, Amazon Transcribe genera un evento. Per identificare il processo di analisi delle chiamate che ha modificato lo stato e ha avviato l'evento nel target, usa il campo JobName dell'evento. Un evento Amazon Transcribe contiene le seguenti informazioni: Viene aggiunto un campo FailureReason sotto detail se lo stato del processo di analisi delle chiamate è FAILED.

Tieni presente che questo evento si applica solo all'operazione API StartCallAnalyticsJob.

{
    "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: il nome univoco del processo di trascrizione di analisi delle chiamate.

  • JobStatus: lo stato del tuo processo di trascrizione di analisi delle chiamate. Ciò può essere COMPLETED o FAILED.

  • AnalyticsJobDetails: I dettagli del processo di trascrizione di Call Analytics, incluse le informazioni sulle funzionalità di analisi ignorate.

Eventi di analisi post-chiamata

Quando lo stato di un processo di analisi post-chiamata passa da IN_PROGRESS a COMPLETED o FAILED, Amazon Transcribe genera un evento. Per identificare il processo di analisi post-chiamata che ha modificato lo stato e ha avviato l'evento nel target, usa il campo StreamingSessionId dell'evento.

Tieni presente che questo evento si applica solo all'operazione API StartCallAnalyticsStreamTranscription quando il parametro PostCallAnalyticsSettings è incluso.

Un evento COMPLETED contiene le seguenti informazioni:

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

Un evento FAILED contiene le seguenti informazioni:

{
    "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: il numero di identificazione assegnato alla richiesta di trascrizione di analisi delle chiamate in tempo reale.

  • PostCallStatus: lo stato del tuo processo di trascrizione di analisi post-chiamata. Ciò può essere COMPLETED o FAILED.

  • Transcript: l'URI delle trascrizioni redatte e non redatte.

  • Media: l'URI dei file audio redatti e non redatti.

Eventi relativi al vocabolario

Quando lo stato di un vocabolario personalizzato cambia da PENDING o, genera un evento. READY FAILED Amazon Transcribe Per identificare il vocabolario personalizzato che ha modificato lo stato e ha avviato l'evento nel target, usa il campo VocabularyName dell'evento. Un Amazon Transcribe evento contiene le seguenti informazioni. Viene aggiunto un campo FailureReason sotto detail se lo stato del vocabolario personalizzato è FAILED.

Tieni presente che questo evento si applica solo all'operazione API CreateVocabulary.

{
    "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: il nome univoco del vocabolario personalizzato.

  • VocabularyState: lo stato di elaborazione del vocabolario personalizzato. Questa può essere un READY o un FAILED.