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

Usar o Amazon EventBridge com o Amazon Transcribe

Com o Amazon EventBridge, você pode responder a alterações de estado em seus trabalhos do Amazon Transcribe iniciando eventos em outros Serviços da AWS. Quando um trabalho de transcrição muda de estado, o EventBridge envia automaticamente um evento a 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. Por exemplo, é possível configurar uma regra para rotear um evento para uma função do AWS Lambda 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 para eventos por meio de diversos canais, incluindo o e-mail, o Amazon Q Developer em aplicações de chat, notificações por chat ou notificações push do AWS Console Mobile Application. Você também pode ver as notificações na Central de notificações do console. Se quiser configurar notificações, você poderá usar o Notificações de Usuários da AWS. O Notificações de Usuários da AWS permite agregação, o que pode reduzir o número de notificações recebidas durante eventos específicos.

Definir regras do EventBridge

Para definir regras do EventBridge, use o Console de gerenciamento da AWS. Ao definir uma regra, use o Amazon Transcribe como o nome do serviço. Para ver um exemplo de como criar uma regra do EventBridge, consulte Amazon EventBridgerules.

Antes de usar o EventBridge, observe as seguintes definições:

Os eventos do Amazon EventBridge são emitidos com base no melhor esforço. Para obter mais informações sobre criação e gerenciamento de eventos no EventBridge, consulte Amazon EventBridge events no Guia do usuário do Amazon EventBridge.

Veja a seguir um exemplo de uma regra do EventBridge para o 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:

Amazon TranscribeEventos do

O Amazon EventBridge registra em log vários eventos do Amazon Transcribe:

Todos esses eventos contêm os seguintes campos compartilhados:

Eventos de trabalho de transcrição

Quando o estado de um trabalho muda de IN_PROGRESS para COMPLETED ou FAILED, o 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 evento do Amazon Transcribe 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")
    }   
}

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")
    }
}

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"),
        "FailureReason": "failure reason", // only present when JobStatus is FAILED
        "AnalyticsJobDetails": { // only when you enable optional features such as Generative Call Summarization
            "Skipped": []
        }
    }
}

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://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"
    }
}

Eventos de análise de pós-fluxo do AWS HealthScribe

Quando ocorre uma mudança de estado em uma operação de análise pós-fluxo do AWS HealthScribe, como a alteração de um ClinicalNoteGenerationResult de IN_PROGRESS para COMPLETED, o 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": <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": <IN_PROGRESS | COMPLETED | FAILED>,
          "FailureReason": <failure_reason>
    }
   }
}

Eventos de vocabulário

Quando o estado de um vocabulário personalizado muda de PENDING para READY ou FAILED, o 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 evento do Amazon Transcribe contém as seguintes informações. Um campo FailureReason será adicionado em detail se o estado do vocabulário personalizado for FAILED.

{
    "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")
    }
}