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. # AWS HealthScribe AWS HealthScribe ist eine HIPAA-fähige Funktion für maschinelles Lernen (ML), die Spracherkennung und generative KI kombiniert, um Gespräche zwischen Patienten und Ärzten zu transkribieren und klinische Notizen zu generieren. easy-to-review AWS HealthScribe unterstützt Anbieter von Gesundheitssoftware bei der Entwicklung klinischer Anwendungen, die den Dokumentationsaufwand reduzieren und das Beratungserlebnis verbessern. Der Service stellt automatisch umfangreiche Gesprächsprotokolle bereit, identifiziert Sprecherrollen, klassifiziert Dialoge, extrahiert medizinische Fachbegriffe und generiert vorläufige klinische Notizen. AWS HealthScribekombiniert diese Funktionen, sodass keine separaten KI-Services integriert und optimiert werden müssen, sodass Sie die Implementierung beschleunigen können. Häufige Anwendungsfälle: + **Reduzieren des Zeitaufwands für die Dokumentation** – Ermöglichen Sie es dem medizinischen Fachpersonal, die klinische Dokumentation schnell mit KI-generierten klinischen Notizen zu vervollständigen, die in Ihrer Anwendung einfach zu überprüfen, anzupassen und abzuschließen sind. + **Steigern der Effizienz von medizinischem Personal** – Statten Sie medizinisches Personal mit KI-generierten Transkripten und klinischen Notizen zusammen mit den Audiodaten der Konsultation aus, um die Durchlaufzeit der Dokumentation zu verkürzen. + **Effiziente Rekapitulation des Patientenbesuchs** – Schaffen Sie ein Erlebnis, das es den Nutzern ermöglicht, sich schnell an die wichtigsten Punkte ihres Gesprächs in Ihrer Anwendung zu erinnern. **Wichtig** Die Ergebnisse von AWS HealthScribe sind probabilistisch und aufgrund verschiedener Faktoren wie Audioqualität, Hintergrundgeräusche, Klarheit der Sprecher, Komplexität der medizinischen Terminologie, kontextspezifischer Sprachnuancen und der [Art von](https://aws.amazon.com/machine-learning/responsible-ai/policy/) maschinellem Lernen und generativer KI möglicherweise nicht immer korrekt. AWS HealthScribe ist so konzipiert, dass es Klinikern und medizinischem Fachpersonal assistieren kann. AWS HealthScribe Die Ergebnisse sollten nur für die Patientenversorgung verwendet werden, einschließlich, aber nicht beschränkt auf elektronische Patientenakten, nachdem sie von geschultem medizinischem Fachpersonal auf ihre Richtigkeit überprüft und ein fundiertes medizinisches Urteilsvermögen vorausgesetzt wurde. AWS HealthScribe Die Ergebnisse sind kein Ersatz für professionelle medizinische Beratung, Diagnose oder Behandlung und dienen nicht der Heilung, Behandlung, Linderung, Vorbeugung oder Diagnose von Krankheiten oder Gesundheitszuständen. **Topics** + [Sicherheit](#health-scribe-security-overview) + [Service-Verfügbarkeit](#health-scribe-availability) + [Technische Anforderungen](#health-scribe-tech-requirements-overview) + [Unterstützte medizinische Fachgebiete](#health-scribe-specialties) + [Arbeitsabläufe](#health-scribe-workflows) + [AWS HealthScribe Transkriptdatei](health-scribe-transcript.md) + [AWS HealthScribe Datei mit klinischer Dokumentation](health-scribe-insights.md) + [AWS HealthScribe Transkriptionsjobs](health-scribe-job.md) + [AWS HealthScribe streamen](health-scribe-streaming.md) + [Datenverschlüsselung im Ruhezustand für AWS HealthScribe](health-scribe-encryption.md) ## Sicherheit AWS HealthScribe arbeitet nach einem Modell der geteilten Verantwortung, wobei AWS Sie für den Schutz der laufenden Infrastruktur verantwortlich sind AWS HealthScribe und Sie für die Verwaltung Ihrer Daten verantwortlich sind. Weitere Informationen finden Sie unter [-Modell der geteilten Verantwortung](https://aws.amazon.com/compliance/shared-responsibility-model/). AWS HealthScribe Bietet standardmäßig Verschlüsselung im Ruhezustand, um sensible Kundendaten mithilfe von Amazon S3-verwalteten Schlüsseln zu schützen. Wenn Sie einen AWS HealthScribe Transkriptionsauftrag erstellen oder einen Stream starten, können Sie einen vom Kunden verwalteten Schlüssel angeben. Dadurch wird eine zweite Verschlüsselungsebene hinzugefügt. Weitere Informationen finden Sie unter [Datenverschlüsselung im Ruhezustand für AWS HealthScribe](health-scribe-encryption.md). ## Service-Verfügbarkeit AWS HealthScribe ist in der Region USA Ost (Nord-Virginia) verfügbar. ## Technische Anforderungen + **Unterstützte Sprache:** US-Englisch (en-US) + **Empfohlenes Audioformat:** Verlustfreies Audio (wie FLAC oder WAV) + **Kodierung: PCM 16-Bit** + **Abtastrate:** 16.000 Hz oder höher ## Unterstützte medizinische Fachgebiete AWS HealthScribe unterstützt derzeit die folgenden Fachgebiete: + Allergie-Immunologie + Kardiologie + Dermatologie + Endokrinologie + Gastroenterologie + Hämatologie/Onkologie + Infektiöse Krankheit + Nephrologie + Neurologie + FRAUENHEILKUNDE + Onkologie + Augenheilkunde + Orthopädie + Hals-Nasen-Ohrenheilkunde + Schmerzmedizin + Pädiatrie + Grundversorgung + Psychiatrie + Pulmonologie + Rheumatologie + Chirurgie + Urologie ## Arbeitsabläufe AWS HealthScribe Zu den Workflows gehören Transkriptionsaufträge und Streaming. Nachdem Sie einen Transkriptionsauftrag ausgeführt oder einen Stream abgeschlossen haben, AWS HealthScribe generiert es eine Transkriptdatei mit turn-by-turn Transkriptionsausgabe und Informationen für jede Konversationsrunde. Außerdem wird eine klinische Dokumentationsdatei mit Zusammenfassungen und Links zu Nachweisen generiert. Weitere Informationen finden Sie unter [AWS HealthScribe Transkriptdatei](health-scribe-transcript.md) und [AWS HealthScribe Datei mit klinischer Dokumentation](health-scribe-insights.md). + **Transkriptionsaufträge** — AWS HealthScribe Analysiert bei Transkriptionsaufträgen abgeschlossene Mediendateien für medizinische Konsultationen aus einem Amazon S3 S3-Bucket. Im Folgenden sind API-Operationen aufgeführt, die für AWS HealthScribe Transkriptionsaufträge spezifisch sind. + [StartMedicalScribeJob](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalScribeJob.html) + [ListMedicalScribeJobs](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ListMedicalScribeJobs.html) + [GetMedicalScribeJob](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetMedicalScribeJob.html) + [DeleteMedicalScribeJob](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_DeleteMedicalScribeJob.html) Weitere Informationen, einschließlich Codebeispielen, finden Sie unter[AWS HealthScribe Transkriptionsjobs](health-scribe-job.md). + **Streaming** — AWS HealthScribe Streaming ist ein bidirektionaler HTTP2 Echtzeitdienst, der Audiostreams auf einem Kanal akzeptiert und auf dem anderen Kanal Audiotranskriptionen anbietet. Im Folgenden sind API-Operationen aufgeführt, die für Streaming spezifisch sind: AWS HealthScribe + [StartMedicalScribeStream](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalScribeStream.html) + [GetMedicalScribeStream](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_GetMedicalScribeStream.html) Weitere Informationen, einschließlich Codebeispielen, finden Sie unter[AWS HealthScribe streamen](health-scribe-streaming.md). # AWS HealthScribe Transkriptdatei In der Transkriptdatei finden Sie zusätzlich zur turn-by-turn Standardtranskriptionsausgabe mit Zeitstempeln auf Wortebene: AWS HealthScribe + **Erkennung der Teilnehmerrolle**, sodass Sie im Gesprächsprotokoll die Patienten von den Ärzten unterscheiden können. + **Transkriptionsgliederung**, die Transkriptdialoge nach ihrer klinischen Relevanz kategorisiert, z. B. Small Talk, subjektiv, objektiv usw. Damit lassen sich bestimmte Teile des Transkripts anzeigen. + **Klinische Entitäten**, die strukturierte Informationen wie Medikamente, Erkrankungen und Behandlungen enthalten, die im Gespräch erwähnt wurden. Darüber hinaus werden für jeden Schritt die folgenden Erkenntnisse geliefert: + **Rolle des Teilnehmers** – Jeder Teilnehmer ist entweder als Arzt oder als Patient gekennzeichnet. Wenn ein Gespräch mehr als einen Teilnehmer in jeder Kategorie hat, wird jedem Teilnehmer eine Nummer zugewiesen. Zum Beispiel: `CLINICIAN_0`, `CLINICIAN_1` und `PATIENT_0`, `PATIENT_1`. + **Abschnitt** – Jeder Dialog wird einem von vier möglichen Abschnitten zugewiesen, basierend auf dem identifizierten Inhalt. + **Subjektiv** – Vom Patienten bereitgestellte Informationen zu seinen gesundheitlichen Problemen. + **Zielsetzung** – Informationen, die der Arzt im Rahmen von körperlichen Untersuchungen, Labor-, Bildgebungs- oder Diagnosetests beobachtet hat. + **Beurteilung und Plan** – Informationen, die sich auf die Beurteilung und den Behandlungsplan des Arztes beziehen. + **Besuchen Sie Flow Management** — Informationen zu Smalltalk oder Übergängen. + **Einblicke** — Extrahieren Sie klinisch relevante Entitäten (`ClinicalEntity`), die in der Konversation anwesend sind. AWS HealthScribe erkennt alle klinischen Einheiten, die von [Amazon Comprehend](https://aws.amazon.com//comprehend/medical) Medical unterstützt werden. Ein Beispiel für ein Protokoll eines Transkriptionsauftrags finden Sie in der Transkriptausgabe unter. [Beispiele für die Ausgabe von Transkriptionsjobs](starting-health-scribe-job.md#health-scribe-output-example) Ein Beispiel für ein Transkript aus dem Streaming finden Sie in der Transkriptausgabe unter. [Beispiele für die Ausgabe von Streaming-Transkriptionen](health-scribe-streaming-setting-up.md#health-scribe-streaming-output-example) # AWS HealthScribe Datei mit klinischer Dokumentation AWS HealthScribe kann eine der folgenden Vorlagen für die Zusammenfassung der klinischen Notiz verwenden. Der Standardwert ist `HISTORY_AND_PHYSICAL`. + HISTORY\$1AND\$1PHYSICAL: Enthält Zusammenfassungen der wichtigsten Abschnitte der klinischen Dokumentation. Zu den Abschnitten gehören beispielsweise Hauptbeschwerde, Vorgeschichte der aktuellen Krankheit, Überblick über die Systeme, Krankengeschichte in der Vergangenheit, Bewertung und Plan. + GIRPP: Bietet Zusammenfassungen, die auf den Fortschritten der Patienten bei der Erreichung ihrer Ziele basieren. Zu den Abschnitten gehören beispielsweise Ziel, Intervention, Reaktion, Fortschritt und Plan. + BIRP: Konzentriert sich auf die Verhaltensmuster und Reaktionen des Patienten. Zu den Abschnitten gehören beispielsweise Verhalten, Intervention, Reaktion und Plan. + SIRP: Betont den situativen Kontext der Therapie. Zu den Abschnitten gehören beispielsweise Situation, Intervention, Reaktion und Plan. + DAP: Bietet ein vereinfachtes Format für die klinische Dokumentation. Zu den Abschnitten gehören beispielsweise Daten, Bewertung und Plan. + BH\$1SOAP: Dokumentationsformat mit Fokus auf Verhaltensgesundheit. Zu den Abschnitten gehören beispielsweise „Subjektiv“, „Objektiv“, „Bewertung“ und „Plan“. + PH\$1SOAP: Dokumentationsformat mit Fokus auf körperliche Gesundheit. Zu den Abschnitten gehören beispielsweise „Subjektiv“, „Objektiv“, „Bewertung“ und „Plan“. Gehen Sie wie folgt vor, um anzugeben, welche Vorlage verwendet werden soll: + Geben Sie für Transkriptionsaufträge die Vorlage an, die im `NoteTemplate` Rahmen Ihrer [StartMedicalScribeJob](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalScribeJob.html)API-Operation verwendet werden soll. [ClinicalNoteGenerationSettings](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ClinicalNoteGenerationSettings.html)`Settings` + Für das Streaming geben Sie die Vorlage an, die in der `NoteTemplate` [ClinicalNoteGenerationSettings](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_ClinicalNoteGenerationSettings.html)`PostStreamAnalyticsSettings`von Ihnen [MedicalScribeConfigurationEvent](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_MedicalScribeConfigurationEvent.html)verwendet werden soll. ## Kontext von Medical Scribe Das `MedicalScribeContext` Objekt enthält Kontextinformationen, mit denen die Erstellung klinischer Notizen mit patientenspezifischen Details individuell angepasst werden kann. Das `MedicalScribeContext` Objekt umfasst die folgenden Komponenten: + **PatientContext**- Enthält patientenspezifische Informationen, die zur individuellen Generierung klinischer Notizen verwendet werden. Dies umfasst: + **Pronomen** — Die bevorzugten Pronomen des Patienten, die Sie als Kontext für die Erstellung klinischer Notizen angeben möchten. Diese Pronomen werden verwendet, wenn in der generierten klinischen Ausgabe auf den Patienten Bezug genommen wird. Informationen zur Einrichtung des Medical Scribe-Kontextes finden Sie unter. [MedicalScribeContext](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_MedicalScribeContext.html) **Topics** + [Kontext von Medical Scribe](#health-scribe-contextual-information) + [Abschnitte mit den Vorlagen HISTORY\$1AND\$1PHYSICAL](#health-scribe-history-physical-insights) + [Abschnitte mit GIRPP-Vorlagen](#health-scribe-GIRPP-insights) + [Abschnitte mit BIRP-Vorlagen](#health-scribe-BIRP-insights) + [Abschnitte mit SIRP-Vorlagen](#health-scribe-SIRP-insights) + [Abschnitte mit DAP-Vorlagen](#health-scribe-DAP-insights) + [Abschnitte der BH\$1SOAP-Vorlage](#health-scribe-BH-SOAP-insights) + [Abschnitte der PH\$1SOAP-Vorlage](#health-scribe-PH-SOAP-insights) ## Abschnitte mit den Vorlagen HISTORY\$1AND\$1PHYSICAL Die Insights-Vorlage HISTORY\$1AND\$1PHYSICAL umfasst die folgenden Abschnitte. | Abschnitt | Description | | --- | --- | | HAUPTBESCHWERDE | Kurze Beschreibung des Grundes des Patienten für den Besuch beim Arzt. | | VORGESCHICHTE DER AKTUELLEN KRANKHEIT | Notizen, die Informationen über die Krankheit des Patienten enthalten, einschließlich Angaben über Schweregrad, Beginn und Zeitpunkt der Symptome, aktuelle Behandlungen und betroffene Bereiche. | | SYSTEMÜBERPRÜFUNG | Bewertung von Symptomen in verschiedenen Körpersystemen nach Angaben der Patienten. | | KRANKGESCHICHTE IN DER VERGANGENHEIT | Informationen zu den früheren Erkrankungen, Operationen und Behandlungen eines Patienten. | | BEWERTUNG | Notizen, die Aufschluss über die Beurteilung des Gesundheitszustandes des Patienten durch den Arzt geben. | | PLAN | Notizen zu medizinischen Behandlungen, Anpassungen des Lebensstils und weiteren Terminen. | | KÖRPERLICHE\$1UNTERSUCHUNG | Dokumentation der Ergebnisse der körperlichen Untersuchung des Körpersystems und der Vitalfunktionen des Patienten durch den Arzt. | | VERGANGENE FAMILIENGESCHICHTE | Informationen über Gesundheitsprobleme, die in der Familie des Patienten auftreten. | | PAST\$1SOCIAL\$1HISTORY | Einzelheiten über das Sozialleben, die Gewohnheiten, den Beruf und Umweltfaktoren des Patienten, die sich auf die Gesundheit auswirken. | | DIAGNOSTISCHES TESTEN | Ergebnisse und Interpretation von Labortests, bildgebenden Studien und anderen diagnostischen Verfahren. | Jeder Satz in den `Summary` enthält `EvidenceLinks` die Angaben zu `SegmentId` den relevanten Dialogen im Protokoll, die zusammengefasst wurden. Auf diese Weise können Benutzer die Richtigkeit der Zusammenfassung in Ihrer Anwendung überprüfen. Wie die Erklärbarkeit steht auch die Gewährleistung der Rückverfolgbarkeit und Transparenz von KI-generierten Erkenntnissen mit den Prinzipien der verantwortungsvollen KI im Einklang. Die Bereitstellung dieser Verweise zusammen mit den zusammenfassenden Hinweisen an Ärzte oder medizinische Schreiberlinge trägt dazu bei, das Vertrauen zu stärken und den sicheren Einsatz von KI im klinischen Umfeld zu fördern. Ein Beispiel für eine Datei mit klinischer Dokumentation aus einem Transkriptionsauftrag finden Sie im Beispiel für eine Datei mit klinischer Dokumentation unter. [Beispiele für die Ausgabe von Transkriptionsjobs](starting-health-scribe-job.md#health-scribe-output-example) Ein Beispiel für eine Datei mit klinischer Dokumentation aus dem Streaming finden Sie im [Beispiele für die Ausgabe von Streaming-Transkriptionen](health-scribe-streaming-setting-up.md#health-scribe-streaming-output-example) Beispiel für eine Datei mit klinischer Dokumentation unter. ## Abschnitte mit GIRPP-Vorlagen Die GIRPP-Insights-Vorlage umfasst die folgenden Abschnitte. | Abschnitt | Description | | --- | --- | | Ziel | Das identifizierte Problem, die Herausforderung oder das Verhalten, das durch eine Behandlung angegangen werden muss. | | Intervention | Die spezifische Behandlung, Methode oder Technik, mit der der Arzt dem Patienten hilft, das festgelegte Ziel zu erreichen. | | Antwort | Wie der Patient auf die Intervention reagiert hat, einschließlich seiner Beteiligung, seiner Reaktionen und seines Feedbacks. | | Progress | Einschätzung der Fortschritte beim Erreichen der Behandlungsziele durch den Arzt, einschließlich Beobachtungen von Verbesserungen oder Hindernissen beim Patienten. | | Plan | Die nächsten Behandlungsschritte, einschließlich future Interventionen, Hausaufgaben und Überweisungen. | ## Abschnitte mit BIRP-Vorlagen Die BIRP-Insights-Vorlage umfasst die folgenden Abschnitte. | Abschnitt | Description | | --- | --- | | Behavior | Die Probleme, mit denen der Patient konfrontiert ist, und seine Reaktion auf die Behandlung. | | Intervention | Die spezifische Behandlung, Methode oder Technik, mit der der Arzt dem Patienten hilft, das festgelegte Ziel zu erreichen. | | Antwort | Wie der Patient auf die Intervention reagiert hat, einschließlich seiner Beteiligung, seiner Reaktionen und seines Feedbacks. | | Plan | Die nächsten Behandlungsschritte, einschließlich future Interventionen, Hausaufgaben und Überweisungen. | ## Abschnitte mit SIRP-Vorlagen Die SIRP-Insights-Vorlage umfasst die folgenden Abschnitte. | Abschnitt | Description | | --- | --- | | Situation | Das Problem, mit dem der Patient konfrontiert ist, und sein Ziel für die Suche nach einer Therapie. | | Intervention | Die spezifische Behandlung, Methode oder Technik, mit der der Arzt dem Patienten hilft, das festgelegte Ziel zu erreichen. | | Antwort | Wie der Patient auf die Intervention reagiert hat, einschließlich seiner Beteiligung, seiner Reaktionen und seines Feedbacks. | | Plan | Die nächsten Behandlungsschritte, einschließlich future Interventionen, Hausaufgaben und Überweisungen. | ## Abschnitte mit DAP-Vorlagen Die Vorlage für DAP Insights umfasst die folgenden Abschnitte. | Abschnitt | Description | | --- | --- | | Daten | Die Gründe des Patienten für die Inanspruchnahme einer Behandlung und Informationen über den Patienten. | | Bewertung | Die Diagnose der Situation des Patienten durch den Arzt. | | Plan | Die nächsten Behandlungsschritte, einschließlich future Interventionen, Hausaufgaben und Überweisungen. | ## Abschnitte der BH\$1SOAP-Vorlage Die Vorlage BH\$1SOAP Insights umfasst die folgenden Abschnitte. | Abschnitt | Description | | --- | --- | | Subjektiv | Die Behandlungsziele des Klienten und seine Erfahrungen sowie bestehende und vergangene Probleme. | | Ziel | Daten und Fakten über den Kunden. | | Bewertung | Die Diagnose der Situation des Patienten durch den Arzt. | | Plan | Die nächsten Behandlungsschritte, einschließlich future Interventionen, Hausaufgaben und Überweisungen. | ## Abschnitte der PH\$1SOAP-Vorlage Die Vorlage PH\$1SOAP Insights umfasst die folgenden Abschnitte. | Abschnitt | Description | | --- | --- | | Subjektiv | Die Behandlungsziele des Klienten und seine Erfahrungen sowie bestehende und vergangene Probleme. | | Ziel | Daten und Fakten über den Kunden. | | Bewertung | Die Diagnose der Situation des Patienten durch den Arzt. | | Plan | Die nächsten Behandlungsschritte, einschließlich future Interventionen, Hausaufgaben und Überweisungen. | # AWS HealthScribe Transkriptionsjobs Ein AWS HealthScribe Transkriptionsjob verarbeitet Mediendateien aus einem Amazon S3 S3-Bucket. [Bei der Verarbeitung einer Mediendatei werden Gespräche zwischen Patient und Arzt transkribiert und medizinische Konsultationen analysiert, um zwei JSON-Ausgabedateien zu erstellen: eine [Transkriptdatei](https://docs.aws.amazon.com/transcribe/latest/dg/health-scribe-job.html#health-scribe-output-example) und eine klinische Dokumentationsdatei.](https://docs.aws.amazon.com/transcribe/latest/dg/health-scribe-job.html#health-scribe-output-example) Die folgenden API-Operationen sind spezifisch für Transkriptionsaufträge: AWS HealthScribe + [StartMedicalScribeJob](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalScribeJob.html) + [ListMedicalScribeJobs](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ListMedicalScribeJobs.html) + [GetMedicalScribeJob](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetMedicalScribeJob.html) + [DeleteMedicalScribeJob](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_DeleteMedicalScribeJob.html) # Starten eines AWS HealthScribe Transkriptionsauftrags Sie können einen AWS HealthScribe Job mit der AWS CLI oder starten AWS SDKs. ## AWS CLI In diesem Beispiel wird der [start-medical-scribe-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-medical-scribe-job.html)Befehl verwendet. Weitere Informationen finden Sie unter [StartMedicalScribeJob](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalScribeJob.html). ``` aws transcribe start-medical-scribe-job \ --region us-west-2 \ --medical-scribe-job-name my-first-medical-scribe-job \ --media MediaFileUri=s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac \ --output-bucket-name amzn-s3-demo-bucket \ --DataAccessRoleArn=arn:aws:iam::111122223333:role/ExampleRole \ --settings ShowSpeakerLabels=false,ChannelIdentification=true \ --channel-definitions ChannelId=0,ParticipantRole=CLINICIAN ChannelId=1,ParticipantRole=PATIENT ``` Hier ist ein weiteres Beispiel, in dem der [start-medical-scribe-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-medical-scribe-job.html)Befehl verwendet wird, und ein Anforderungstext mit zusätzlichen Einstellungen. ``` aws transcribe start-medical-scribe-job \ --region us-west-2 \ --cli-input-json file://filepath/my-first-medical-scribe-job.json ``` Die Datei `my-first-medical-scribe-job.json` enthält den folgenden Anforderungstext. ``` { "MedicalScribeJobName": "my-first-medical-scribe-job", "Media": { "MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac" }, "OutputBucketName": "amzn-s3-demo-bucket", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole", "Settings": { "ShowSpeakerLabels": false, "ChannelIdentification": true }, "ChannelDefinitions": [ { "ChannelId": 0, "ParticipantRole":"CLINICIAN" }, { "ChannelId": 1, "ParticipantRole":"PATIENT" } ] } ``` ## AWS SDK für Python (Boto3) Im folgenden Beispiel wird die verwendet, AWS SDK für Python (Boto3) um eine [start\$1medical\$1scribe\$1job-Anfrage](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe/client/start_medical_scribe_job.html) zu stellen. Weitere Informationen finden Sie unter [StartMedicalScribeJob](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalScribeJob.html). ``` from __future__ import print_functionimport timeimport boto3 transcribe = boto3.client('transcribe', 'us-west-2') job_name = "my-first-medical-scribe-job" job_uri = "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac" transcribe.start_medical_scribe_job( MedicalScribeJobName = job_name, Media = { 'MediaFileUri': job_uri }, OutputBucketName = 'amzn-s3-demo-bucket', DataAccessRoleArn = 'arn:aws:iam::111122223333:role/ExampleRole', Settings = { 'ShowSpeakerLabels': false, 'ChannelIdentification': true }, ChannelDefinitions = [ { 'ChannelId': 0, 'ParticipantRole': 'CLINICIAN' }, { 'ChannelId': 1, 'ParticipantRole': 'PATIENT' } ] ) while True: status = transcribe.get_medical_scribe_job(MedicalScribeJobName = job_name) if status['MedicalScribeJob']['MedicalScribeJobStatus'] in ['COMPLETED', 'FAILED']: break print("Not ready yet...") time.sleep(5) print(status) ``` **Anmerkung** Die AWS Management Console unterstützt derzeit keine Jobs. AWS HealthScribe ## Beispiele für die Ausgabe von Transkriptionsjobs Zusätzlich zu einem Transkript erzeugen `StartMedicalScribeJob`-Anforderungen eine separate Datei mit klinischer Dokumentation. Beide Dateien haben das JSON-Format und werden an dem Ausgabeort gespeichert, den Sie in Ihrer Anfrage angeben. Hier finden Sie Beispiele für die einzelnen Ausgabearten: ### Beispiel einer Transkriptionsausgabe Eine AWS HealthScribe Transkriptdatei (aus einer `StartMedicalScribeJob` Anfrage) hat das folgende Format: ``` { "Conversation": { "ConversationId": "sampleConversationUUID", "JobName": "sampleJobName", "JobType": "ASYNC", "LanguageCode": "en-US", "ClinicalInsights": [ { "Attributes": [], "Category": "MEDICAL_CONDITION", "InsightId": "insightUUID1", "InsightType": "ClinicalEntity", "Spans": [ { "BeginCharacterOffset": 12, "Content": "pain", "EndCharacterOffset": 15, "SegmentId": "uuid1" } ], "Type": "DX_NAME" }, { "Attributes": [], "Category": "TEST_TREATMENT_PROCEDURE", "InsightId": "insightUUID2", "InsightType": "ClinicalEntity", "Spans": [ { "BeginCharacterOffset": 4, "Content": "mammogram", "EndCharacterOffset": 12, "SegmentId": "uuid2" } ], "Type": "TEST_NAME" }, { "Attributes": [], "Category": "TEST_TREATMENT_PROCEDURE", "InsightId": "insightUUID3", "InsightType": "ClinicalEntity", "Spans": [ { "BeginCharacterOffset": 15, "Content": "pap smear", "EndCharacterOffset": 23, "SegmentId": "uuid3" } ], "Type": "TEST_NAME" }, { "Attributes": [], "Category": "MEDICATION", "InsightId": "insightUUID4", "InsightType": "ClinicalEntity", "Spans": [ { "BeginCharacterOffset": 28, "Content": "phentermine", "EndCharacterOffset": 38, "SegmentId": "uuid4" } ], "Type": "GENERIC_NAME" }, { "Attributes": [ { "AttributeId": "attributeUUID1", "Spans": [ { "BeginCharacterOffset": 38, "Content": "high", "EndCharacterOffset": 41, "SegmentId": "uuid5" } ], "Type": "TEST_VALUE" } ], "Category": "TEST_TREATMENT_PROCEDURE", "InsightId": "insightUUID5", "InsightType": "ClinicalEntity", "Spans": [ { "BeginCharacterOffset": 14, "Content": "weight", "EndCharacterOffset": 19, "SegmentId": "uuid6" } ], "Type": "TEST_NAME" }, { "Attributes": [], "Category": "ANATOMY", "InsightId": "insightUUID6", "InsightType": "ClinicalEntity", "Spans": [ { "BeginCharacterOffset": 60, "Content": "heart", "EndCharacterOffset": 64, "SegmentId": "uuid7" } ], "Type": "SYSTEM_ORGAN_SITE" } ], "TranscriptItems": [ { "Alternatives": [ { "Confidence": 0.7925, "Content": "Okay" } ], "BeginAudioTime": 0.16, "EndAudioTime": 0.6, "Type": "PRONUNCIATION" }, { "Alternatives": [ { "Confidence": 0, "Content": "." } ], "BeginAudioTime": 0.17, "EndAudioTime": 0.9, "Type": "PUNCTUATION" }, { "Alternatives": [ { "Confidence": 1, "Content": "Good" } ], "BeginAudioTime": 0.61, "EndAudioTime": 0.92, "Type": "PRONUNCIATION" }, { "Alternatives": [ { "Confidence": 1, "Content": "afternoon" } ], "BeginAudioTime": 0.92, "EndAudioTime": 1.54, "Type": "PRONUNCIATION" }, { "Alternatives": [ { "Confidence": 0, "Content": "." } ], "BeginAudioTime": 0, "EndAudioTime": 0, "Type": "PUNCTUATION" }, { "Alternatives": [ { "Confidence": 0.9924, "Content": "You" } ], "BeginAudioTime": 1.55, "EndAudioTime": 1.88, "Type": "PRONUNCIATION" }, { "Alternatives": [ { "Confidence": 1, "Content": "lost" } ], "BeginAudioTime": 1.88, "EndAudioTime": 2.19, "Type": "PRONUNCIATION" }, { "Alternatives": [ { "Confidence": 1, "Content": "one" } ], "BeginAudioTime": 2.19, "EndAudioTime": 2.4, "Type": "PRONUNCIATION" }, { "Alternatives": [ { "Confidence": 1, "Content": "lb" } ], "BeginAudioTime": 2.4, "EndAudioTime": 2.97, "Type": "PRONUNCIATION" } ], "TranscriptSegments": [ { "BeginAudioTime": 0.16, "Content": "Okay.", "EndAudioTime": 0.6, "ParticipantDetails": { "ParticipantRole": "CLINICIAN_0" }, "SectionDetails": { "SectionName": "SUBJECTIVE" }, "SegmentId": "uuid1" }, { "BeginAudioTime": 0.61, "Content": "Good afternoon.", "EndAudioTime": 1.54, "ParticipantDetails": { "ParticipantRole": "CLINICIAN_0" }, "SectionDetails": { "SectionName": "OTHER" }, "SegmentId": "uuid2" }, { "BeginAudioTime": 1.55, "Content": "You lost one lb.", "EndAudioTime": 2.97, "ParticipantDetails": { "ParticipantRole": "CLINICIAN_0" }, "SectionDetails": { "SectionName": "SUBJECTIVE" }, "SegmentId": "uuid3" }, { "BeginAudioTime": 2.98, "Content": "Yeah, I think it, uh, do you feel more energy?", "EndAudioTime": 6.95, "ParticipantDetails": { "ParticipantRole": "CLINICIAN_0" }, "SectionDetails": { "SectionName": "SUBJECTIVE" }, "SegmentId": "uuid5" }, { "BeginAudioTime": 6.96, "Content": "Yes.", "EndAudioTime": 7.88, "ParticipantDetails": { "ParticipantRole": "CLINICIAN_0" }, "SectionDetails": { "SectionName": "SUBJECTIVE" }, "SegmentId": "uuid6" }, { "BeginAudioTime": 7.89, "Content": "Uh, how about craving for the carbohydrate or sugar or fat or anything?", "EndAudioTime": 17.93, "ParticipantDetails": { "ParticipantRole": "CLINICIAN_0" }, "SectionDetails": { "SectionName": "SUBJECTIVE" }, "SegmentId": "uuid7" } ] } } ``` Hier ist ein weiteres Beispiel, in dem der [start-medical-scribe-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-medical-conversation-intelligence-job.html)Befehl verwendet wird, und ein Anforderungstext mit zusätzlichen Einstellungen. ``` aws transcribe start-medical-scribe-job \ --region us-west-2 \ --cli-input-json file://filepath/my-first-medical-scribe-job.json ``` Die Datei `my-first-medical-scribe-job.json` enthält den folgenden Anforderungstext. ``` { "MedicalScribeJobName": "my-first-medical-scribe-job", "Media": { "MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac" }, "OutputBucketName": "amzn-s3-demo-bucket", "DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole", "Settings": { "ShowSpeakerLabels": false, "ChannelIdentification": true }, "ChannelDefinitions": [ { "ChannelId": 0, "ParticipantRole":"CLINICIAN" }, { "ChannelId": 1, "ParticipantRole":"PATIENT" } ] } ``` ### Beispiel für die Ausgabe klinischer Dokumentation Eine Datei mit Dokumentationseinblicken (aus einer `StartMedicalScribeJob`-Anfrage) hat folgendes Format: ``` { "ClinicalDocumentation": { "Sections": [ { "SectionName": "CHIEF_COMPLAINT", "Summary": [ { "EvidenceLinks": [ { "SegmentId": "uuid1" }, { "SegmentId": "uuid2" }, { "SegmentId": "uuid3" }, { "SegmentId": "uuid4" }, { "SegmentId": "uuid5" }, { "SegmentId": "uuid6" } ], "SummarizedSegment": "Weight loss." } ] }, { "SectionName": "HISTORY_OF_PRESENT_ILLNESS", "Summary": [ { "EvidenceLinks": [ { "SegmentId": "uuid7" }, { "SegmentId": "uuid8" }, { "SegmentId": "uuid9" }, { "SegmentId": "uuid10" } ], "SummarizedSegment": "The patient is seen today for a follow-up of weight loss." }, { "EvidenceLinks": [ { "SegmentId": "uuid11" }, { "SegmentId": "uuid12" }, { "SegmentId": "uuid13" } ], "SummarizedSegment": "They report feeling more energy and craving carbohydrates, sugar, and fat." }, { "EvidenceLinks": [ { "SegmentId": "uuid14" }, { "SegmentId": "uuid15" }, { "SegmentId": "uuid16" } ], "SummarizedSegment": "The patient is up to date on their mammogram and pap smear." }, { "EvidenceLinks": [ { "SegmentId": "uuid17" }, { "SegmentId": "uuid18" }, { "SegmentId": "uuid19" }, { "SegmentId": "uuid20" } ], "SummarizedSegment": "The patient is taking phentermine and would like to continue." } ] }, { "SectionName": "REVIEW_OF_SYSTEMS", "Summary": [ { "EvidenceLinks": [ { "SegmentId": "uuid21" }, { "SegmentId": "uuid22" } ], "SummarizedSegment": "Patient reports intermittent headaches, occasional chest pains but denies any recent fevers or chills." }, { "EvidenceLinks": [ { "SegmentId": "uuid23" }, { "SegmentId": "uuid24" } ], "SummarizedSegment": "No recent changes in vision, hearing, or any respiratory complaints." } ] }, { "SectionName": "PAST_MEDICAL_HISTORY", "Summary": [ { "EvidenceLinks": [ { "SegmentId": "uuid25" }, { "SegmentId": "uuid26" } ], "SummarizedSegment": "Patient has a history of hypertension and was diagnosed with Type II diabetes 5 years ago." }, { "EvidenceLinks": [ { "SegmentId": "uuid27" }, { "SegmentId": "uuid28" } ], "SummarizedSegment": "Underwent an appendectomy in the early '90s and had a fracture in the left arm during childhood." } ] }, { "SectionName": "ASSESSMENT", "Summary": [ { "EvidenceLinks": [ { "SegmentId": "uuid29" }, { "SegmentId": "uuid30" } ], "SummarizedSegment": "Weight loss" } ] }, { "SectionName": "PLAN", "Summary": [ { "EvidenceLinks": [ { "SegmentId": "uuid31" }, { "SegmentId": "uuid32" }, { "SegmentId": "uuid33" }, { "SegmentId": "uuid34" } ], "SummarizedSegment": "For the condition of Weight loss: The patient was given a 30-day supply of phentermine and was advised to follow up in 30 days." } ] } ] } } ``` # AWS HealthScribe streamen Mit AWS HealthScribe Streaming können Sie medizinische Gespräche in Echtzeit transkribieren. AWS HealthScribe Streaming ist ein bidirektionaler HTTP2 Echtzeitdienst, der Audiostreams auf einem Kanal akzeptiert und eine Audiotranskription auf dem anderen Kanal verkauft. AWS HealthScribe Analysiert nach Abschluss des Streamings den Inhalt des Streams und erstellt eine JSON-Datei mit Transkript und eine JSON-Datei für klinische Notizen. Verwenden Sie den [StartMedicalScribeStream](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalScribeStream.html)API-Vorgang, um das Streaming zu starten. Diese API startet einen HTTP2 basierten bidirektionalen Kanal, den Sie zum Streamen von Audioereignissen verwenden. Wenn Sie einen Stream starten, geben Sie zunächst die Stream-Konfiguration in a `MedicalScribeConfigurationEvent` an. Dieses Ereignis umfasst Kanaldefinitionen, Verschlüsselungseinstellungen und Einstellungen für die Post-Stream-Analyse, z. B. die Ausgabekonfiguration für aggregierte Transkripte und die Generierung klinischer Notizen. Nachdem Sie mit dem Audio-Streaming begonnen haben, verwalten Sie den Stream wie folgt: + Wenn Sie fertig sind und mit der Verarbeitung der Ergebnisse mit der Post-Stream-Analyse beginnen möchten, senden Sie ein Zeichen `MedicalScribeSessionControlEvent` mit dem Zeichen `Type` von `END_OF_SESSION` und AWS HealthScribe starten Sie die Analyse. + Um das Streaming zu unterbrechen, schließen Sie den Eingabestream ab, ohne das `MedicalScribeSessionControlEvent` zu senden. + Um einen angehaltenen Stream wieder aufzunehmen, verwenden Sie den `StartMedicalScribeStream` API-Vorgang und geben Sie ihn an. `SessionId` Dies ist der, den `SessionId` Sie verwendet haben, als Sie den Stream ursprünglich gestartet haben. **Topics** + [Richtlinien und Anforderungen](#health-scribe-streaming-requirements) + [ResourceAccessRoleArn Rollen, Berechtigungen](#health-scribe-data-access-role) + [Die AWS HealthScribe Streaming-Transkription wird gestartet](health-scribe-streaming-setting-up.md) ## Richtlinien und Anforderungen Im Folgenden finden Sie Richtlinien und Anforderungen für das AWS HealthScribe Streaming: + Bevor Sie Audioereignisse senden, müssen Sie zunächst die Stream-Konfiguration in a angeben`[MedicalScribeConfigurationEvent](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_MedicalScribeConfigurationEvent.html)`. + Um Post-Stream-Analysen ausführen zu können, `MedicalScribeConfigurationEvent` müssen Sie über die richtigen Berechtigungen verfügen. `ResourceAccessRoleArn` Weitere Informationen finden Sie unter [ResourceAccessRoleArn Rollen, Berechtigungen](#health-scribe-data-access-role). + Sie können eine Sitzung innerhalb von 5 Stunden nach der ersten Stream-Erstellung beliebig oft wieder aufnehmen. + Sie können in einer Sitzung für alle Streaming-Anfragen maximal 2 Stunden Audio streamen. + AWS HealthScribe Bietet standardmäßig Verschlüsselung im Ruhezustand, um sensible Kundendaten mithilfe von Amazon S3-verwalteten Schlüsseln zu schützen. Wenn Sie einen Stream starten, können Sie einen AWS KMS Schlüssel für eine zweite Verschlüsselungsebene angeben. Sie `ResourceAccessRoleArn` müssen die Erlaubnis haben, Ihren AWS KMS Schlüssel zu verwenden. Weitere Informationen finden Sie unter [Datenverschlüsselung im Ruhezustand für AWS HealthScribe](health-scribe-encryption.md). + Sie können AWS HealthScribe Streaming mit dem verwenden AWS SDKs, mit Ausnahme des SDK for Python (Boto3) und des SDK for PHP. + Wenn nach dem Beenden eines Streams eine `LimitExceededException` Ausnahme auftritt, können Sie die Sitzung neu starten und trotzdem Analysen nach dem Stream generieren. Verwenden Sie die [StartMedicalScribeStream](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalScribeStream.html)API und verwenden Sie dieselbe`SessionID`, um den Stream neu zu starten. Senden Sie dann eine `MedicalScribeSessionControlEvent` mit einem `Type` von `END_OF_SESSION` und AWS HealthScribe starten Sie die Analyse. ## ResourceAccessRoleArn Rollen, Berechtigungen Um Post-Stream-Analysen ausführen zu können, `MedicalScribeConfigurationEvent` muss Ihr `ResourceAccessRoleArn` in der Lage sein, auf Ihren Amazon S3 S3-Ausgabe-Bucket und, falls Sie ihn angeben, auf Ihren AWS KMS Schlüssel zuzugreifen. Außerdem muss die Vertrauensrichtlinie der Rolle dem `transcribe.streaming.amazonaws.com` Service die Erlaubnis erteilen, die Rolle zu übernehmen. Im Folgenden finden Sie ein Beispiel für eine IAM-Richtlinie, die Amazon S3 S3-Bucket-Berechtigungen und AWS KMS Schlüsselberechtigungen gewährt. Weitere Informationen finden Sie unter [Datenverschlüsselung im Ruhezustand für AWS HealthScribe](health-scribe-encryption.md). ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "s3:PutObject" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket", "arn:aws:s3:::amzn-s3-demo-bucket/*" ], "Effect": "Allow" }, { "Action": [ "kms:DescribeKey", "kms:Decrypt", "kms:Encrypt", "kms:GenerateDataKey*" ], "Resource": "arn:aws:kms:us-west-2:123456789012:key/1234abcd-12ab-34cd-56ef-123456SAMPLE", "Effect": "Allow" } ] } ``` ------ Im Folgenden finden Sie ein Beispiel für eine Vertrauensrichtlinie. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": [ "transcribe.streaming.amazonaws.com" ] }, "Action": "sts:AssumeRole" } ] } ``` ------ # Die AWS HealthScribe Streaming-Transkription wird gestartet Das folgende Codebeispiel zeigt, wie Sie eine AWS HealthScribe Streaming-Transkription mit dem einrichten. AWS SDKs **Topics** + [SDK für Java 2.x](#health-scribe-java-stream) + [Beispiele für die Ausgabe von Streaming-Transkriptionen](#health-scribe-streaming-output-example) ## SDK für Java 2.x Das folgende Beispiel verwendet das SDK for Java 2.x, um Streaming einzurichten und eine [StartMedicalScribeStream](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalScribeStream.html)Anfrage zu stellen. ``` package org.example; import io.reactivex.rxjava3.core.BackpressureStrategy; import io.reactivex.rxjava3.core.Flowable; import org.reactivestreams.Publisher; import org.reactivestreams.Subscriber; import software.amazon.awssdk.auth.credentials.AwsCredentialsProvider; import software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider; import software.amazon.awssdk.core.SdkBytes; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.transcribestreaming.TranscribeStreamingAsyncClient; import software.amazon.awssdk.services.transcribestreaming.model.ClinicalNoteGenerationSettings; import software.amazon.awssdk.services.transcribestreaming.model.LanguageCode; import software.amazon.awssdk.services.transcribestreaming.model.MediaEncoding; import software.amazon.awssdk.services.transcribestreaming.model.MedicalScribeInputStream; import software.amazon.awssdk.services.transcribestreaming.model.MedicalScribePostStreamAnalyticsSettings; import software.amazon.awssdk.services.transcribestreaming.model.MedicalScribeSessionControlEventType; import software.amazon.awssdk.services.transcribestreaming.model.MedicalScribeTranscriptEvent; import software.amazon.awssdk.services.transcribestreaming.model.MedicalScribeTranscriptSegment; import software.amazon.awssdk.services.transcribestreaming.model.StartMedicalScribeStreamRequest; import software.amazon.awssdk.services.transcribestreaming.model.StartMedicalScribeStreamResponseHandler; import software.amazon.awssdk.services.transcribestreaming.model.medicalscribeinputstream.DefaultConfigurationEvent; import software.amazon.awssdk.http.nio.netty.NettyNioAsyncHttpClient; import javax.sound.sampled.AudioFormat; import javax.sound.sampled.AudioInputStream; import javax.sound.sampled.AudioSystem; import javax.sound.sampled.DataLine; import javax.sound.sampled.LineUnavailableException; import javax.sound.sampled.TargetDataLine; import java.io.BufferedInputStream; import java.io.IOException; import java.io.InputStream; import java.io.UncheckedIOException; import java.util.Arrays; import java.util.concurrent.CompletableFuture; public class HealthScribeStreamingDemoApp { private static final int CHUNK_SIZE_IN_BYTES = 6400; private static final int SAMPLE_RATE = 16000; private static final Region REGION = Region.US_EAST_1; private static final String sessionId = "1234abcd-12ab-34cd-56ef-123456SAMPLE"; private static final String bucketName = "amzn-s3-demo-bucket"; private static final String resourceAccessRoleArn = "arn:aws:iam::123456789012:role/resource-access-role"; private static TranscribeStreamingAsyncClient client; public static void main(String args[]) { client = TranscribeStreamingAsyncClient.builder() .credentialsProvider(getCredentials()) .httpClientBuilder(NettyNioAsyncHttpClient.builder()) .region(REGION) .build(); try { StartMedicalScribeStreamRequest request = StartMedicalScribeStreamRequest.builder() .languageCode(LanguageCode.EN_US.toString()) .mediaSampleRateHertz(SAMPLE_RATE) .mediaEncoding(MediaEncoding.PCM.toString()) .sessionId(sessionId) .build(); MedicalScribeInputStream endSessionEvent = MedicalScribeInputStream.sessionControlEventBuilder() .type(MedicalScribeSessionControlEventType.END_OF_SESSION) .build(); CompletableFuture result = client.startMedicalScribeStream( request, new AudioStreamPublisher(getStreamFromMic(), getConfigurationEvent(),endSessionEvent), getMedicalScribeResponseHandler()); result.get(); client.close(); } catch (Exception e) { System.err.println("Error occurred: " + e.getMessage()); e.printStackTrace(); } } private static AudioInputStream getStreamFromMic() throws LineUnavailableException { // Signed PCM AudioFormat with 16kHz, 16 bit sample size, mono AudioFormat format = new AudioFormat(SAMPLE_RATE, 16, 1, true, false); DataLine.Info info = new DataLine.Info(TargetDataLine.class, format); if (!AudioSystem.isLineSupported(info)) { System.out.println("Line not supported"); throw new LineUnavailableException("The audio system microphone line is not supported."); } TargetDataLine line = (TargetDataLine) AudioSystem.getLine(info); int bufferSize = (CHUNK_SIZE_IN_BYTES / format.getFrameSize()) * format.getFrameSize(); line.open(format); line.start(); // Create a wrapper class that can be closed when Enter is pressed AudioInputStream audioStream = new AudioInputStream(line); // Start a thread to monitor for Enter key System.out.println("Recording... Press Enter to stop"); Thread monitorThread = new Thread(() -> { try { System.in.read(); line.stop(); line.close(); } catch (IOException e) { e.printStackTrace(); } }); monitorThread.setDaemon(true); // Set as daemon thread so it doesn't prevent JVM shutdown monitorThread.start(); return new AudioInputStream( new BufferedInputStream(new AudioInputStream(line)), format, AudioSystem.NOT_SPECIFIED ); } private static AwsCredentialsProvider getCredentials() { return DefaultCredentialsProvider.create(); } private static StartMedicalScribeStreamResponseHandler getMedicalScribeResponseHandler() { return StartMedicalScribeStreamResponseHandler.builder() .onResponse(r -> { System.out.println("Received Initial response"); }) .onError(Throwable::printStackTrace) .onComplete(() -> { System.out.println("=== All records streamed successfully ==="); }) .subscriber(event -> { if (event instanceof MedicalScribeTranscriptEvent) { MedicalScribeTranscriptSegment segment = ((MedicalScribeTranscriptEvent) event).transcriptSegment(); if (segment != null && segment.content() != null && !segment.content().isEmpty()) { System.out.println(segment.content()); } } }) .build(); } private static DefaultConfigurationEvent getConfigurationEvent() { MedicalScribePostStreamAnalyticsSettings postStreamSettings = MedicalScribePostStreamAnalyticsSettings .builder() .clinicalNoteGenerationSettings( ClinicalNoteGenerationSettings.builder() .outputBucketName(bucketName) .build() ) .build(); return (DefaultConfigurationEvent) MedicalScribeInputStream.configurationEventBuilder() .resourceAccessRoleArn(resourceAccessRoleArn) .postStreamAnalyticsSettings(postStreamSettings) .build(); } private static class AudioStreamPublisher implements Publisher { private final InputStream audioInputStream; private final MedicalScribeInputStream configEvent; private final MedicalScribeInputStream endSessionEvent; private AudioStreamPublisher(AudioInputStream audioInputStream, MedicalScribeInputStream configEvent, MedicalScribeInputStream endSessionEvent) { this.audioInputStream = audioInputStream; this.configEvent = configEvent; this.endSessionEvent = endSessionEvent; } @Override public void subscribe(Subscriber subscriber) { createAudioFlowable() .doOnComplete(() -> { try { audioInputStream.close(); } catch (IOException e) { throw new UncheckedIOException(e); } }) .subscribe(subscriber); } private Flowable createAudioFlowable() { // Start with config event Flowable configFlow = Flowable.just(configEvent); // Create audio chunk flowable Flowable audioFlow = Flowable.create(emitter -> { byte[] buffer = new byte[CHUNK_SIZE_IN_BYTES]; int bytesRead; try { while (!emitter.isCancelled() && (bytesRead = audioInputStream.read(buffer)) > 0) { byte[] audioData = bytesRead < buffer.length ? Arrays.copyOfRange(buffer, 0, bytesRead) : buffer; MedicalScribeInputStream audioEvent = MedicalScribeInputStream.audioEventBuilder() .audioChunk(SdkBytes.fromByteArray(audioData)) .build(); emitter.onNext(audioEvent); } emitter.onComplete(); } catch (IOException e) { emitter.onError(e); } }, BackpressureStrategy.BUFFER); // End with session end event Flowable endFlow = Flowable.just(endSessionEvent); // Concatenate all flows return Flowable.concat(configFlow, audioFlow, endFlow); } } } ``` ## Beispiele für die Ausgabe von Streaming-Transkriptionen AWS HealthScribe Analysiert nach Abschluss des Streamings den Inhalt des Streams und erstellt eine JSON-Datei mit Transkript und eine JSON-Datei für klinische Notizen. Hier finden Sie Beispiele für die einzelnen Ausgabearten: ### Beispiel einer Transkriptionsausgabe Im Folgenden finden Sie ein Beispiel für eine AWS HealthScribe Transkriptdatei aus einer Streaming-Sitzung. ``` { "Conversation": { "ClinicalInsights": [{ "Attributes": [], "Category": "MEDICAL_CONDITION", "InsightId": "insightUUID1", "InsightType": "ClinicalEntity", "Spans": [{ "BeginCharacterOffset": 12, "Content": "pain", "EndCharacterOffset": 15, "SegmentId": "uuid1" }], "Type": "DX_NAME" }, { "Attributes": [], "Category": "TEST_TREATMENT_PROCEDURE", "InsightId": "insightUUID2", "InsightType": "ClinicalEntity", "Spans": [{ "BeginCharacterOffset": 4, "Content": "mammogram", "EndCharacterOffset": 12, "SegmentId": "uuid2" }], "Type": "TEST_NAME" }, { "Attributes": [], "Category": "TEST_TREATMENT_PROCEDURE", "InsightId": "insightUUID3", "InsightType": "ClinicalEntity", "Spans": [{ "BeginCharacterOffset": 15, "Content": "pap smear", "EndCharacterOffset": 23, "SegmentId": "uuid3" }], "Type": "TEST_NAME" }, { "Attributes": [], "Category": "MEDICATION", "InsightId": "insightUUID4", "InsightType": "ClinicalEntity", "Spans": [{ "BeginCharacterOffset": 28, "Content": "phentermine", "EndCharacterOffset": 38, "SegmentId": "uuid4" }], "Type": "GENERIC_NAME" }, { "Attributes": [{ "AttributeId": "attributeUUID1", "Spans": [{ "BeginCharacterOffset": 38, "Content": "high", "EndCharacterOffset": 41, "SegmentId": "uuid5" }], "Type": "TEST_VALUE" }], "Category": "TEST_TREATMENT_PROCEDURE", "InsightId": "insightUUID5", "InsightType": "ClinicalEntity", "Spans": [{ "BeginCharacterOffset": 14, "Content": "weight", "EndCharacterOffset": 19, "SegmentId": "uuid6" }], "Type": "TEST_NAME" }, { "Attributes": [], "Category": "ANATOMY", "InsightId": "insightUUID6", "InsightType": "ClinicalEntity", "Spans": [{ "BeginCharacterOffset": 60, "Content": "heart", "EndCharacterOffset": 64, "SegmentId": "uuid7" }], "Type": "SYSTEM_ORGAN_SITE" }], "ConversationId": "sampleConversationUUID", "LanguageCode": "en-US", "SessionId": "sampleSessionUUID", "TranscriptItems": [{ "Alternatives": [{ "Confidence": 0.7925, "Content": "Okay" }], "BeginAudioTime": 0.16, "EndAudioTime": 0.6, "Type": "PRONUNCIATION" }, { "Alternatives": [{ "Confidence": 0, "Content": "." }], "BeginAudioTime": 0, "EndAudioTime": 0, "Type": "PUNCTUATION" }, { "Alternatives": [{ "Confidence": 1, "Content": "Good" }], "BeginAudioTime": 0.61, "EndAudioTime": 0.92, "Type": "PRONUNCIATION" }, { "Alternatives": [{ "Confidence": 1, "Content": "afternoon" }], "BeginAudioTime": 0.92, "EndAudioTime": 1.54, "Type": "PRONUNCIATION" }, { "Alternatives": [{ "Confidence": 0, "Content": "." }], "BeginAudioTime": 0, "EndAudioTime": 0, "Type": "PUNCTUATION" }, { "Alternatives": [{ "Confidence": 0.9924, "Content": "You" }], "BeginAudioTime": 1.55, "EndAudioTime": 1.88, "Type": "PRONUNCIATION" }, { "Alternatives": [{ "Confidence": 1, "Content": "lost" }], "BeginAudioTime": 1.88, "EndAudioTime": 2.19, "Type": "PRONUNCIATION" }, { "Alternatives": [{ "Confidence": 1, "Content": "one" }], "BeginAudioTime": 2.19, "EndAudioTime": 2.4, "Type": "PRONUNCIATION" }, { "Alternatives": [{ "Confidence": 1, "Content": "lb" }], "BeginAudioTime": 2.4, "EndAudioTime": 2.97, "Type": "PRONUNCIATION" } ], "TranscriptSegments": [{ "BeginAudioTime": 0.16, "Content": "Okay.", "EndAudioTime": 0.6, "ParticipantDetails": { "ParticipantRole": "CLINICIAN_0" }, "SectionDetails": { "SectionName": "SUBJECTIVE" }, "SegmentId": "uuid1" }, { "BeginAudioTime": 0.61, "Content": "Good afternoon.", "EndAudioTime": 1.54, "ParticipantDetails": { "ParticipantRole": "CLINICIAN_0" }, "SectionDetails": { "SectionName": "OTHER" }, "SegmentId": "uuid2" }, { "BeginAudioTime": 1.55, "Content": "You lost one lb.", "EndAudioTime": 2.97, "ParticipantDetails": { "ParticipantRole": "CLINICIAN_0" }, "SectionDetails": { "SectionName": "SUBJECTIVE" }, "SegmentId": "uuid3" }, { "BeginAudioTime": 2.98, "Content": "Yeah, I think it, uh, do you feel more energy?", "EndAudioTime": 6.95, "ParticipantDetails": { "ParticipantRole": "CLINICIAN_0" }, "SectionDetails": { "SectionName": "SUBJECTIVE" }, "SegmentId": "uuid4" }, { "BeginAudioTime": 6.96, "Content": "Yes.", "EndAudioTime": 7.88, "ParticipantDetails": { "ParticipantRole": "CLINICIAN_0" }, "SectionDetails": { "SectionName": "SUBJECTIVE" }, "SegmentId": "uuid5" }, { "BeginAudioTime": 7.89, "Content": "Uh, how about craving for the carbohydrate or sugar or fat or anything?", "EndAudioTime": 17.93, "ParticipantDetails": { "ParticipantRole": "CLINICIAN_0" }, "SectionDetails": { "SectionName": "SUBJECTIVE" }, "SegmentId": "uuid6" }] } } ``` ### Beispiel für eine Ausgabe klinischer Unterlagen Im Folgenden finden Sie ein Beispiel für eine Datei mit Erkenntnissen zur AWS HealthScribe klinischen Dokumentation aus einer Streaming-Sitzung. ``` { "ClinicalDocumentation": { "Sections": [ { "SectionName": "CHIEF_COMPLAINT", "Summary": [ { "EvidenceLinks": [ { "SegmentId": "uuid1" }, { "SegmentId": "uuid2" }, { "SegmentId": "uuid3" }, { "SegmentId": "uuid4" }, { "SegmentId": "uuid5" }, { "SegmentId": "uuid6" } ], "SummarizedSegment": "Weight loss." } ] }, { "SectionName": "HISTORY_OF_PRESENT_ILLNESS", "Summary": [ { "EvidenceLinks": [ { "SegmentId": "uuid7" }, { "SegmentId": "uuid8" }, { "SegmentId": "uuid9" }, { "SegmentId": "uuid10" } ], "SummarizedSegment": "The patient is seen today for a follow-up of weight loss." }, { "EvidenceLinks": [ { "SegmentId": "uuid11" }, { "SegmentId": "uuid12" }, { "SegmentId": "uuid13" } ], "SummarizedSegment": "They report feeling more energy and craving carbohydrates, sugar, and fat." }, { "EvidenceLinks": [ { "SegmentId": "uuid14" }, { "SegmentId": "uuid15" }, { "SegmentId": "uuid16" } ], "SummarizedSegment": "The patient is up to date on their mammogram and pap smear." }, { "EvidenceLinks": [ { "SegmentId": "uuid17" }, { "SegmentId": "uuid18" }, { "SegmentId": "uuid19" }, { "SegmentId": "uuid20" } ], "SummarizedSegment": "The patient is taking phentermine and would like to continue." } ] }, { "SectionName": "REVIEW_OF_SYSTEMS", "Summary": [ { "EvidenceLinks": [ { "SegmentId": "uuid21" }, { "SegmentId": "uuid22" } ], "SummarizedSegment": "Patient reports intermittent headaches, occasional chest pains but denies any recent fevers or chills." }, { "EvidenceLinks": [ { "SegmentId": "uuid23" }, { "SegmentId": "uuid24" } ], "SummarizedSegment": "No recent changes in vision, hearing, or any respiratory complaints." } ] }, { "SectionName": "PAST_MEDICAL_HISTORY", "Summary": [ { "EvidenceLinks": [ { "SegmentId": "uuid25" }, { "SegmentId": "uuid26" } ], "SummarizedSegment": "Patient has a history of hypertension and was diagnosed with Type II diabetes 5 years ago." }, { "EvidenceLinks": [ { "SegmentId": "uuid27" }, { "SegmentId": "uuid28" } ], "SummarizedSegment": "Underwent an appendectomy in the early '90s and had a fracture in the left arm during childhood." } ] }, { "SectionName": "ASSESSMENT", "Summary": [ { "EvidenceLinks": [ { "SegmentId": "uuid29" }, { "SegmentId": "uuid30" } ], "SummarizedSegment": "Weight loss" } ] }, { "SectionName": "PLAN", "Summary": [ { "EvidenceLinks": [ { "SegmentId": "uuid31" }, { "SegmentId": "uuid32" }, { "SegmentId": "uuid33" }, { "SegmentId": "uuid34" } ], "SummarizedSegment": "For the condition of Weight loss: The patient was given a 30-day supply of phentermine and was advised to follow up in 30 days." } ] } ], "SessionId": "sampleSessionUUID" } } ``` # Datenverschlüsselung im Ruhezustand für AWS HealthScribe AWS HealthScribe Bietet standardmäßig Verschlüsselung im Ruhezustand, um vertrauliche Kundendaten mithilfe von AWS HealthScribe verwalteten AWS Key Management Service (AWS KMS) -Schlüsseln zu schützen. Die standardmäßige Verschlüsselung von Daten im Ruhezustand trägt dazu bei, den betrieblichen Aufwand und die Komplexität zu reduzieren, die mit dem Schutz vertraulicher Daten verbunden sind. Außerdem ermöglicht es Ihnen, sichere Anwendungen zu entwickeln, die strenge Verschlüsselungsvorschriften und regulatorische Anforderungen erfüllen. Wenn Sie einen AWS HealthScribe Transkriptionsauftrag erstellen oder einen Stream starten, können Sie einen vom Kunden verwalteten Schlüssel angeben. Dadurch wird eine zweite Verschlüsselungsebene hinzugefügt. + **AWS HealthScribe verwaltete AWS KMS Schlüssel** — AWS HealthScribe verwendet standardmäßig AWS HealthScribe verwaltete AWS Key Management Service (AWS KMS) -Schlüssel, um Zwischendateien automatisch zu verschlüsseln. Sie können diese Verschlüsselungsebene nicht deaktivieren oder einen anderen Verschlüsselungstyp wählen. Sie können die Schlüssel nicht einsehen, verwalten oder verwenden oder ihre Verwendung überprüfen. Sie müssen jedoch keine Maßnahmen ergreifen oder Programme zum Schutz der Schlüssel ändern, die zur Verschlüsselung Ihrer Daten verwendet werden. + **Vom Kunden verwaltete Schlüssel** — AWS HealthScribe unterstützt die Verwendung eines symmetrischen, vom Kunden verwalteten Schlüssels, den Sie erstellen, besitzen und verwalten, um eine zweite Verschlüsselungsebene über der vorhandenen AWS-eigenen Verschlüsselung hinzuzufügen. Da Sie die volle Kontrolle über diese Verschlüsselungsebene haben, können Sie beispielsweise folgende Aufgaben ausführen: + Festlegung und Pflege wichtiger Richtlinien + Festlegung und Aufrechterhaltung von IAM Richtlinien und Zuschüssen + Aktivieren und Deaktivieren wichtiger Richtlinien + Kryptographisches Material mit rotierendem Schlüssel + Hinzufügen von -Tags + Erstellen von Schlüsselaliasen + Schlüssel für das Löschen von Schlüsseln planen Weitere Informationen finden Sie unter vom [Kunden verwalteter Schlüssel](https://docs.aws.amazon.com//kms/latest/developerguide/concepts.html#customer-cmk) im AWS Key Management Service Entwicklerhandbuch. **Anmerkung** AWS HealthScribe aktiviert automatisch die Verschlüsselung im AWS Ruhezustand mithilfe eigener Schlüssel, um personenbezogene Daten kostenlos zu schützen. Für die Verwendung eines vom Kunden verwalteten Schlüssels fallen jedoch AWS KMS Gebühren an. Weitere Informationen zur Preisgestaltung finden Sie unter [AWS Key Management Service  – Preise](https://aws.amazon.com//kms/pricing/). Weitere Informationen zu AWS KMS finden Sie unter [Was ist AWS Key Management Service](https://docs.aws.amazon.com//kms/latest/developerguide/overview.html). **Topics** + [Einen vom Kunden verwalteten Schlüssel erstellen](health-scribe-encryption-customer.md) + [Angabe eines vom Kunden verwalteten Schlüssels für AWS HealthScribe](#health-scribe-encryption-managed) + [AWS KMS Verschlüsselungskontext](#health-scribe-encryption-context) + [Überwachen Sie Ihre Verschlüsselungsschlüssel für AWS HealthScribe](#hscribe-monitoring-keys) # Einen vom Kunden verwalteten Schlüssel erstellen Sie können einen symmetrischen, vom Kunden verwalteten Schlüssel erstellen, indem Sie den AWS-Managementkonsole, oder den AWS KMS APIs verwenden. Um einen symmetrischen, vom Kunden verwalteten Schlüssel zu erstellen, folgen Sie den Schritten unter [Erstellen eines symmetrischen, vom Kunden verwalteten Schlüssels im AWS Key Management Service Entwicklerhandbuch](https://docs.aws.amazon.com//kms/latest/developerguide/create-keys.html#create-symmetric-cmk). Schlüsselrichtlinien steuern den Zugriff auf den vom Kunden verwalteten Schlüssel. Jeder vom Kunden verwaltete Schlüssel muss über genau eine Schlüsselrichtlinie verfügen, die aussagt, wer den Schlüssel wie verwenden kann. Wenn Sie Ihren kundenseitig verwalteten Schlüssel erstellen, können Sie eine Schlüsselrichtlinie angeben. Weitere Informationen finden Sie unter [Verwaltung des Zugriffs auf vom Kunden verwaltete Schlüssel](https://docs.aws.amazon.com//kms/latest/developerguide/control-access-overview.html#managing-access) im AWS Key Management Service Entwicklerhandbuch. ## AWS KMS wichtige Richtlinien für AWS HealthScribe Wenn Sie einen Schlüssel in demselben Konto verwenden wie die IAM Rolle, die Sie `DataAccessRole` in Ihrer Anfrage [StartMedicalScribeJob](https://docs.aws.amazon.com//transcribe/latest/APIReference/API_StartMedicalScribeJob.html)oder `ResourceAccessRole` in Ihrer [StartMedicalScribeStream](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalScribeStream.html)Anfrage angegeben haben, müssen Sie die Schlüsselrichtlinie nicht aktualisieren. Um Ihren vom Kunden verwalteten Schlüssel in einem anderen Konto als Ihrem Konto DataAccessRole (für Transkriptionsaufträge) oder ResourceAccessRole (für Streaming) zu verwenden, müssen Sie der jeweiligen Rolle in der Schlüsselrichtlinie für die folgenden Aktionen vertrauen: + [https://docs.aws.amazon.com//kms/latest/APIReference/API_Encrypt.html](https://docs.aws.amazon.com//kms/latest/APIReference/API_Encrypt.html) – Ermöglicht die Verwendung des vom Kunden verwalteten Schlüssels zur Verschlüsselung der Daten + [https://docs.aws.amazon.com//kms/latest/APIReference/API_Decrypt.html](https://docs.aws.amazon.com//kms/latest/APIReference/API_Decrypt.html) – Ermöglicht die Verwendung des vom Kunden verwalteten Schlüssels zur Entschlüsselung der Daten + [https://docs.aws.amazon.com//kms/latest/APIReference/API_DescribeKey.html](https://docs.aws.amazon.com//kms/latest/APIReference/API_DescribeKey.html)— Stellt dem Kunden verwaltete Schlüsseldetails zur Verfügung, damit AWS HealthScribe der Schlüssel validiert werden kann Im Folgenden finden Sie ein Beispiel für eine Schlüsselrichtlinie, mit der Sie Ihren ResourceAccessRole kontoübergreifenden Berechtigungen zur Verwendung Ihres vom Kunden verwalteten Schlüssels für das AWS HealthScribe Streaming gewähren können. Um diese Richtlinie für Transkriptionsaufträge zu verwenden, aktualisieren Sie den`Principal`, sodass er den DataAccessRole ARN verwendet, und entfernen oder ändern Sie den Verschlüsselungskontext. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement":[ { "Sid": "AllowAccessForKeyAdministrators", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:root" }, "Action": [ "kms:*" ], "Resource": "*" }, { "Sid": "AllowAccessToResourceAccessRoleForMedicalScribe", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/ResourceAccessRole" }, "Action": [ "kms:Encrypt", "kms:Decrypt", "kms:GenerateDataKey*" ], "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:aws:us-east-1:transcribe:medical-scribe:session-id": "1234abcd-12ab-34cd-56ef-123456SAMPLE" } } }, { "Sid": "AllowAccessToResourceAccessRoleForDescribeKey", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/ResourceAccessRole" }, "Action": "kms:DescribeKey", "Resource": "*" } ] } ``` ------ ## IAM-Richtlinienberechtigungen für Zugriffsrollen Die IAM-Richtlinie, die Ihrem DataAccessRole Konto beigefügt ist, ResourceAccessRole muss Ihnen Berechtigungen für die Durchführung der erforderlichen AWS KMS Aktionen gewähren, unabhängig davon, ob sich der vom Kunden verwaltete Schlüssel und die Rolle in denselben oder unterschiedlichen Konten befinden. Außerdem muss die Vertrauensrichtlinie der Rolle die AWS HealthScribe Erlaubnis zur Übernahme der Rolle gewähren. Das folgende Beispiel für eine IAM-Richtlinie zeigt, wie ResourceAccessRole AWS HealthScribe Streaming-Berechtigungen erteilt werden. Um diese Richtlinie für Transkriptionsaufträge zu verwenden, `transcribe.streaming.amazonaws.com` ersetzen Sie den Verschlüsselungskontext durch `transcribe.amazonaws.com` und entfernen oder ändern Sie ihn. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "kms:Encrypt", "kms:Decrypt", "kms:GenerateDataKey*" ], "Resource": "arn:aws:kms:us-west-2:111122223333:key/KMS-Example-KeyId", "Condition": { "StringEquals": { "kms:ViaService": "transcribe.streaming.amazonaws.com", "kms:EncryptionContext:aws:us-east-1:transcribe:medical-scribe:session-id": "1234abcd-12ab-34cd-56ef-123456SAMPLE" } } }, { "Effect": "Allow", "Action": [ "kms:DescribeKey" ], "Resource": "arn:aws:kms:us-west-2:111122223333:key/KMS-Example-KeyId", "Condition": { "StringEquals": { "kms:ViaService": "transcribe.streaming.amazonaws.com" } } } ] } ``` ------ Im Folgenden finden Sie ein Beispiel für eine Vertrauensrichtlinie für. ResourceAccessRole Für DataAccessRole, ersetzen Sie `transcribe.streaming.amazonaws.com` durch`transcribe.amazonaws.com`. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "transcribe.streaming.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "111122223333" }, "ArnLike": { "aws:SourceArn": "arn:aws:transcribe:us-west-2:111122223333:*" } } } ] } ``` ------ Weitere Informationen zur [Angabe von Berechtigungen in einer Richtlinie](https://docs.aws.amazon.com//kms/latest/developerguide/control-access-overview.html#overview-policy-elements) oder [zur Problembehandlung beim Schlüsselzugriff](https://docs.aws.amazon.com//kms/latest/developerguide/policy-evaluation.html#example-no-iam) finden Sie im AWS Key Management Service Entwicklerhandbuch. ## Angabe eines vom Kunden verwalteten Schlüssels für AWS HealthScribe Sie können einen vom Kunden verwalteten Schlüssel als zweite Verschlüsselungsebene für Transkriptionsaufträge oder Streaming angeben. + Bei Transkriptionsaufträgen geben Sie Ihren Schlüssel in der [OutputEncryptionKMSKeyID](https://docs.aws.amazon.com//transcribe/latest/APIReference/API_StartMedicalScribeJob.html#transcribe-StartMedicalScribeJob-request-OutputEncryptionKMSKeyId) Ihres [StartMedicalScribeJob](https://docs.aws.amazon.com//transcribe/latest/APIReference/API_StartMedicalScribeJob.html)API-Vorgangs an. + Für Streaming geben Sie den Schlüssel [MedicalScribeEncryptionSettings](https://docs.aws.amazon.com//transcribe/latest/APIReference/API_streaming_MedicalScribeEncryptionSettings.html)in Ihrem [MedicalScribeConfigurationEvent](https://docs.aws.amazon.com//transcribe/latest/APIReference/API_streaming_MedicalScribeConfigurationEvent.html)an. ## AWS KMS Verschlüsselungskontext AWS KMS Der Verschlüsselungskontext ist eine Zuordnung von nicht geheimen Schlüssel/Wert-Paaren im Klartext. Diese Zuordnung stellt zusätzliche authentifizierte Daten dar, die als Verschlüsselungskontextpaare bezeichnet werden und eine zusätzliche Sicherheitsebene für Ihre Daten bieten. AWS HealthScribe erfordert einen symmetrischen Verschlüsselungsschlüssel, um die AWS HealthScribe Ausgabe in einen vom Kunden angegebenen Bucket zu verschlüsseln. Amazon S3 Weitere Informationen finden Sie unter [Asymmetrische Schlüssel in AWS KMS](https://docs.aws.amazon.com//kms/latest/developerguide/symmetric-asymmetric.html). Wenn Sie Ihre Verschlüsselungskontextpaare erstellen, sollten Sie *keine* sensiblen Informationen einschließen. Der Verschlüsselungskontext ist nicht geheim — er ist im Klartext in Ihren CloudTrail Protokollen sichtbar (sodass Sie ihn verwenden können, um Ihre kryptografischen Operationen zu identifizieren und zu kategorisieren). Ihr Verschlüsselungskontextpaar kann Sonderzeichen enthalten, z. B. Unterstriche (`_`), Bindestriche (`-`), Schrägstriche (`/`, `\`) und Doppelpunkte (`:`). **Tipp** Es kann nützlich sein, die Werte in Ihrem Verschlüsselungskontextpaar mit den zu verschlüsselnden Daten in Beziehung zu setzen. Obwohl dies nicht erforderlich ist, empfehlen wir Ihnen, nicht sensible Metadaten zu verwenden, die sich auf Ihre verschlüsselten Inhalte beziehen, wie z. B. Dateinamen, Header-Werte oder unverschlüsselte Datenbankfelder. Um die Ausgabeverschlüsselung mit der API zu verwenden, legen Sie [KMSEncryptionim Vorgang den Context-Parameter](https://docs.aws.amazon.com//transcribe/latest/APIReference/API_StartMedicalScribeJob.html#transcribe-StartMedicalScribeJob-request-KMSEncryptionContext) fest. [StartMedicalScribeJob](https://docs.aws.amazon.com//transcribe/latest/APIReference/API_StartMedicalScribeJob.html) Um den Verschlüsselungskontext für den Ausgabeverschlüsselungsvorgang bereitzustellen, muss der [OutputEncryptionKMSKeyId-Parameter](https://docs.aws.amazon.com//transcribe/latest/APIReference/API_StartMedicalScribeJob.html#transcribe-StartMedicalScribeJob-request-OutputEncryptionKMSKeyId) auf eine symmetrische AWS KMS Schlüssel-ID verweisen. Für das Streaming geben Sie die Schlüssel-Wert-Paare für die `KmsEncryptionContext` [MedicalScribeEncryptionSettings](https://docs.aws.amazon.com//transcribe/latest/APIReference/API_streaming_MedicalScribeEncryptionSettings.html)in Ihrem [MedicalScribeConfigurationEvent](https://docs.aws.amazon.com//transcribe/latest/APIReference/API_streaming_MedicalScribeConfigurationEvent.html)an. Sie können [AWS KMS Bedingungsschlüssel](https://docs.aws.amazon.com//kms/latest/developerguide/policy-conditions.html#conditions-kms) mit IAM Richtlinien verwenden, um den Zugriff auf einen symmetrischen AWS KMS Verschlüsselungsschlüssel auf der Grundlage des Verschlüsselungskontextes zu steuern, der in der Anforderung für einen [kryptografischen](https://docs.aws.amazon.com//kms/latest/developerguide/concepts.html#cryptographic-operations) Vorgang verwendet wurde. Ein Beispiel für eine Verschlüsselungskontextrichtlinie finden Sie unter [AWS KMS -Verschlüsselungskontextrichtlinie](https://docs.aws.amazon.com//transcribe/latest/dg/security_iam_id-based-policy-examples.html#kms-context-policy). Die Verwendung des Verschlüsselungskontexts ist optional, wird aber empfohlen. Weitere Informationen finden Sie unter [Verschlüsselungskontext](https://docs.aws.amazon.com//kms/latest/developerguide/concepts.html#encrypt_context). ### AWS HealthScribe Verschlüsselungskontext AWS HealthScribe verwendet bei allen AWS Key Management Service kryptografischen Vorgängen denselben Verschlüsselungskontext. Der Verschlüsselungskontext ist eine Zuordnung von Zeichenfolge zu Zeichenfolge, die beliebig angepasst werden kann. ``` "encryptionContext": { "ECKey": "ECValue" ... } ``` Für AWS HealthScribe Streams ist der folgende Standardkontext der vom Dienst generierte Verschlüsselungskontext. Dieser Kontext wird zusätzlich zu jedem von Ihnen bereitgestellten Verschlüsselungskontext angewendet. ``` "encryptionContext": { "aws::transcribe:medical-scribe:session-id": "1234abcd-12ab-34cd-56ef-123456SAMPLE" } ``` Für AWS HealthScribe Transkriptionsaufträge ist der folgende Standardkontext der vom Dienst generierte Verschlüsselungskontext. Dieser Kontext wird zusätzlich zu jedem von Ihnen angegebenen Verschlüsselungskontext angewendet. ``` "encryptionContext": { "aws::transcribe:medical-scribe:job-name": "", "aws::transcribe:medical-scribe:start-time-epoch-ms": "" } ``` Wenn Sie keinen Verschlüsselungskontext angeben, wird nur der vom Dienst generierte Verschlüsselungskontext für alle AWS KMS kryptografischen Operationen verwendet. **Überwachung AWS HealthScribe mit Verschlüsselungskontext** Wenn Sie einen symmetrischen, vom Kunden verwalteten Schlüssel verwenden, um Ihre gespeicherten Daten zu verschlüsseln AWS HealthScribe, können Sie den Verschlüsselungskontext auch in Prüfaufzeichnungen und Protokollen verwenden, um zu ermitteln, wie der vom Kunden verwaltete Schlüssel verwendet wird. Der Verschlüsselungskontext erscheint auch in Protokollen, die von AWS CloudTrail oder CloudWatch Logs generiert wurden. **Verwendung des Verschlüsselungskontextes zur Steuerung des Zugriffs auf den vom Kunden verwalteten Schlüssel** Sie können den Verschlüsselungskontext in Schlüsselrichtlinien und IAM-Richtlinien als Bedingungen verwenden, um den Zugriff auf Ihren symmetrischen, kundenseitig verwalteten Schlüssel zu kontrollieren. Im Folgenden finden Sie Beispiele für Schlüsselrichtlinienanweisungen zur Gewährung des Zugriffs auf einen kundenseitig verwalteten Schlüssel für einen bestimmten Verschlüsselungskontext. Die Bedingung in dieser Richtlinienanweisung erfordert, dass für die Verwendung von KMS-Schlüsseln eine Einschränkung des Verschlüsselungskontextes gilt, die den Verschlüsselungskontext spezifiziert. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowAccessToResourceAccessRoleForMedicalScribe", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/ResourceAccessRole" }, "Action": [ "kms:Encrypt", "kms:Decrypt", "kms:GenerateDataKey*" ], "Resource": "arn:aws:kms:us-west-2:111122223333:key/KMS-Example-KeyId", "Condition": { "StringEquals": { "kms:EncryptionContext:aws:us-east-1:transcribe:medical-scribe:session-id": "1234abcd-12ab-34cd-56ef-123456SAMPLE", "kms:EncryptionContext:ECKey": "ECValue" } } }, { "Sid": "AllowAccessToResourceAccessRoleForDescribeKey", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/ResourceAccessRole" }, "Action": "kms:DescribeKey", "Resource": "arn:aws:kms:us-west-2:111122223333:key/KMS-Example-KeyId" } ] } ``` ------ ## Überwachen Sie Ihre Verschlüsselungsschlüssel für AWS HealthScribe Wenn Sie einen vom AWS Key Management Service Kunden verwalteten Schlüssel mit verwenden AWS HealthScribe, können Sie AWS CloudTrail Or CloudWatch Logs verwenden, um Anfragen nachzuverfolgen, die AWS HealthScribe an gesendet AWS KMS werden. Bei den folgenden Beispielen handelt es sich um Ereignisse vom Typ CloudTrail Verschlüsseln und Entschlüsseln, mit denen Sie überwachen können, wie Ihr vom Kunden verwalteter Schlüssel AWS HealthScribe verwendet wird. **Encrypt** ``` { "eventVersion":"1.09", "userIdentity":{ "type":"AssumedRole", "principalId":"AROAIGDTESTANDEXAMPLE:Sampleuser01", "arn":"arn:aws:sts::123456789012:assumed-role/Admin/Sampleuser01", "accountId":"123456789012", "accessKeyId":"AKIAIOSFODNN7EXAMPLE3", "sessionContext":{ "sessionIssuer":{ "type":"Role", "principalId":"AROAIGDTESTANDEXAMPLE:Sampleuser01", "arn":"arn:aws:sts::123456789012:assumed-role/Admin/Sampleuser01", "accountId":"123456789012", "userName":"Admin" }, "attributes":{ "creationDate":"2024-08-16T01:10:05Z", "mfaAuthenticated":"false" } }, "invokedBy":"transcribe.streaming.amazonaws.com" }, "eventTime":"2024-08-16T01:10:05Z", "eventSource":"kms.amazonaws.com", "eventName":"Encrypt", "awsRegion":"us-east-1", "sourceIPAddress":"transcribe.streaming.amazonaws.com", "userAgent":"transcribe.streaming.amazonaws.com", "requestParameters":{ "encryptionContext":{ "aws:us-east-1:transcribe:medical-scribe:session-id":"1234abcd-12ab-34cd-56ef-123456SAMPLE" }, "encryptionAlgorithm":"SYMMETRIC_DEFAULT", "keyId":"1234abcd-12ab-34cd-56ef-1234567890ab" }, "responseElements":null, "requestID":"cbe0ac33-8cca-49e5-9bb5-dc2b8dfcb389", "eventID":"1b9fedde-aa96-48cc-9dd9-a2cce2964b3c", "readOnly":true, "resources":[ { "accountId":"123456789012", "type":"AWS::KMS::Key", "ARN":"arn:aws:kms:us-west-2:123456789012:key/1234abcd-12ab-34cd-56ef-123456SAMPLE" } ], "eventType":"AwsApiCall", "managementEvent":true, "recipientAccountId":"123456789012", "eventCategory":"Management" } ``` **Decrypt** ``` { "eventVersion":"1.09", "userIdentity":{ "type":"AssumedRole", "principalId":"AROAIGDTESTANDEXAMPLE:Sampleuser01", "arn":"arn:aws:sts::123456789012:assumed-role/Admin/Sampleuser01", "accountId":"123456789012", "accessKeyId":"AKIAIOSFODNN7EXAMPLE3", "sessionContext":{ "sessionIssuer":{ "type":"Role", "principalId":"AROAIGDTESTANDEXAMPLE:Sampleuser01", "arn":"arn:aws:sts::123456789012:assumed-role/Admin/Sampleuser01", "accountId":"123456789012", "userName":"Admin" }, "attributes":{ "creationDate":"2024-08-16T20:47:04Z", "mfaAuthenticated":"false" } }, "invokedBy":"transcribe.streaming.amazonaws.com" }, "eventTime":"2024-08-16T20:47:04Z", "eventSource":"kms.amazonaws.com", "eventName":"Decrypt", "awsRegion":"us-east-1", "sourceIPAddress":"transcribe.streaming.amazonaws.com", "userAgent":"transcribe.streaming.amazonaws.com", "requestParameters":{ "keyId":"mrk-de27f019178f4fbf86512ab03ba860be", "encryptionAlgorithm":"SYMMETRIC_DEFAULT", "encryptionContext":{ "aws:us-east-1:transcribe:medical-scribe:session-id":"1234abcd-12ab-34cd-56ef-123456SAMPLE" } }, "responseElements":null, "requestID":"8b7fb865-48be-4e03-ac3d-e7bee3ba30a1", "eventID":"68b7a263-d410-4701-9e2b-20c196628966", "readOnly":true, "resources":[ { "accountId":"123456789012", "type":"AWS::KMS::Key", "ARN":"arn:aws:kms:us-west-2:123456789012:key/1234abcd-12ab-34cd-56ef-123456SAMPLE" } ], "eventType":"AwsApiCall", "managementEvent":true, "recipientAccountId":"123456789012", "eventCategory":"Management" } ```