Uso de Amazon EventBridge con Amazon Transcribe - Amazon Transcribe
Definición de reglas de EventBridgeAmazon TranscribeEventos de

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 de Amazon EventBridge con Amazon Transcribe

Con Amazon EventBridge, puede responder a los cambios de estado de sus trabajos de Amazon Transcribe iniciando eventos en otros Servicios de AWS. Cuando un trabajo de transcripción cambia de estado, EventBridge envía automáticamente un evento a un flujo 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. Por ejemplo, puede configurar una regla para que un evento se direccione a una función de AWS Lambda cuando el 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 de Amazon Q Developer en aplicaciones de chat o notificaciones push de AWS Console Mobile Application. También puede ver las notificaciones en el Centro de notificaciones de la consola. Si desea configurar notificaciones, puede utilizar AWS User Notifications. AWS User Notifications admite la agregación, lo que puede reducir el número de notificaciones que recibe durante eventos específicos.

Definición de reglas de EventBridge

Para definir las reglas de EventBridge, utilice la Consola de administración de AWS. Al definir una regla, utilice Amazon Transcribe como nombre del servicio. Para ver un ejemplo de cómo crear una regla EventBridge, consulte Amazon EventBridgereglas.

Antes de usar 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 de entrada EventBridge que desee observar y los dirige a uno o varios destinos para 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.

Los eventos Amazon EventBridge se emiten en la medida de lo posible. Para obtener más información sobre la creación y administración de eventos en EventBridge, consulte eventos de Amazon EventBridge en la Guía del usuario de Amazon EventBridge.

El siguiente es un ejemplo de una regla EventBridge para Amazon Transcribe que se inicia cuando el estado de un trabajo de transcripción cambia a COMPLETED o FAILED.

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

La regla contiene los siguientes campos:

  • source: origen del evento. En Amazon Transcribe, este siempre es aws.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 TranscribeEventos de

Amazon EventBridgeregistra varios eventos de Amazon Transcribe:

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 que genera EventBridge por para el evento.

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

  • source: el origen del evento. En Amazon Transcribe, siempre es aws.transcribe.

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

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

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

  • resources: los recursos utilizados por la llamada a la API. En 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 o FAILED, 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. Los eventos de Amazon Transcribe contienen 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"),
        "FailureReason": "failure reason", // only present when JobStatus is 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.

  • FailureReason: este campo solo está presente cuando el JobStatus es FAILED y describe el motivo del error.

  • AnalyticsJobDetails: los detalles de su trabajo de transcripción de Call Analytics, incluida la información sobre las características 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://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"
        }
    }
}

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 análisis posteriores a la transmisión de AWS HealthScribe

Cuando el estado de una operación de análisis posterior a la transmisión de AWS HealthScribe cambia, como cuando un ClinicalNoteGenerationResult cambia de IN_PROGRESS a COMPLETED, AWS HealthScribe genera un evento con la siguiente información:

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

  • UpdateType: el tipo de operación de análisis posterior a la transmisión que generó el evento. El contenido del objeto resultante varía en función del UpdateType.

  • SessionId: el número de identificación de su transmisión de AWS HealthScribe. Use este ID para identificar la sesión de transmisión de origen y, a continuación, busque los análisis posteriores a la transmisión que generaron el evento.

  • Status: el estado de la operación de análisis posterior a la transmisión. Este valor puede ser IN_PROGRESS, COMPLETED o FAILED.

  • ClinicalNoteOutputLocation: el URI del bucket Amazon S3 de salida para ClinicalNoteGenerationResult.

  • TranscriptOutputLocation: el URI de su transcripción.

Eventos de vocabulario

Cuando el estado de un vocabulario personalizado cambia de PENDING a READY o FAILED, 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. Los eventos de Amazon Transcribe contienen la siguiente información: Se agrega un campo FailureReason debajo de detail si el estado de su vocabulario personalizado es FAILED.

nota

Este evento solo 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.