Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Verwenden Amazon EventBridge mit Amazon Transcribe
Mit Amazon EventBridge können Sie auf Statusänderungen in Ihren Amazon Transcribe Jobs reagieren, indem Sie Ereignisse in anderen Bereichen einleiten. AWS-Services Wenn sich der Status eines Transkriptionsauftrags ändert, EventBridge wird automatisch ein Ereignis an einen Event-Stream gesendet. Sie erstellen Regeln, die die Ereignisse, die Sie im Ereignis-Stream überwachen möchten, sowie die Aktion definieren, die EventBridge im Falle solcher Ereignisse ausführen soll. Beispiel: Das Ereignis an einen anderen Service (oder ein anderes Ziel) weiterleiten, der/das dann eine Aktion ausführen kann. Sie könnten beispielsweise eine Regel so konfigurieren, dass ein Ereignis an eine AWS Lambda Funktion weitergeleitet wird, wenn ein Transkriptionsauftrag erfolgreich abgeschlossen wurde. Informationen zum Definieren von [EventBridge -Regeln](#defining-rules) finden Sie in den folgenden Abschnitten.
Sie können Benachrichtigungen für Ereignisse über mehrere Kanäle erhalten, darunter E-Mail, [Amazon Q Developer in Chat-Anwendungen](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html), Chat-Benachrichtigungen oder [AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html)Push-Benachrichtigungen. Benachrichtigungen werden auch im [Console Notifications Center](https://console.aws.amazon.com/notifications/) angezeigt. Wenn Sie Benachrichtigungen einrichten möchten, können Sie [AWS-Benutzerbenachrichtigungen](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html). AWS-Benutzerbenachrichtigungen unterstützt die Aggregation, wodurch die Anzahl der Benachrichtigungen, die Sie bei bestimmten Ereignissen erhalten, reduziert werden kann.
## Regeln definieren EventBridge
Um EventBridge Regeln zu definieren, verwenden Sie den [AWS-Managementkonsole](https://console.aws.amazon.com/events). Wenn Sie eine Regel definieren, verwenden Sie Amazon Transcribe als Servicenamen. Ein Beispiel für die Erstellung einer EventBridge Regel finden Sie unter [Amazon EventBridge Regeln](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html).
Beachten Sie EventBridge vor der Verwendung die folgenden Definitionen:
+ **Ereignis** – Ein Ereignis zeigt an, dass sich der Zustand eines Ihrer Transkriptionsaufträge geändert hat. Zum Beispiel wenn sich der `TranscriptionJobStatus` eines Auftrags von `IN_PROGRESS` in `COMPLETED` ändert.
+ **Ziel** – Ein Ziel ist ein anderes AWS-Service , das ein Ereignis verarbeitet. Zum Beispiel AWS Lambda oder Amazon Simple Notification Service (Amazon SNS). Ein Ziel empfängt Ereignisse im JSON-Format.
+ **Regel** — Eine Regel sucht nach eingehenden Ereignissen, EventBridge nach denen Sie Ausschau halten möchten, und leitet sie zur Verarbeitung an ein oder mehrere Ziele weiter. Wenn eine Regel ein Ereignis an mehrere Ziele weiterleitet, verarbeiten alle Ziele das Ereignis parallel. Eine Regel kann die an das Ziel gesendete JSON-Datei anpassen.
Amazon EventBridge Ereignisse werden nach bestem Wissen und Gewissen ausgegeben. Weitere Informationen zum Erstellen und Verwalten von Ereignissen in EventBridge finden Sie unter [Amazon EventBridge Ereignisse](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) im *Amazon EventBridge Benutzerhandbuch*.
Im Folgenden finden Sie ein Beispiel für eine EventBridge Regel Amazon Transcribe , die ausgelöst wird, wenn sich der Status eines Transkriptionsauftrags auf `COMPLETED` oder `FAILED` ändert.
```
{
"source": [
"aws.transcribe"
],
"detail-type": [
"Transcribe Job State Change"
],
"detail": {
"TranscriptionJobStatus": [
"COMPLETED",
"FAILED"
]
}
}
```
Die Regel enthält die folgenden Felder:
+ `source` – Die Quelle des Ereignisses. Denn Amazon Transcribe das ist immer `aws.transcribe` so.
+ `detail-type` – Ein Bezeichner für die Details des Ereignisses. Für Amazon Transcribe ist dies immer `Transcribe Job State Change`.
+ `detail` – Der neue Auftragsstatus des Transkriptionsauftrags. In diesem Beispiel löst die Regel ein Ereignis aus, wenn sich der Auftragsstatus zu `COMPLETED` oder `FAILED`ändert.
## Amazon Transcribe Ereignisse
Amazon EventBridge protokolliert mehrere Amazon Transcribe Ereignisse:
+ [Ereignisse in Transkriptionsaufträgen](#job-event)
+ [Sprachenidentifikationsereignisse](#lang-id-event)
+ [Call-Analytics-Ereignisse aufrufen](#analytics-event)
+ [Call-Analytics-nach-Anfruf-Ereignissen aufrufen](#analytics-stream-event)
+ [Ereignisse im Wortschatz](#vocab-event)
Diese Ereignisse enthalten alle die folgenden gemeinsamen Felder:
+ `version`: Die Version der Ereignisdaten. Dieser Wert ist immer `0`.
+ `id`: Eine eindeutige Kennung, die von EventBridge für das Ereignis generiert wurde.
+ `detail-type`: Ein Bezeichner für die Details des Ereignisses. Beispiel, `Transcribe Job State Change`.
+ `source`: Die Quelle des Ereignisses. Denn Amazon Transcribe das ist immer so`aws.transcribe`.
+ `account`: Die AWS-Konto ID des Kontos, das den API-Aufruf generiert hat.
+ `time`: Das Datum und die Uhrzeit, zu der das Ereignis übertragen wird.
+ `region`: Die, AWS-Region in der die Anfrage gestellt wird.
+ `resources`: Die von dem API-Aufruf verwendeten Ressourcen. Für Amazon Transcribe, dieses Feld ist immer leer.
+ `detail`: Zusätzliche Details zum Ereignis.
+ `FailureReason`: Dieses Feld ist vorhanden, wenn der Zustand oder der Status geändert wird zu `FAILED`, und beschreibt den Grund für den `FAILED`-Zustand oder -Status.
+ Jeder Ereignistyp hat zusätzliche eindeutige Felder, die unter `detail` angezeigt werden. Diese eindeutigen Felder werden in den folgenden Abschnitten nach jedem Ereignisbeispiel definiert.
### Ereignisse in Transkriptionsaufträgen
Wenn sich der Status eines Jobs von `IN_PROGRESS` zu `COMPLETED` oder ändert`FAILED`, Amazon Transcribe wird ein Ereignis generiert. Um den Job zu identifizieren, der den Zustand geändert und das Ereignis in Ihrem Ziel ausgelöst hat, verwenden Sie das Feld `TranscriptionJobName` des Ereignisses. Ein Amazon Transcribe Ereignis enthält die folgenden Informationen. Ein `FailureReason`-Feld wird unter `detail` hinzugefügt, wenn Ihr Transkriptionsjobstatus `FAILED` lautet.
Beachten Sie, dass dieses Ereignis nur für den [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html)-API-Vorgang gilt.
```
{
"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`: Der eindeutige Name, den Sie für Ihren Transkriptionsauftrag gewählt haben.
+ `TranscriptionJobStatus `: Der Status des Transkriptionsauftrags. Mögliche Werte sind `COMPLETED` oder `FAILED`.
### Sprachenidentifikationsereignisse
Wenn Sie die [automatische Sprachenidentifikation](lang-id.md) aktivieren, generiert Amazon Transcribe ein Ereignis, wenn der Zustand der Sprachidentifikation `COMPLETED` oder lautet`FAILED`. Um den Job zu identifizieren, der den Zustand geändert und das Ereignis in Ihrem Ziel ausgelöst hat, verwenden Sie das Feld `JobName` des Ereignisses. Ein Amazon Transcribe -Ereignis enthält die folgenden Informationen: Ein `FailureReason`-Feld wird unter `detail` hinzugefügt, falls Ihre Sprachidentifikation den Status `FAILED` hat.
Beachten Sie, dass dieses Ereignis nur für den [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html)-API-Vorgang gilt, wenn der [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html)-Parameter enthalten ist.
```
{
"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`: Für Transkriptionsaufträge muss dieser Wert `TranscriptionJob` sein.
+ `JobName`: Der eindeutige Name, den Sie für Ihren Transkriptionsauftrag gewählt haben.
+ `LanguageIdentificationStatus`: Der Status der Sprachidentifikation in einem Transkriptionsauftrag. Mögliche Werte sind `COMPLETED` oder `FAILED`.
### Call-Analytics-Ereignisse aufrufen
Wenn der Zustand eines [Call-Analytics-Auftrags](call-analytics.md) von `IN_PROGRESS` zu `COMPLETED` oder `FAILED`wechselt, erzeugt Amazon Transcribe ein Ereignis. Um den Call-Analytics-Auftrag zu identifizieren, der den Zustand geändert hat und das Ereignis in Ihrem Ziel auslöst, verwenden Sie das Feld `JobName` des Ereignisses. Ein Amazon Transcribe -Ereignis enthält die folgenden Informationen: Ein `FailureReason`-Feld wird unter `detail` hinzugefügt, wenn Ihr Call-Analytics-Auftragsstatus `FAILED` lautet.
Beachten Sie, dass dieses Ereignis nur für den [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html)-API-Vorgang gilt.
```
{
"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`: Der eindeutige Name Ihres Call-Analytics-Transkriptionsauftrags.
+ `JobStatus`: Der eindeutige Status Ihres Call-Analytics-Transkriptionsauftrags. Dies kann entweder `COMPLETED` oder `FAILED`sein.
+ `FailureReason`: Dieses Feld ist nur vorhanden, wenn dies der `JobStatus` Fall ist`FAILED`, und beschreibt den Grund für den Fehler.
+ `AnalyticsJobDetails`: Die Details Ihres Call Analytics-Transkriptionsauftrags, einschließlich Informationen zu übersprungenen Analysefunktionen.
### Call-Analytics-nach-Anfruf-Ereignissen aufrufen
Wenn eine [nach-Anfruf-Analytics](tca-post-call.md)-Transkription den Zustand von `IN_PROGRESS` zu `COMPLETED` oder `FAILED`, Amazon Transcribe ändert, wird ein Ereignis erzeugt. Um den Call-Analytics-Auftrag nach dem Gespräch zu identifizieren, der den Zustand geändert und das Ereignis in Ihrem Ziel ausgelöst hat, verwenden Sie das Feld `StreamingSessionId` des Ereignisses.
Beachten Sie, dass dieses Ereignis nur für den [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html)-API-Vorgang gilt, wenn der [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html)-Parameter enthalten ist.
Ein `COMPLETED`-Ereignis enthält die folgenden Informationen:
```
{
"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"
}
}
}
```
Ein `FAILED`-Ereignis enthält die folgenden Informationen:
```
{
"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`: Die Identifikationsnummer, die Ihrer Call-Analytics-Transkriptionsanfrage in Echtzeit zugewiesen wurde.
+ `PostCallStatus`: Der Status Ihrer Call-Analytics-Transkription nach Anrufen. Dies kann entweder `COMPLETED` oder `FAILED`sein.
+ `Transcript`: Die URI Ihrer redigierten und unredigierten Transkripte.
+ `Media`: Die URI Ihrer redigierten und unredigierten Audiodateien.
### AWS HealthScribe Ereignisse nach der Stream-Analyse
Wenn sich bei einem Analysevorgang AWS HealthScribe nach dem Stream ein Status ändert, z. B. wenn von `IN_PROGRESS` zu [ClinicalNoteGenerationResult](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_ClinicalNoteGenerationResult.html)gewechselt AWS HealthScribe wird`COMPLETED`, wird ein Ereignis mit den folgenden Informationen generiert:
```
{
"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`: Der Typ des Post-Stream-Analysevorgangs, der das Ereignis generiert hat. Der Inhalt des Ergebnisobjekts variiert je nach. `UpdateType`
+ `SessionId`: Die Identifikationsnummer für Ihren AWS HealthScribe Stream. Verwenden Sie diese ID, um die ursprüngliche Streaming-Sitzung zu identifizieren und dann die Post-Stream-Analyse zu finden, die das Ereignis generiert hat.
+ `Status`: Der Status des Analysevorgangs nach dem Stream. Mögliche Werte sind `IN_PROGRESS`, `COMPLETED` oder `FAILED`.
+ `ClinicalNoteOutputLocation`: Die URI des Amazon S3 S3-Ausgabe-Buckets für`ClinicalNoteGenerationResult`.
+ `TranscriptOutputLocation`: Die URI Ihres Transkripts.
### Ereignisse im Wortschatz
Wenn der Status eines [benutzerdefinierten Vokabulars](custom-vocabulary.md) von `PENDING` zu `READY` oder wechselt`FAILED`, Amazon Transcribe wird ein Ereignis generiert. Um das benutzerdefinierte Vokabular zu identifizieren, das den Zustand geändert und das Ereignis in Ihrem Ziel ausgelöst hat, verwenden Sie das Feld `VocabularyName` des Ereignisses. Ein Amazon Transcribe Ereignis enthält die folgenden Informationen. Ein `FailureReason`-Feld wird unter `detail` hinzugefügt, wenn Ihr benutzerdefinierter Wortschatzzustand `FAILED` lautet.
**Anmerkung**
Dieses Ereignis gilt nur für den [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)API-Vorgang.
```
{
"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`: Der eindeutige Name Ihres benutzerdefinierten Vokabulars.
+ `VocabularyState`: Der Verarbeitungszustand Ihres benutzerdefinierten Vokabulars. Mögliche Werte sind `READY` oder `FAILED`.