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á.
Usando Amazon EventBridge com 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, consulte as seções a seguir.
É possível receber notificações de eventos por meio de vários canais, incluindo e-mail, notificações de chat do AWS Chatbot ou notificações por push do AWS Console Mobile Application. Você também pode ver as notificações na Central de notificações do console
Definindo EventBridge regras
Para definir EventBridge regras, use AWS Management Console
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 deIN_PROGRESS
paraCOMPLETED
. -
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 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
ouFAILED
.
{ "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 é sempreaws.transcribe
. -
detail-type
: um identificador para os detalhes do evento. Para o Amazon Transcribe, isso é sempreTranscribe 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 paraCOMPLETED
ouFAILED
.
Amazon Transcribe eventos
Amazon EventBridge registra vários Amazon Transcribe eventos:
Todos esses eventos contêm os seguintes campos compartilhados:
-
version
: a versão dos dados do evento. Esse valor é sempre0
. -
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 é sempreaws.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 paraFAILED
e descreve o motivo do estado ou statusFAILED
. -
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
ouFAILED
, 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 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
: o nome exclusivo que você escolheu para o trabalho de transcrição. -
TranscriptionJobStatus
o status do trabalho de transcrição. Pode serCOMPLETED
ouFAILED
.
Eventos de identificação de idiomas
Quando você habilita a identificação automática de idioma, 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 StartTranscriptionJob
quando o parâmetro LanguageIdSettings
é 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 serTranscriptionJob
. -
JobName
: o nome exclusivo do trabalho de transcrição. -
LanguageIdentificationStatus
: o status da identificação de idioma em um trabalho de transcrição. Pode serCOMPLETED
ouFAILED
.
Eventos do Call Analytics
Quando o estado de um trabalho do Call Analytics 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 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
: o nome exclusivo do trabalho de transcrição do Call Analytics. -
JobStatus
: o status do trabalho de transcrição do Call Analytics. Ele pode serCOMPLETED
ouFAILED
. -
AnalyticsJobDetails
: os detalhes do seu trabalho de transcrição do Call Analytics, incluindo informações sobre os recursos de análise ignorados.
Eventos pós-chamada do Call Analytics
Quando uma transcrição da análise pós-chamada 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 StartCallAnalyticsStreamTranscription
quando o parâmetro PostCallAnalyticsSettings
é 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://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" } } }
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 serCOMPLETED
ouFAILED
. -
Transcript
: o URI das transcrições editadas e não editadas. -
Media
: o URI dos arquivos de áudio editados e não editados.
Eventos de vocabulário
Quando o estado de um vocabulário personalizado muda de PENDING
para READY
ouFAILED
, 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
.
Observe que esse evento se aplica somente à operação de 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
: o nome exclusivo do vocabulário personalizado. -
VocabularyState
: o estado de processamento do vocabulário personalizado. Pode serREADY
ouFAILED
.