Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # 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](#defining-rules), reportez-vous aux sections suivantes. Vous pouvez recevoir des notifications d'événements via plusieurs canaux, notamment par e-mail, [Amazon Q Developer dans les applications de chat](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html), les notifications par chat ou les notifications [AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html)push. Vous pouvez également consulter les notifications dans le [Centre de notifications de la console](https://console.aws.amazon.com/notifications/). Si vous souhaitez configurer des notifications, vous pouvez utiliser [Notifications des utilisateurs AWS](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html). 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](https://console.aws.amazon.com/events). 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html). 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) 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` ou`FAILED`. ``` { "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 cas`aws.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](#job-event) + [Événements d’identification des langues](#lang-id-event) + [Événements Call Analytics](#analytics-event) + [Événements après appel Call Analytics](#analytics-stream-event) + [Événements de vocabulaire](#vocab-event) 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 cas`aws.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` ou`FAILED`, 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 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html). ``` { "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](lang-id.md), Amazon Transcribe génère un événement lorsque l’état d’identification des langues est `COMPLETED` ou`FAILED`. 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 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) lorsque le paramètre [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html) 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](call-analytics.md) 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 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html). ``` { "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` : 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`. + `FailureReason`: Ce champ n'est présent que lorsque `JobStatus` c'est `FAILED` le cas et décrit la raison de l'échec. + `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](tca-post-call.md) 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 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html) lorsque le paramètre [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html) 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://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" } } } ``` 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. ### AWS HealthScribe événements d'analyse post-stream Lorsqu'un état change pour une opération d'analyse AWS HealthScribe post-stream, telle que le [ClinicalNoteGenerationResult](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_ClinicalNoteGenerationResult.html)passage de `IN_PROGRESS` à`COMPLETED`, AWS HealthScribe génère un événement contenant les informations suivantes : ``` { "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": , "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": , "FailureReason": } } } ``` + `UpdateType`: type d'opération d'analyse post-stream qui a généré l'événement. Le contenu de l'objet obtenu varie en fonction du`UpdateType`. + `SessionId`: le numéro d'identification de votre AWS HealthScribe stream. Utilisez cet identifiant pour identifier la session de streaming d'origine, puis recherchez les analyses post-diffusion qui ont généré l'événement. + `Status`: État de l'opération d'analyse post-stream. Cette valeur peut être `IN_PROGRESS`, `COMPLETED` ou `FAILED`. + `ClinicalNoteOutputLocation`: URI du compartiment Amazon S3 de sortie pour le`ClinicalNoteGenerationResult`. + `TranscriptOutputLocation`: URI de votre transcription. ### Événements de vocabulaire Lorsque l'état d'un [vocabulaire personnalisé](custom-vocabulary.md) passe `PENDING` de `READY` ou`FAILED`, 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é est`FAILED`. **Note** Cet événement s'applique uniquement au fonctionnement de l'[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)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` : nom unique de votre vocabulaire personnalisé. + `VocabularyState` : état de traitement de votre vocabulaire personnalisé. La valeur peut être `READY` ou `FAILED`.