Uso Amazon EventBridge con Amazon Transcribe - Amazon Transcribe
Definir EventBridge reglasAmazon Transcribe eventos

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso Amazon EventBridge con Amazon Transcribe

Con Amazon EventBridgeél, puede responder a los cambios de estado en sus Amazon Transcribe trabajos iniciando eventos en otros Servicios de AWS. Cuando un trabajo de transcripción cambia de estado, envía EventBridge automáticamente un evento a una transmisión de eventos. Puede crear reglas que establezcan los eventos que desee monitorizar en la secuencia de eventos y la acción que EventBridge debe realizar cuando se produzcan dichos eventos. Por ejemplo, el evento puede direccionarse a otro servicio (o destino), que a su vez realizará una acción. Podría, por ejemplo, configurar una regla para enrutar un evento a una AWS Lambda función cuando un trabajo de transcripción se haya completado correctamente. Para definir las reglas EventBridge, consulte las siguientes secciones.

Puede recibir notificaciones de eventos a través de varios canales, como correo electrónico, notificaciones por chat AWS Chatbot o notificaciones push AWS Console Mobile Application. También puede ver las notificaciones en el Centro de notificaciones de la consola. Si quieres configurar las notificaciones, puedes usar AWS User Notifications. AWS User Notifications admite la agregación, lo que puede reducir la cantidad de notificaciones que recibe durante eventos específicos.

Definir EventBridge reglas

Para definir EventBridge reglas, utilice AWS Management Console. Al definir una regla, utilice Amazon Transcribe como nombre del servicio. Para ver un ejemplo de cómo crear una EventBridge regla, consulte Amazon EventBridge reglas.

Antes de usarla EventBridge, tenga en cuenta las siguientes definiciones:

  • Evento: un evento indica un cambio en el estado de uno de sus trabajos de transcripción. Por ejemplo, cuando el valor de TranscriptionJobStatus de un trabajo cambia de IN_PROGRESS a COMPLETED.

  • Objetivo: un objetivo es otro Servicio de AWS que procesa un evento. Por ejemplo, AWS Lambda o Amazon Simple Notification Service (Amazon SNS). Un destino recibe eventos en formato JSON.

  • Regla: una regla hace coincidir los eventos entrantes que EventBridge desea observar y los dirige a uno o varios objetivos para su procesamiento. Si una regla dirige un evento a varios destinos, todos los destinos procesarán el evento en paralelo. Las reglas pueden personalizar el JSON enviado al destino.

Amazon EventBridge los eventos se emiten en función del mejor esfuerzo posible. Para obtener más información sobre la creación y la gestión de eventos en EventBridge, consulte Amazon EventBridge los eventos en la Guía del Amazon EventBridge usuario.

A continuación se muestra un ejemplo de una EventBridge regla Amazon Transcribe que se inicia cuando el estado de un trabajo de transcripción cambia a COMPLETED oFAILED.

{
    "source": [
        "aws.transcribe"
    ],
    "detail-type": [
        "Transcribe Job State Change"
    ],
    "detail": {
        "TranscriptionJobStatus": [
            "COMPLETED",
            "FAILED"
        ]
    }
}

La regla contiene los siguientes campos:

  • source: origen del evento. Porque Amazon Transcribe esto es siempreaws.transcribe.

  • detail-type: un identificador de los detalles del evento. En Amazon Transcribe, este siempre es Transcribe Job State Change.

  • detail: el nuevo estado laboral del trabajo de transcripción. En este ejemplo, la regla iniciará un evento cuando el estado del trabajo cambie a COMPLETED o FAILED.

Amazon Transcribe eventos

Amazon EventBridge registra varios Amazon Transcribe eventos:

Todos estos eventos contienen los siguientes campos compartidos:

  • version: la versión de los datos del evento. Este valor siempre es 0.

  • id: un identificador único generado EventBridge por el evento.

  • detail-type: un identificador de los detalles del evento. Por ejemplo, Transcribe Job State Change.

  • source: el origen del evento. Porque Amazon Transcribe esto es siempreaws.transcribe.

  • account: El Cuenta de AWS ID de la cuenta que generó la llamada a la API.

  • time: la fecha y la hora en que se entrega el evento.

  • region: el lugar Región de AWS en el que se realiza la solicitud.

  • resources: los recursos utilizados por la llamada a la API. Para Amazon Transcribe, este campo siempre está vacío.

  • detail: detalles adicionales sobre el evento.

    • FailureReason: este campo está presente si el estado o condición cambia a FAILED, y describe el motivo del estado o condición FAILED.

    • Cada tipo de evento tiene campos únicos adicionales que se muestran debajo de detail. Estos campos únicos se definen en las siguientes secciones después de cada ejemplo de evento.

