Utilisation Amazon EventBridge avec Amazon Transcribe

Avec Amazon EventBridge, vous pouvez répondre aux changements d'état de vos Amazon Transcribe tâches en déclenchant des événements dans d'autres tâches Services AWS. Lorsqu'une tâche de transcription change d'état, envoie EventBridge automatiquement un événement vers un flux d'événements. Vous pouvez créer des règles qui définissent les événements que vous souhaitez surveiller dans le flux d’événements et l’action que EventBridge doit prendre lorsque ces événements se produisent. Par exemple, le routage de l’événement vers un autre service (ou une autre cible) qui peut alors effectuer une action. Vous pouvez, par exemple, configurer une règle pour acheminer un événement vers une AWS Lambda fonction lorsqu'une tâche de transcription est terminée avec succès. Pour définir des règles EventBridge, reportez-vous aux sections suivantes.

Vous pouvez recevoir des notifications relatives à des événements via plusieurs canaux, notamment des e-mails, des notifications de chat AWS Chatbot ou des notifications push AWS Console Mobile Application. Vous pouvez également consulter les notifications dans le Centre de notifications de la console. Si vous souhaitez configurer des notifications, vous pouvez utiliser Notifications des utilisateurs AWS. Notifications des utilisateurs AWS prend en charge l'agrégation, ce qui peut réduire le nombre de notifications que vous recevez lors d'événements spécifiques.

Définition des EventBridge règles

Pour définir EventBridge des règles, utilisez le AWS Management Console. Lorsque vous définissez une règle, utilisez Amazon Transcribe comme nom de service. Pour un exemple de création d'une EventBridge règle, consultez la section Amazon EventBridge règles.

Avant utilisation EventBridge, prenez note des définitions suivantes :

• Événement – Un événement indique un changement d’état de l’une de vos tâches de transcription. Par exemple, lorsque l’état TranscriptionJobStatus d’une tâche passe de IN_PROGRESS à COMPLETED.

• Cible – Une cible est un autre Service AWS qui traite un événement. Par exemple, AWS Lambda ou Amazon Simple Notification Service (Amazon SNS). Les cibles reçoivent les événements au format JSON.

• Règle : une règle fait correspondre les événements entrants que vous EventBridge souhaitez surveiller et les achemine vers une ou plusieurs cibles à des fins de traitement. Si une règle achemine un événement vers plusieurs cibles, toutes les cibles traitent l’événement en parallèle. Une règle peut personnaliser le fichier JSON envoyé à la cible.

Amazon EventBridge les événements sont émis dans la mesure du possible. Pour plus d'informations sur la création et la gestion d'événements dans EventBridge, consultez la section Amazon EventBridge événements du Guide de Amazon EventBridge l'utilisateur.

Voici un exemple de EventBridge règle initiée lorsque Amazon Transcribe le statut d'une tâche de transcription devient COMPLETED ouFAILED.

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

La règle contient les champs suivants :

• source – La source de l’événement. Car Amazon Transcribe c'est toujours le casaws.transcribe.

• detail-type – Un identifiant pour les détails de l’événement. Pour Amazon Transcribe, c’est toujours Transcribe Job State Change.

• detail – Le nouvel état de la tâche de transcription. Dans cet exemple, la règle déclenche un événement lorsque l’état de la tâche devient COMPLETED ou FAILED.

Amazon Transcribe événements

Amazon EventBridge enregistre plusieurs Amazon Transcribe événements :

• Événements de tâche de transcription

• Événements d’identification des langues

• Événements Call Analytics

• Événements après appel Call Analytics

• Événements de vocabulaire

Ces événements contiennent tous les champs partagés suivants :

• version : la version des données de l’événement. Cette valeur est toujours 0.

• id: identifiant unique généré par EventBridge l'événement.

• detail-type : un identifiant pour les détails de l’événement. Par exemple, Transcribe Job State Change.

• source : la source de l’événement. Car Amazon Transcribe c'est toujours le casaws.transcribe.

• account: Compte AWS ID du compte qui a généré l'appel d'API.

• time : la date et l’heure de diffusion de l’événement.

• region: L' Région AWS endroit dans lequel la demande est faite.

• resources : les ressources utilisées par l’appel d’API. Car Amazon Transcribe ce champ est toujours vide.

