As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Utilizar Amazon EventBridge por Amazon Transcribe Com Amazon EventBridge, você pode responder às mudanças de estado em seus Amazon Transcribe trabalhos iniciando eventos em outros Serviços da AWS. Quando um trabalho de transcrição muda de estado, envia EventBridge automaticamente um evento para um fluxo de eventos. Você pode criar regras que definem os eventos que você deseja monitorar no fluxo de eventos, e a ação que o EventBridge deve executar quando esses eventos ocorrerem. Por exemplo, rotear o evento para outro serviço (ou destino), que pode executar uma ação. Você pode, por exemplo, configurar uma regra para rotear um evento para uma AWS Lambda função quando um trabalho de transcrição for concluído com êxito. Para definir [regras do EventBridge](#defining-rules), consulte as seções a seguir. É possível receber notificações para eventos por meio de diversos canais, incluindo o e-mail, o [Amazon Q Developer em aplicações de chat](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html), notificações por chat ou notificações push do [AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html). Você também pode ver as notificações na [Central de notificações do console](https://console.aws.amazon.com/notifications/). Se você quiser configurar notificações, você pode usar [Notificações de Usuários da AWS](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html). Notificações de Usuários da AWS suporta agregação, o que pode reduzir o número de notificações que você recebe durante eventos específicos. ## Definindo EventBridge regras Para definir EventBridge regras, use [Console de gerenciamento da AWS](https://console.aws.amazon.com/events)o. Ao definir uma regra, use o Amazon Transcribe como o nome do serviço. Para ver um exemplo de como criar uma EventBridge regra, consulte [Amazon EventBridge regras](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html). Antes de usar EventBridge, observe as seguintes definições: + **Evento**: um evento indica uma alteração no estado de um dos trabalhos de transcrição. Por exemplo, quando o `TranscriptionJobStatus` de um trabalho muda de `IN_PROGRESS` para `COMPLETED`. + **Destino**: um destino é outro AWS service (Serviço da AWS) que processa um evento. Por exemplo, AWS Lambda ou Amazon Simple Notification Service (Amazon SNS). Um destino recebe eventos no formato JSON. + **Regra** — Uma regra combina os eventos recebidos que você EventBridge deseja observar e os encaminha para um alvo ou alvos para processamento. Se uma regra rotear um evento para vários destinos, os destinos processarão o evento em paralelo. Uma regra pode personalizar o JSON enviado ao destino. Amazon EventBridge os eventos são emitidos com base no melhor esforço. Para obter mais informações sobre como criar e gerenciar eventos em EventBridge, consulte [Amazon EventBridge eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) no *Guia Amazon EventBridge do usuário*. Veja a seguir um exemplo de uma EventBridge regra Amazon Transcribe que é iniciada quando o status de um trabalho de transcrição muda para `COMPLETED` ou`FAILED`. ``` { "source": [ "aws.transcribe" ], "detail-type": [ "Transcribe Job State Change" ], "detail": { "TranscriptionJobStatus": [ "COMPLETED", "FAILED" ] } } ``` A regra contém os seguintes campos: + `source`: a origem do evento. Pois Amazon Transcribe, isso é sempre`aws.transcribe`. + `detail-type`: um identificador para os detalhes do evento. Para o Amazon Transcribe, isso é sempre `Transcribe Job State Change`. + `detail`: o novo status do trabalho de transcrição. Neste exemplo, a regra inicia um evento quando o status do trabalho muda para `COMPLETED` ou `FAILED`. ## Amazon Transcribe eventos Amazon EventBridge registra vários Amazon Transcribe eventos: + [Eventos de trabalho de transcrição](#job-event) + [Eventos de identificação de idiomas](#lang-id-event) + [Eventos do Call Analytics](#analytics-event) + [Eventos pós-chamada do Call Analytics](#analytics-stream-event) + [Eventos de vocabulário](#vocab-event) Todos esses eventos contêm os seguintes campos compartilhados: + `version`: a versão dos dados do evento. Esse valor é sempre `0`. + `id`: Um identificador exclusivo gerado por EventBridge para o evento. + `detail-type`: um identificador para os detalhes do evento. Por exemplo, .`Transcribe Job State Change` + `source`: a origem do evento. Pois Amazon Transcribe isso é sempre`aws.transcribe`. + `account`: o Conta da AWS ID da conta que gerou a chamada da API. + `time`: a data e a hora em que o evento é entregue. + `region`: O Região da AWS em que a solicitação é feita. + `resources` os recursos usados pela chamada de API. Pois Amazon Transcribe, esse campo está sempre vazio. + `detail`: detalhes adicionais sobre o evento. + `FailureReason`: esse campo estará presente se o estado ou status mudar para `FAILED` e descreve o motivo do estado ou status `FAILED`. + Cada tipo de evento tem outros campos exclusivos que são exibidos em `detail`. Esses campos exclusivos são definidos nas seções a seguir após cada exemplo de evento. ### Eventos de trabalho de transcrição Quando o estado de um trabalho muda de `IN_PROGRESS` para `COMPLETED` ou`FAILED`, Amazon Transcribe gera um evento. Para identificar o trabalho que mudou de estado e iniciar o evento no destino, use o campo `TranscriptionJobName` do evento. Um Amazon Transcribe evento contém as seguintes informações. Um campo `FailureReason` será adicionado em `detail` se o status do trabalho de transcrição for `FAILED`. Observe que esse evento se aplica somente à operação de 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`: o nome exclusivo que você escolheu para o trabalho de transcrição. + `TranscriptionJobStatus ` o status do trabalho de transcrição. Pode ser `COMPLETED` ou `FAILED`. ### Eventos de identificação de idiomas Quando você habilita a [identificação automática de idioma](lang-id.md), o Amazon Transcribe gera um evento quando o estado de identificação do idioma é `COMPLETED` ou `FAILED`. Para identificar o trabalho que mudou de estado e iniciar o evento no destino, use o campo `JobName` do evento. Um evento do Amazon Transcribe contém as seguintes informações. Um campo `FailureReason` será adicionado em `detail` se o status de identificação do idioma for `FAILED`. Observe que esse evento se aplica somente à operação de API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) quando o parâmetro [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html) é incluído. ``` { "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`: para trabalhos de transcrição, esse valor deve ser `TranscriptionJob`. + `JobName`: o nome exclusivo do trabalho de transcrição. + `LanguageIdentificationStatus`: o status da identificação de idioma em um trabalho de transcrição. Pode ser `COMPLETED` ou `FAILED`. ### Eventos do Call Analytics Quando o estado de um trabalho do [Call Analytics](call-analytics.md) muda de `IN_PROGRESS` para `COMPLETED` ou `FAILED`, o Amazon Transcribe gera um evento. Para identificar o trabalho do Call Analytics que mudou de estado e iniciou o evento no destino, use o campo `JobName` do evento. Um evento do Amazon Transcribe contém as seguintes informações. Um campo `FailureReason` será adicionado em `detail` se o status do trabalho do Call Analytics for `FAILED`. Observe que esse evento se aplica somente à operação de 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`: o nome exclusivo do trabalho de transcrição do Call Analytics. + `JobStatus`: o status do trabalho de transcrição do Call Analytics. Ele pode ser `COMPLETED` ou `FAILED`. + `FailureReason`: este campo está presente somente quando `JobStatus` é `FAILED` e descreve o motivo da falha. + `AnalyticsJobDetails`: detalhes da sua tarefa de transcrição do Call Analytics, incluindo informações sobre recursos analíticos ignorados. ### Eventos pós-chamada do Call Analytics Quando uma transcrição da [análise pós-chamada](tca-post-call.md) muda do estado `IN_PROGRESS` para `COMPLETED` ou `FAILED`, o Amazon Transcribe gera um evento. Para identificar o trabalho pós-chamada do Call Analytics que mudou de estado e iniciar o evento no destino, use o campo `StreamingSessionId` do evento. Observe que esse evento se aplica somente à operação de 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) quando o parâmetro [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html) é incluído. Um evento `COMPLETED` contém as seguintes informações: ``` { "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" } } } ``` Um evento `FAILED` contém as seguintes informações: ``` { "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`: o número de identificação atribuído à solicitação de transcrição do Call Analytics em tempo real. + `PostCallStatus`: o status da transcrição do Call Analytics de pós-chamada. Ele pode ser `COMPLETED` ou `FAILED`. + `Transcript`: o URI das transcrições editadas e não editadas. + `Media`: o URI dos arquivos de áudio editados e não editados. ### AWS HealthScribe eventos de análise de pós-transmissão Quando um estado muda para uma operação de análise AWS HealthScribe pós-stream, como uma [ClinicalNoteGenerationResult](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_ClinicalNoteGenerationResult.html)mudança de `IN_PROGRESS` para`COMPLETED`, AWS HealthScribe gera um evento com as seguintes informações: ``` { "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`: o tipo de operação de análise pós-fluxo que gerou o evento. O conteúdo do objeto resultante varia dependendo do `UpdateType`. + `SessionId`: O número de identificação do seu AWS HealthScribe stream. Use esse ID para identificar a sessão de streaming de origem e depois encontrar as análises pós-fluxo que geraram o evento. + `Status`: o status da operação de análise pós-fluxo. Pode ser `IN_PROGRESS`, `COMPLETED` ou `FAILED`. + `ClinicalNoteOutputLocation`: o URI do bucket de saída do Amazon S3 para o `ClinicalNoteGenerationResult`. + `TranscriptOutputLocation`: o URI da sua transcrição. ### Eventos de vocabulário Quando o estado de um [vocabulário personalizado](custom-vocabulary.md) muda de `PENDING` para `READY` ou`FAILED`, Amazon Transcribe gera um evento. Para identificar o vocabulário personalizado que mudou de estado e iniciar o evento no destino, use o campo `VocabularyName` do evento. Um Amazon Transcribe evento contém as seguintes informações. Um campo `FailureReason` será adicionado em `detail` se o estado do vocabulário personalizado for `FAILED`. **nota** Esse evento se aplica somente à operação de API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html). ``` { "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`: o nome exclusivo do vocabulário personalizado. + `VocabularyState`: o estado de processamento do vocabulário personalizado. Pode ser `READY` ou `FAILED`.