Transcripción de eventos de trabajo

Cuando el estado de un trabajo cambia de IN_PROGRESS a COMPLETED oFAILED, Amazon Transcribe genera un evento. Para identificar el trabajo que cambió de estado e inició el evento en el destino, utilice el campo del evento TranscriptionJobName. Un Amazon Transcribe evento contiene la siguiente información. Se agrega un campo FailureReason debajo de detail si el estado de su trabajo de transcripción es FAILED.

Tenga en cuenta que este evento sólo se aplica a la operación StartTranscriptionJob de la API.

{
    "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: el nombre único que eligió para su trabajo de transcripción.

  • TranscriptionJobStatus : el estado del trabajo de transcripción. Este valor puede ser COMPLETED o FAILED.

Eventos de identificación del idioma

Al activar la identificación automática del idioma, Amazon Transcribe genera un evento cuando el estado de identificación del idioma es COMPLETED o FAILED. Para identificar el trabajo que cambió de estado e inició el evento en el destino, utilice el campo del evento JobName. Los eventos de Amazon Transcribe contienen la siguiente información: Se agrega un campo FailureReason debajo de detail si el estado de identificación del idioma es FAILED.

Tenga en cuenta que este evento sólo se aplica a la operación de la API StartTranscriptionJob cuando se incluye el parámetro LanguageIdSettings.

{
    "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 los trabajos de transcripción, este valor debe ser TranscriptionJob.

  • JobName: el nombre único de su trabajo de transcripción.

  • LanguageIdentificationStatus: el estado de la identificación del idioma en un trabajo de transcripción. Este valor puede ser COMPLETED o FAILED.

Eventos de Call Analytics

Cuando el estado de un trabajo de Call Analytics cambia de IN_PROGRESS a COMPLETED o FAILED, Amazon Transcribe genera un evento. Para identificar el trabajo de Call Analytics que cambió de estado e inició el evento en el destino, utilice el campo JobName del evento. Los eventos de Amazon Transcribe contienen la siguiente información: Se agrega un campo FailureReason debajo de detail si el estado del trabajo de Call Analytics es FAILED.

Tenga en cuenta que este evento sólo se aplica a la operación StartCallAnalyticsJob de la API.

{
    "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: el nombre exclusivo de su trabajo de transcripción de Call Analytics.

  • JobStatus: el estado de su trabajo de transcripción de Call Analytics. Puede ser COMPLETED o FAILED.

  • AnalyticsJobDetails: Los detalles de tu trabajo de transcripción de Call Analytics, incluida la información sobre las funciones de análisis omitidas.

Eventos posteriores a la llamada de Call Analytics

Cuando una transcripción de análisis posterior a la llamada cambia de estado de IN_PROGRESS a COMPLETED o FAILED, Amazon Transcribe genera un evento. Para identificar el trabajo de Call Analytics posterior a la llamada que cambió de estado e inició el evento en el destino, utilice el campo StreamingSessionId del evento.

Tenga en cuenta que este evento sólo se aplica a la operación de la API StartCallAnalyticsStreamTranscription cuando se incluye el parámetro PostCallAnalyticsSettings.

Un evento COMPLETED contiene la siguiente información:

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

Un evento FAILED contiene la siguiente información:

{
    "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: el número de identificación asignado a su solicitud de transcripción de Call Analytics en tiempo real.

  • PostCallStatus: el estado de su trabajo de transcripción de Call Analytics posterior a la llamada. Puede ser COMPLETED o FAILED.

  • Transcript: el URI de sus transcripciones redactadas y no redactadas.

  • Media: el URI de sus archivos de audio redactados y no redactados.

Eventos de vocabulario

Cuando el estado de un vocabulario personalizado cambia de PENDING a READY oFAILED, se Amazon Transcribe genera un evento. Para identificar el vocabulario personalizado que cambió de estado e inició el evento en el destino, utilice el campo VocabularyName del evento. Un Amazon Transcribe evento contiene la siguiente información. Se agrega un campo FailureReason debajo de detail si el estado de su vocabulario personalizado es FAILED.

Tenga en cuenta que este evento sólo se aplica a la operación CreateVocabulary de la 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: el nombre exclusivo de su vocabulario personalizado.

  • VocabularyState: el estado de procesamiento de su vocabulario personalizado. Este valor puede ser READY o FAILED.