Usando Amazon EventBridge com Amazon Transcribe - Amazon Transcribe
Definindo EventBridge regrasAmazon Transcribe eventos

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 AWS services. 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. Se você quiser configurar notificações, você pode usar Notificações de Usuários da AWS. 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 AWS Management Consoleo. 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.

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 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 é 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:

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 é 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 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 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 ser COMPLETED ou FAILED.

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 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 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 ser COMPLETED ou FAILED.

  • 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 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.

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 ser READY ou FAILED.