Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Utilizzo Amazon EventBridge con Amazon Transcribe
Con Amazon EventBridge, puoi rispondere ai cambiamenti di stato nei tuoi Amazon Transcribe lavori avviando eventi in altri. Servizi AWS Quando un processo di trascrizione cambia stato, invia EventBridge automaticamente un evento a un flusso di eventi. È possibile creare regole che definiscono gli eventi che si desidera monitorare nel flusso eventi e l'operazione che EventBridge deve eseguire quando tali eventi si verificano. Ad esempio, l'instradamento dell'evento a un altro servizio (o destinazione), che può quindi eseguire un'operazione. È possibile, ad esempio, configurare una regola per indirizzare un evento a una AWS Lambda funzione quando un processo di trascrizione viene completato correttamente. Per definire le [regole EventBridge](#defining-rules), consulta le seguenti sezioni.
Puoi ricevere notifiche relative agli eventi attraverso più canali, tra cui e-mail, [Amazon Q Developer in chat, applicazioni](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html) di chat, notifiche di chat o notifiche [AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html)push. È anche possibile visualizzare le notifiche nel [Centro notifiche della console](https://console.aws.amazon.com/notifications/). Se desideri configurare le notifiche, puoi usare [Notifiche all'utente AWS](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html). Notifiche all'utente AWS supporta l'aggregazione, che può ridurre il numero di notifiche ricevute durante eventi specifici.
## Definizione delle regole EventBridge
Per definire EventBridge le regole, utilizzare il [Console di gestione AWS](https://console.aws.amazon.com/events). Quando si definisce una regola, utilizzare Amazon Transcribe come nome del servizio. Per un esempio di come creare una EventBridge regola, vedi [Amazon EventBridge rules](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html).
Prima dell'uso EventBridge, prendete nota delle seguenti definizioni:
+ **Evento**: un evento indica una modifica dello stato di uno dei processi di trascrizione. Ad esempio, quando il `TranscriptionJobStatus` di un processo passa da `IN_PROGRESS` a `COMPLETED`.
+ **Target**: un target è un altro Servizio AWS che elabora un evento. Ad esempio, AWS Lambda o Amazon Simple Notification Service (Amazon SNS). Un target riceve eventi in formato JSON.
+ **Regola**: una regola abbina gli eventi in arrivo che si desidera EventBridge monitorare e li indirizza verso una o più destinazioni per l'elaborazione. Se una regola instrada un evento su più destinazioni, tutte le destinazioni elaborano l'evento in parallelo. Una regola è in grado di personalizzare il JSON inviato al target.
Amazon EventBridge gli eventi vengono emessi con la massima diligenza possibile. Per ulteriori informazioni sulla creazione e la gestione di eventi in EventBridge, consulta [Amazon EventBridge gli eventi nella Guida](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) per l'*Amazon EventBridge utente*.
Di seguito è riportato un esempio di EventBridge regola Amazon Transcribe che viene avviata quando lo stato di un processo di trascrizione cambia in o. `COMPLETED` `FAILED`
```
{
"source": [
"aws.transcribe"
],
"detail-type": [
"Transcribe Job State Change"
],
"detail": {
"TranscriptionJobStatus": [
"COMPLETED",
"FAILED"
]
}
}
```
La regola contiene i seguenti campi:
+ `source`: l'origine dell'evento. Perché Amazon Transcribe, questo è sempre. `aws.transcribe`
+ `detail-type`: un identificativo dei dettagli dell'evento. Per Amazon Transcribe, è sempre `Transcribe Job State Change`.
+ `detail`: il nuovo stato del processo di trascrizione. In questo esempio, la regola avvia un evento quando lo stato del processo passa a `COMPLETED` o `FAILED`.
## Amazon Transcribe eventi
Amazon EventBridge registra diversi Amazon Transcribe eventi:
+ [Eventi del processo di trascrizione](#job-event)
+ [Eventi di identificazione della lingua](#lang-id-event)
+ [Eventi di analisi delle chiamate](#analytics-event)
+ [Eventi di analisi post-chiamata](#analytics-stream-event)
+ [Eventi relativi al vocabolario](#vocab-event)
Questi eventi contengono tutti i seguenti campi condivisi:
+ `version`: la versione dei dati dell'evento. Questo valore è sempre `0`.
+ `id`: un identificatore univoco generato da EventBridge per l'evento.
+ `detail-type`: un identificativo dei dettagli dell'evento. Ad esempio, `Transcribe Job State Change`.
+ `source`: l'origine dell'evento. Perché Amazon Transcribe questo è sempre`aws.transcribe`.
+ `account`: L' Account AWS ID dell'account che ha generato la chiamata API.
+ `time`: la data e l'ora di consegna dell'evento.
+ `region`: Il Regione AWS codice in cui viene effettuata la richiesta.
+ `resources`: le risorse utilizzate dalla chiamata API. Perché Amazon Transcribe, questo campo è sempre vuoto.
+ `detail`: dettagli aggiuntivi relativi all'evento.
+ `FailureReason`: questo campo è presente se lo stato cambia in `FAILED` e descrive il motivo dello stato `FAILED`.
+ Ogni tipo di evento ha campi unici aggiuntivi che vengono visualizzati sotto `detail`. Questi campi unici sono definiti nelle sezioni seguenti dopo ogni esempio di evento.
### Eventi del processo di trascrizione
Quando lo stato di un lavoro cambia `IN_PROGRESS` da `COMPLETED` o`FAILED`, Amazon Transcribe genera un evento. Per identificare il processo che ha modificato lo stato e ha avviato l'evento nel target, usa il campo `TranscriptionJobName` dell'evento. Un Amazon Transcribe evento contiene le seguenti informazioni. Viene aggiunto un campo `FailureReason` sotto `detail` se lo stato del processo di trascrizione è `FAILED`.
Tieni presente che questo evento si applica solo all'operazione API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html).
```
{
"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`: il nome univoco che hai scelto per il tuo processo di trascrizione.
+ `TranscriptionJobStatus `: lo stato del processo di trascrizione. Questa può essere un `COMPLETED` o un `FAILED`.
### Eventi di identificazione della lingua
Quando si abilita l'[identificazione automatica della lingua](lang-id.md), Amazon Transcribe genera un evento quando lo stato di identificazione della lingua è `COMPLETED` o `FAILED`. Per identificare il processo che ha modificato lo stato e ha avviato l'evento nel target, usa il campo `JobName` dell'evento. Un evento Amazon Transcribe contiene le seguenti informazioni: Viene aggiunto un campo `FailureReason` sotto `detail` se lo stato di identificazione della lingua è `FAILED`.
Tieni presente che questo evento si applica solo all'operazione API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) quando il parametro [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html) è incluso.
```
{
"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`: per i processi di trascrizione, questo valore deve essere `TranscriptionJob`.
+ `JobName`: il nome univoco del tuo processo di trascrizione.
+ `LanguageIdentificationStatus`: lo stato dell'identificazione della lingua in un processo di trascrizione. Questa può essere un `COMPLETED` o un `FAILED`.
### Eventi di analisi delle chiamate
Quando lo stato di un processo di [analisi delle chiamate](call-analytics.md) passa da `IN_PROGRESS` a `COMPLETED` o `FAILED`, Amazon Transcribe genera un evento. Per identificare il processo di analisi delle chiamate che ha modificato lo stato e ha avviato l'evento nel target, usa il campo `JobName` dell'evento. Un evento Amazon Transcribe contiene le seguenti informazioni: Viene aggiunto un campo `FailureReason` sotto `detail` se lo stato del processo di analisi delle chiamate è `FAILED`.
Tieni presente che questo evento si applica solo all'operazione API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html).
```
{
"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`: il nome univoco del processo di trascrizione di analisi delle chiamate.
+ `JobStatus`: lo stato del tuo processo di trascrizione di analisi delle chiamate. Ciò può essere `COMPLETED` o `FAILED`.
+ `FailureReason`: Questo campo è presente solo quando `JobStatus` è `FAILED` e descrive il motivo dell'errore.
+ `AnalyticsJobDetails`: I dettagli del processo di trascrizione di Call Analytics, incluse le informazioni sulle funzionalità di analisi ignorate.
### Eventi di analisi post-chiamata
Quando lo stato di un processo di [analisi post-chiamata](tca-post-call.md) passa da `IN_PROGRESS` a `COMPLETED` o `FAILED`, Amazon Transcribe genera un evento. Per identificare il processo di analisi post-chiamata che ha modificato lo stato e ha avviato l'evento nel target, usa il campo `StreamingSessionId` dell'evento.
Tieni presente che questo evento si applica solo all'operazione API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html) quando il parametro [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html) è incluso.
Un evento `COMPLETED` contiene le seguenti informazioni:
```
{
"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 le seguenti informazioni:
```
{
"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`: il numero di identificazione assegnato alla richiesta di trascrizione di analisi delle chiamate in tempo reale.
+ `PostCallStatus`: lo stato del tuo processo di trascrizione di analisi post-chiamata. Ciò può essere `COMPLETED` o `FAILED`.
+ `Transcript`: l'URI delle trascrizioni redatte e non redatte.
+ `Media`: l'URI dei file audio redatti e non redatti.
### AWS HealthScribe eventi di analisi post stream
Quando uno stato cambia per un'operazione di analisi AWS HealthScribe post-stream, ad esempio una [ClinicalNoteGenerationResult](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_ClinicalNoteGenerationResult.html)modifica da `IN_PROGRESS` a`COMPLETED`, AWS HealthScribe genera un evento con le seguenti informazioni:
```
{
"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": ,
"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": ,
"FailureReason":
}
}
}
```
+ `UpdateType`: il tipo di operazione di analisi post-stream che ha generato l'evento. Il contenuto dell'oggetto risultato varia a seconda di`UpdateType`.
+ `SessionId`: il numero identificativo del tuo AWS HealthScribe stream. Utilizza questo ID per identificare la sessione di streaming originaria e quindi trovare l'analisi post-streaming che ha generato l'evento.
+ `Status`: lo stato dell'operazione di analisi post-stream. Questo valore può essere `IN_PROGRESS`, `COMPLETED` o `FAILED`.
+ `ClinicalNoteOutputLocation`: L'URI del bucket Amazon S3 di output per. `ClinicalNoteGenerationResult`
+ `TranscriptOutputLocation`: L'URI della tua trascrizione.
### Eventi relativi al vocabolario
Quando lo stato di un [vocabolario personalizzato](custom-vocabulary.md) cambia da `READY` o`FAILED`, `PENDING` Amazon Transcribe genera un evento. Per identificare il vocabolario personalizzato che ha modificato lo stato e ha avviato l'evento nel target, usa il campo `VocabularyName` dell'evento. Un Amazon Transcribe evento contiene le seguenti informazioni. Viene aggiunto un campo `FailureReason` sotto `detail` se lo stato del vocabolario personalizzato è `FAILED`.
**Nota**
Questo evento si applica solo all'operazione [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)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`: il nome univoco del vocabolario personalizzato.
+ `VocabularyState`: lo stato di elaborazione del vocabolario personalizzato. Questa può essere un `READY` o un `FAILED`.