• detail : des détails supplémentaires sur l’événement.

  • FailureReason : ce champ est présent si l’état ou le statut passe à FAILED et décrit la raison de cet état ou de ce statut FAILED.

  • Chaque type d’événement comporte des champs uniques supplémentaires qui sont affichés sous detail. Ces champs uniques sont définis dans les sections suivantes après chaque exemple d’événement.

Événements de tâche de transcription

Lorsque l'état d'une tâche passe IN_PROGRESS de COMPLETED ouFAILED, cela Amazon Transcribe génère un événement. Pour identifier la tâche qui a changé d’état et déclencher l’événement dans votre cible, utilisez le champ TranscriptionJobName de l’événement. Un Amazon Transcribe événement contient les informations suivantes. Un champ FailureReason est ajouté sous detail si le statut de votre tâche de transcription est FAILED.

Notez que cet événement s’applique uniquement à l’opération de l’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 : nom unique que vous avez choisi pour votre tâche de transcription.

• TranscriptionJobStatus  : statut de la tâche de transcription. La valeur peut être COMPLETED ou FAILED.

Événements d’identification des langues

Quand vous activez l’identification automatique des langues, Amazon Transcribe génère un événement lorsque l’état d’identification des langues est COMPLETED ouFAILED. Pour identifier la tâche qui a changé d’état et déclencher l’événement dans votre cible, utilisez le champ JobName de l’événement. Un événement Amazon Transcribe contient les informations suivantes : Un champ FailureReason est ajouté sous detail si votre statut d’identification des langues est FAILED.

Notez que cet événement s’applique uniquement à l’opération de l’API StartTranscriptionJob lorsque le paramètre LanguageIdSettings est inclus.

{
    "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 : pour les tâches de transcription, cette valeur doit être TranscriptionJob.

• JobName : nom unique de votre tâche de transcription.

• LanguageIdentificationStatus : statut de l’identification des langues dans une tâche de transcription. La valeur peut être COMPLETED ou FAILED.

Événements Call Analytics

Lorsque l’état d’une tâche Call Analytics passe de IN_PROGRESS à COMPLETED ou FAILED, Amazon Transcribe génère un événement. Pour identifier la tâche Call Analytics qui a changé d’état et déclencher l’événement dans votre cible, utilisez le champ JobName de l’événement. Un événement Amazon Transcribe contient les informations suivantes : Un champ FailureReason est ajouté sous detail si le statut de votre tâche Call Analytics est FAILED.

Notez que cet événement s’applique uniquement à l’opération de l’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 : nom unique de votre tâche de transcription Call Analytics.

• JobStatus : statut de votre tâche de transcription Call Analytics. Il peut correspondre à COMPLETED ou FAILED.

• AnalyticsJobDetails: les détails de votre tâche de transcription Call Analytics, y compris les informations sur les fonctionnalités d'analyse ignorées.

Événements après appel Call Analytics

Lorsque l’état d’une transcription d’analyse après appel passe de IN_PROGRESS à COMPLETED ou FAILED, Amazon Transcribe génère un événement. Pour identifier la tâche après appel Call Analytics qui a changé d’état et déclencher l’événement dans votre cible, utilisez le champ StreamingSessionId de l’événement.

Notez que cet événement s’applique uniquement à l’opération de l’API StartCallAnalyticsStreamTranscription lorsque le paramètre PostCallAnalyticsSettings est inclus.

Un événement COMPLETED contient les informations suivantes :

{
    "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 événement FAILED contient les informations suivantes :

{
    "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 : numéro d’identification attribué à votre demande de transcription Call Analytics en temps réel.

• PostCallStatus : statut de votre transcription Call Analytics après appel. Il peut correspondre à COMPLETED ou FAILED.

• Transcript : URI de vos transcriptions expurgées et non expurgées.

• Media : URI de vos fichiers audio expurgés et non expurgés.

Événements de vocabulaire

Lorsque l'état d'un vocabulaire personnalisé passe PENDING de READY ouFAILED, cela Amazon Transcribe génère un événement. Pour identifier le vocabulaire personnalisé qui a changé d’état et déclencher l’événement dans votre cible, utilisez le champ VocabularyName de l’événement. Un Amazon Transcribe événement contient les informations suivantes. Un champ FailureReason est ajouté sous detail si l’état de votre vocabulaire personnalisé estFAILED.

Notez que cet événement s’applique uniquement à l’opération de l’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 : nom unique de votre vocabulaire personnalisé.

• VocabularyState : état de traitement de votre vocabulaire personnalisé. La valeur peut être READY ou FAILED.