Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Amazon Transcribe Médical
Amazon Transcribe Medical est un service de reconnaissance vocale automatique (ASR) conçu pour les professionnels de la santé qui souhaitent transcrire des discours liés à la médecine, tels que les notes dictées par le médecin, le suivi de la sécurité des médicaments, les rendez-vous de télémédecine ou les conversations entre le médecin et le patient. Amazon Transcribe Les services médicaux sont disponibles soit par diffusion en temps réel (via microphone), soit par transcription d'un fichier téléchargé (lot).
**Important**
Amazon Transcribe Les soins médicaux ne remplacent pas les conseils, les diagnostics ou les traitements d'un professionnel de la santé. Déterminez le seuil de confiance approprié pour votre cas et utilisez des seuils de confiance élevés dans les situations qui exigent une grande précision. Dans certains cas d'utilisation, les résultats doivent être examinés et vérifiés par des examinateurs humains dûment formés. Amazon Transcribe Les transcriptions médicales ne doivent être utilisées dans les scénarios de soins aux patients qu'après vérification de leur exactitude et du bon jugement médical par des professionnels de la santé qualifiés.
Amazon Transcribe Medical fonctionne selon un modèle de responsabilité partagée, dans lequel AWS il est responsable de la protection de l'infrastructure qui gère Amazon Transcribe Medical et dans lequel vous êtes responsable de la gestion de vos données. Pour plus d’informations, consultez [Modèle de responsabilité partagée](https://aws.amazon.com/compliance/shared-responsibility-model/).
Amazon Transcribe Medical est disponible en anglais américain (en-US).
Pour un résultat optimal, utilisez un format audio sans perte tel que FLAC ou WAV, avec un encodage PCM 16 bits. Amazon Transcribe Medical prend en charge les fréquences d’échantillonnage de 16 000 Hz ou plus.
Pour l'analyse de vos relevés de notes, vous pouvez en utiliser d'autres Services AWS, tels que [Amazon Comprehend Medical](https://docs.aws.amazon.com/comprehend/latest/dg/comprehend-medical.html).
**Spécialités prises en charge**
| Spécialité | Sous-spécialité | Entrée audio |
| --- | --- | --- |
| Cardiologie | none | streaming uniquement |
| Neurologie | none | streaming uniquement |
| Oncologie | none | streaming uniquement |
| Soins primaires | Médecine familiale | traitement par lots, streaming |
| Soins primaires | Médecine interne | traitement par lots, streaming |
| Soins primaires | Obstétrique et gynécologie (OB-GYN) | traitement par lots, streaming |
| Soins primaires | Pédiatrie | traitement par lots, streaming |
| Radiologie | none | streaming uniquement |
| Urologie | none | streaming uniquement |
## Disponibilité des régions et quotas
Call Analytics est pris en charge dans les domaines suivants Régions AWS :
| **Région** | **Type de transcription** |
| --- | --- |
| af-south-1 (Le Cap) | lot |
| ap-east-1 (Hong Kong) | lot |
| ap-northeast-1 (Tokyo) | traitement par lots, streaming |
| ap-northeast-2 (Séoul) | traitement par lots, streaming |
| ap-south-1 (Bombay) | lot |
| ap-southeast-1 (Singapour) | lot |
| ap-southeast-2 (Sydney) | traitement par lots, streaming |
| ca-central-1, (Canada, Centre) | traitement par lots, streaming |
| eu-central-1 (Francfort) | traitement par lots, streaming |
| eu-north-1 (Stockholm) | lot |
| eu-west-1 (Irlande) | traitement par lots, streaming |
| eu-west-2 (Londres) | traitement par lots, streaming |
| eu-west-3 (Paris) | lot |
| me-south-1 (Bahreïn) | lot |
| sa-east-1 (São Paulo) | traitement par lots, streaming |
| us-east-1 (Virginie du Nord) | traitement par lots, streaming |
| us-east-2 (Ohio) | traitement par lots, streaming |
| us-gov-east-1 (GovCloud, USA Est) | traitement par lots, streaming |
| us-gov-west-1 (GovCloud, US-Ouest) | traitement par lots, streaming |
| us-west-1 (San Francisco) | lot |
| us-west-2 (Oregon) | traitement par lots, streaming |
Notez que la prise en charge de la région est différente pour [Amazon Transcribe](what-is.md#tsc-regions), Amazon Transcribe Medical et [Call Analytics](call-analytics.md#tca-regions).
Pour connaître les points de terminaison de chaque région prise en charge, consultez la section [Points de terminaison de service](https://docs.aws.amazon.com/general/latest/gr/transcribe.html#transcribe_region) dans la *Référence générale AWS *.
Pour obtenir la liste des quotas relatifs à vos transcriptions, consultez la section [Service Quotas](https://docs.aws.amazon.com/general/latest/gr/transcribe.html#limits-amazon-transcribe) dans la *Référence générale AWS *. Certains quotas peuvent être modifiés sur demande. Si la colonne **Ajustable** contient « **Oui** », vous pouvez demander une augmentation. Pour ce faire, sélectionnez le lien fourni.
# Spécialités et termes médicaux
Lors de la création d’une tâche de transcription médicale, vous spécifiez la langue, la spécialité médicale et le type audio du fichier source. Vous entrez l’anglais américain (en-US) comme langue et `PRIMARYCARE` comme spécialité médicale. La saisie des soins primaires comme valeur vous permet de générer des transcriptions à partir de l’audio source dans les spécialités médicales suivantes :
+ Médecine familiale
+ Médecine interne
+ Obstétrique et gynécologie (OB-GYN)
+ Pédiatrie
Vous avez le choix entre la dictée et la conversation pour votre type d’audio. Choisissez la dictée pour les fichiers audio où le médecin fait un rapport sur une visite ou une intervention du patient. Choisissez la conversation pour les fichiers audio qui impliquent une conversation entre un médecin et un patient ou une conversation entre médecins.
Pour stocker le résultat de votre travail de transcription, sélectionnez un Amazon S3 bucket que vous avez déjà créé. Pour plus d'informations sur les Amazon S3 buckets, voir [Getting Started with Amazon Simple Storage Service](https://docs.aws.amazon.com/AmazonS3/latest/gsg/GetStartedWithS3.html).
Voici le nombre minimal de paramètres de requête à entrer dans l’exemple JSON.
```
{
"MedicalTranscriptionJobName": "my-first-transcription-job",
"LanguageCode": "en-US",
"Media": {
"MediaFileUri": "s3://path to your audio file"
},
"OutputBucketName": “your output bucket name",
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION"
}
```
Amazon Transcribe Medical vous permet de générer des transcriptions alternatives. Pour de plus amples informations, veuillez consulter [Génération de transcriptions alternatives](alternative-med-transcriptions.md).
Vous pouvez également activer le partitionnement des locuteurs ou identifier les canaux de votre système audio. Pour plus d’informations, consultez [Activation du partitionnement des locuteurs](conversation-diarization-med.md) et [Transcription audio multicanal](conversation-channel-id-med.md).
# Transcription des termes médicaux et des mesures
Amazon Transcribe Medical peut transcrire des termes et des mesures médicaux. Amazon Transcribe Medical produit des abréviations pour les termes parlés. Par exemple, la « pression artérielle » est transcrite en tant que PA. Vous trouverez une liste des conventions utilisées par Amazon Transcribe Medical pour les termes médicaux et les mesures dans le tableau de cette page. La colonne *Terme parlé* fait référence au terme parlé dans l’audio source. La colonne *Sortie* fait référence à l’abréviation que vous voyez dans vos résultats de transcription.
Vous pouvez voir comment les termes prononcés dans l’audio source correspondent à la sortie de transcription ici.
| Terme parlé dans l’audio source | Abréviation utilisée dans la sortie | Exemple de sortie |
| --- | --- | --- |
| Centigrade | C | La température du patient est de 37,4 °C. |
| Celsius | C | La température du patient est de 37,4 °C. |
| Fahrenheit | F | La température du patient est de 101 °F. |
| Grammes | g | Une masse de 100 g a été extraite du patient. |
| Mètres | m | Le patient mesure 1,80 m. |
| Pieds | ft | Le patient mesure 6 pieds. |
| Kilos | kg | Le patient pèse 80 kg. |
| Kilogrammes | kg | Le patient pèse 80 kg. |
| c c | cc | Le patient a reçu 100 cc de solution saline. |
| Centimètre cube | cc | Le patient a reçu 100 cc de solution saline. |
| Millilitre | mL | Le patient a excrété 100 mL d’urine. |
| Pression artérielle | PA | La PA du patient était élevée. |
| b p | PA | La PA du patient était élevée. |
| X sur Y | X/Y | La PA du patient était de 120/80. |
| Battements par min | BPM | Le patient avait une fibrillation auriculaire avec une fréquence cardiaque de 160 BPM. |
| Battements par minute | BPM | Le patient avait une fibrillation auriculaire avec une fréquence cardiaque de 160 BPM. |
| O 2 | O2 | La saturation en O2 du patient était de 98 %. |
| CO2 | CO2 | Le patient avait besoin d'une assistance respiratoire en cas d'élévation CO2. |
| Après l’opération | POSTOP | Le patient est venu pour l’évaluation POSTOP. |
| Post op | POSTOP | Le patient est venu pour l’évaluation POSTOP. |
| Tomodensitogramme | TDM | L’indication du patient d’une hémorragie cérébrale nécessitait l’utilisation d’un TDM. |
| Pouls 80 | P 80 | Les signes vitaux des patients étaient P 80, R 17, ... |
| Respiration 17 | R 17 | Les signes vitaux des patients étaient P 80, R 17, ... |
| entrée et sortie | I/O | Le patient avait un rythme I/O sinusal |
| L cinq | L5 | Une ponction lombaire a été effectuée entre L4 et L5 |
# Transcription des nombres
Amazon Transcribe La médecine transcrit les chiffres sous forme de chiffres plutôt que de mots. Par exemple, le nombre « mille deux cent quarante-deux » est transcrit sous la forme `1242`.
Les nombres sont transcrites selon les règles suivantes.
| Règle | Description |
| --- | --- |
| Convertir les nombres cardinaux supérieurs à 10 en chiffres. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/transcribe/latest/dg/how-numbers-med.html) |
| Convertissez les nombres cardinaux suivis de « million » ou de « milliard » en chiffres suivis d’un mot quand « million » ou « milliard » n’est pas suivi d’un nombre. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/transcribe/latest/dg/how-numbers-med.html) |
| Convertir les nombres ordinaux supérieurs à 10 en chiffres. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/transcribe/latest/dg/how-numbers-med.html) |
| Fractions converties en leur format numérique. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/transcribe/latest/dg/how-numbers-med.html) |
| Nombres de moins de 10 chiffres convertis s’il y en a plus d’un dans une ligne. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/transcribe/latest/dg/how-numbers-med.html) |
| Les décimales sont indiqués par « virgule ». | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/transcribe/latest/dg/how-numbers-med.html) |
| Mot « pour cent » après un nombre converti en signe de pourcentage. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/transcribe/latest/dg/how-numbers-med.html) |
| Mots « dollar », dollar américain », « dollar australien », « AUD » ou « USD » après un nombre convertis en un symbole de dollar avant le nombre. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/transcribe/latest/dg/how-numbers-med.html) |
| Convertir les mots « livres » ou « milligrammes » en « lbs » ou « mg », | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/transcribe/latest/dg/how-numbers-med.html) |
| Mots « roupies », « roupies indiennes » ou « INR » après un nombre convertis en signe roupie (₹) avant le nombre. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/transcribe/latest/dg/how-numbers-med.html) |
| Heures converties en nombres. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/transcribe/latest/dg/how-numbers-med.html) |
| Combinez les années exprimés en deux chiffres en quatre. Valide uniquement pour les 20e, 21e et 22e siècles. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/transcribe/latest/dg/how-numbers-med.html) |
| Dates converties en nombres. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/transcribe/latest/dg/how-numbers-med.html) |
| Plages de nombres séparées par le mot « à ». | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/transcribe/latest/dg/how-numbers-med.html) |
# Transcription d’une conversation médicale
Vous pouvez utiliser Amazon Transcribe Medical pour transcrire une conversation médicale entre un clinicien et un patient à l'aide d'un travail de transcription par lots ou d'un flux en temps réel. Les tâches de transcription par lots vous permettent de transcrire des fichiers audio. Pour garantir que Amazon Transcribe Medical produit des résultats de transcription avec la plus grande précision possible, vous devez spécifier la spécialité médicale du clinicien dans votre travail ou votre flux de transcription.
Vous pouvez transcrire une visite médecin-patient dans les spécialités médicales suivantes :
+ Cardiologie – Disponible en transcription en streaming uniquement
+ Neurologie – Disponible en transcription en streaming uniquement
+ Oncologie – Disponible en transcription en streaming uniquement
+ Soins primaires – Incluent les types de pratique médicale suivants :
+ Médecine familiale
+ Médecine interne
+ Obstétrique et gynécologie (OB-GYN)
+ Pédiatrie
+ Urologie – Disponible en transcription en streaming uniquement
Vous pouvez améliorer la précision de la transcription en utilisant des vocabulaires personnalisés médicaux. Pour plus d’informations sur le fonctionnement des vocabulaires personnalisés médicaux, consultez la section [Amélioration de la précision de la transcription grâce à des vocabulaires personnalisés médicaux](vocabulary-med.md).
Par défaut, Amazon Transcribe Medical renvoie la transcription avec le niveau de confiance le plus élevé. Si vous souhaitez le configurer pour renvoyer des transcriptions alternatives, consultez la section [Génération de transcriptions alternatives](alternative-med-transcriptions.md).
Pour plus d’informations sur la façon dont les nombres et les mesures médicales apparaissent dans la sortie de transcription, consultez les sections [Transcription des nombres](how-numbers-med.md) et [Transcription des termes médicaux et des mesures](how-measurements-med.md).
**Topics**
+ [Transcription d’un fichier audio d’une conversation médicale](batch-medical-conversation.md)
+ [Transcription d’une conversation médicale dans un flux en temps réel](streaming-medical-conversation.md)
+ [Activation du partitionnement des locuteurs](conversation-diarization-med.md)
+ [Transcription audio multicanal](conversation-channel-id-med.md)
# Transcription d’un fichier audio d’une conversation médicale
Utilisez une tâche de transcription par lots pour transcrire les fichiers audio de conversations médicales. Vous pouvez l’utiliser pour transcrire un dialogue entre un médecin et son patient. Vous pouvez démarrer une tâche de transcription par lots dans l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html) ou la AWS Management Console.
Lorsque vous démarrez une tâche de transcription médicale avec l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), vous spécifiez `PRIMARYCARE` comme valeur du paramètre `Specialty`.
## AWS Management Console
**Pour transcrire un dialogue entre un médecin et son patient (AWS Management Console)**
**Pour utiliser le AWS Management Console pour transcrire un dialogue clinicien-patient, créez une tâche de transcription et choisissez le type d'entrée **Conversation for Audio**.**
1. Connectez-vous à la [AWS Management Console](https://console.aws.amazon.com/transcribe/).
1. Dans le volet de navigation, sous Amazon Transcribe Medical, sélectionnez **Transcription jobs**.
1. Choisissez **Créer une tâche**.
1. Sur la page **Spécifier les détails de la tâche**, sous **Paramètres de la tâche**, indiquez les valeurs suivantes :
1. **Nom** : nom de la tâche de transcription.
1. **Type d’entrée audio** : **Conversation**
1. Pour les autres champs, spécifiez l' Amazon S3 emplacement de votre fichier audio et l'endroit où vous souhaitez stocker le résultat de votre travail de transcription.
1. Choisissez **Suivant**.
1. Choisissez **Créer**.
## API
**Pour transcrire une conversation médicale à l’aide d’une tâche de transcription par lots (API)**
+ Pour l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), spécifiez ce qui suit.
1. Pour `MedicalTranscriptionJobName`, spécifiez un nom unique dans votre Compte AWS.
1. Pour `LanguageCode`, spécifiez le code de langue correspondant à la langue parlée dans votre fichier audio et la langue de votre filtre de vocabulaire.
1. Pour le paramètre `MediaFileUri` de l’objet `Media`, spécifiez le nom du fichier audio que vous souhaitez transcrire.
1. Pour `Specialty`, indiquez `PRIMARYCARE` comme spécialité médicale du médecin qui parle dans le fichier audio.
1. Pour `Type`, spécifiez `CONVERSATION`.
1. Pour `OutputBucketName`, spécifiez le compartiment Amazon S3 dans lequel stocker les résultats de transcription.
Voici un exemple de demande qui utilise le AWS SDK pour Python (Boto3) pour transcrire une conversation médicale entre un clinicien de la `PRIMARYCARE` spécialité et un patient.
```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
job_name = "my-first-med-transcription-job"
job_uri = "s3://amzn-s3-demo-bucket/my-input-files/my-audio-file.flac"
transcribe.start_medical_transcription_job(
MedicalTranscriptionJobName = job_name,
Media = {
'MediaFileUri': job_uri
},
OutputBucketName = 'amzn-s3-demo-bucket',
OutputKey = 'output-files/',
LanguageCode = 'en-US',
Specialty = 'PRIMARYCARE',
Type = 'CONVERSATION'
)
while True:
status = transcribe.get_medical_transcription_job(MedicalTranscriptionJobName = job_name)
if status['MedicalTranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']:
break
print("Not ready yet...")
time.sleep(5)
print(status)
```
L’exemple de code suivant montre les résultats de transcription d’une conversation entre un médecin et son patient.
```
{
"jobName": "conversation-medical-transcription-job",
"accountId": "111122223333",
"results": {
"transcripts": [
{
"transcript": "... come for a follow up visit today..."
}
],
"items": [
{
...
"start_time": "4.85",
"end_time": "5.12",
"alternatives": [
{
"confidence": "1.0",
"content": "come"
}
],
"type": "pronunciation"
},
{
"start_time": "5.12",
"end_time": "5.29",
"alternatives": [
{
"confidence": "1.0",
"content": "for"
}
],
"type": "pronunciation"
},
{
"start_time": "5.29",
"end_time": "5.33",
"alternatives": [
{
"confidence": "0.9955",
"content": "a"
}
],
"type": "pronunciation"
},
{
"start_time": "5.33",
"end_time": "5.66",
"alternatives": [
{
"confidence": "0.9754",
"content": "follow"
}
],
"type": "pronunciation"
},
{
"start_time": "5.66",
"end_time": "5.75",
"alternatives": [
{
"confidence": "0.9754",
"content": "up"
}
],
"type": "pronunciation"
},
{
"start_time": "5.75",
"end_time": "6.02",
"alternatives": [
{
"confidence": "1.0",
"content": "visit"
}
]
...
},
"status": "COMPLETED"
}
```
## AWS CLI
**Pour transcrire une conversation médicale à l’aide d’une tâche de transcription par lots (AWS CLI)**
+ Exécutez le code suivant.
```
aws transcribe start-medical-transcription-job \
--region us-west-2 \
--cli-input-json file://example-start-command.json
```
Le code suivant affiche le contenu du fichier `example-start-command.json`.
```
{
"MedicalTranscriptionJobName": "my-first-med-transcription-job",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-audio-file.flac"
},
"OutputBucketName": "amzn-s3-demo-bucket",
"OutputKey": "my-output-files/",
"LanguageCode": "en-US",
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION"
}
```
# Transcription d’une conversation médicale dans un flux en temps réel
Vous pouvez transcrire le flux audio d'une conversation médicale à l'aide du protocole HTTP/2 ou [WebSocket ](https://tools.ietf.org/html/rfc6455)des protocoles. Pour plus d'informations sur le démarrage d'un flux à l'aide WebSocket du protocole, consultez[Configuration d'un WebSocket stream](streaming-setting-up.md#streaming-websocket). Pour démarrer un flux HTTP/2, utilisez l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html).
Vous pouvez transcrire un flux audio en streaming de l’une des spécialités médicales suivantes :
+ Cardiologie
+ Neurologie
+ Oncologie
+ Soins primaires
+ Urologie
Chaque spécialité médicale comprend de nombreux types de procédures et de rendez-vous. Les médecins dictent donc de nombreux types de notes. Utilisez les exemples suivants pour vous aider à spécifier la valeur du paramètre `specialty` URI de la WebSocket demande ou du `Specialty` paramètre de l'[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html)API :
+ Pour les consultations d’électrophysiologie ou d’échocardiographie, choisissez `CARDIOLOGY`.
+ Pour les consultations en oncologie médicale, en oncologie chirurgicale ou en radio-oncologie, choisissez `ONCOLOGY`.
+ Pour un médecin qui consulte un patient victime d’un accident vasculaire cérébral, qu’il s’agisse d’un accident ischémique transitoire ou d’un accident vasculaire cérébral, choisissez `NEUROLOGY`.
+ Pour une consultation sur l’incontinence urinaire, choisissez `UROLOGY`.
+ Pour un examen annuel ou des visites de soins d’urgence, choisissez `PRIMARYCARE`.
+ Pour les visites de médecins hospitaliers, choisissez `PRIMARYCARE`.
+ Pour les consultations concernant la fertilité, la ligature des trompes, l’insertion d’un DIU ou l’avortement, choisissez `PRIMARYCARE`.
## AWS Management Console
**Pour transcrire une conversation médicale en streaming (AWS Management Console)**
AWS Management Console Pour transcrire un dialogue clinicien-patient en temps réel, choisissez l'option permettant de transcrire une conversation médicale, de démarrer le flux et de commencer à parler dans le microphone.
1. Connectez-vous à la [AWS Management Console](https://console.aws.amazon.com/transcribe/).
1. Dans le volet de navigation, sous Amazon Transcribe Médical, sélectionnez **Transcription en temps réel**.
1. Choisissez **Conversation**.
1. Pour **Spécialité médicale**, choisissez la spécialité du médecin.
1. Choisissez **Démarrer le streaming**.
1. Parlez dans le microphone.
## Transcription d’une conversation médicale dans un flux HTTP/2
Voici la syntaxe des paramètres d’une requête HTTP/2.
Pour transcrire le flux HTTP/2 d’une conversation médicale, utilisez l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html) et spécifiez les éléments suivants :
+ `LanguageCode` – Code de langue. La valeur valide est `en-US`.
+ `MediaEncoding` – Encodage utilisé pour l’audio en entrée. Les valeurs valides sont `pcm`, `ogg-opus` et `flac`.
+ `Specialty` – Spécialité du professionnel de santé.
+ `Type` – `CONVERSATION`
Pour améliorer la précision de transcription de termes spécifiques dans un flux en temps réel, utilisez un vocabulaire personnalisé. Pour activer un vocabulaire personnalisé, définissez la valeur du paramètre `VocabularyName` sur le nom du vocabulaire personnalisé que vous souhaitez utiliser. Pour plus d’informations, consultez la section [Amélioration de la précision de la transcription grâce à des vocabulaires personnalisés médicaux](vocabulary-med.md).
Pour étiqueter le discours provenant de différents locuteurs, réglez le paramètre `ShowSpeakerLabel` sur `true`. Pour plus d’informations, consultez la section [Activation du partitionnement des locuteurs](conversation-diarization-med.md).
Pour plus d’informations sur la configuration d’un flux HTTP/2 pour transcrire une conversation médicale, consultez la section [Configuration d’un flux HTTP/2](streaming-setting-up.md#streaming-http2).
## Transcrire une conversation médicale dans un stream WebSocket
Vous pouvez utiliser une WebSocket demande pour transcrire une conversation médicale. Lorsque vous faites une WebSocket demande, vous créez un URI présigné. Cet URI contient les informations nécessaires pour configurer le flux audio entre votre application et Amazon Transcribe Medical. Pour plus d'informations sur la création de WebSocket demandes, consultez[Configuration d'un WebSocket stream](streaming-setting-up.md#streaming-websocket).
Utilisez le modèle suivant pour créer votre URI pré-signé.
```
GET wss://transcribestreaming.us-west-2.amazonaws.com:8443/medical-stream-transcription-websocket
?language-code=languageCode
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20220208%2Fus-west-2%2Ftranscribe%2Faws4_request
&X-Amz-Date=20220208T235959Z
&X-Amz-Expires=300
&X-Amz-Security-Token=security-token
&X-Amz-Signature=Signature Version 4 signature
&X-Amz-SignedHeaders=host
&media-encoding=flac
&sample-rate=16000
&session-id=sessionId
&specialty=medicalSpecialty
&type=CONVERSATION
&vocabulary-name=vocabularyName
&show-speaker-label=boolean
```
Pour améliorer la précision de transcription de termes spécifiques dans un flux en temps réel, utilisez un vocabulaire personnalisé. Pour activer un vocabulaire personnalisé, définissez la valeur du `vocabulary-name` sur le nom du vocabulaire personnalisé que vous souhaitez utiliser. Pour plus d’informations, consultez la section [Amélioration de la précision de la transcription grâce à des vocabulaires personnalisés médicaux](vocabulary-med.md).
Pour étiqueter le discours provenant de différents locuteurs, définissez le paramètre `show-speaker-label` sur `true`. Pour de plus amples informations, veuillez consulter [Activation du partitionnement des locuteurs](conversation-diarization-med.md).
Pour plus d'informations sur la création de documents pré-signés URIs, consultez[Configuration d'un WebSocket stream](streaming-setting-up.md#streaming-websocket).
# Activation du partitionnement des locuteurs
Pour activer le partitionnement des haut-parleurs dans Amazon Transcribe Medical, utilisez la *diarisation des haut-parleurs*. Cela vous permet de voir ce que le patient a dit et ce que le médecin a dit dans la sortie de transcription.
Lorsque vous activez la diarisation des locuteurs, Amazon Transcribe Medical étiquette chaque *énoncé* du locuteur avec un identifiant unique pour chaque locuteur. Un *énoncé* est une unité de parole qui est généralement séparée des autres énoncés par un silence. Lors de la transcription par lots, un énoncé du médecin peut recevoir une étiquette `spk_0` et un énoncé du patient peut recevoir une étiquette `spk_1`.
Si un énoncé d’un locuteur chevauche un énoncé d’un autre locuteur, Amazon Transcribe Medical les ordonne dans la transcription avant leur heure de début. Les énoncés qui se chevauchent dans le flux audio d’entrée ne se chevauchent pas dans la transcription de sortie.
Vous pouvez activer la diarisation des locuteurs lorsque vous transcrivez un fichier audio à l’aide d’une tâche de transcription par lots ou dans un flux en temps réel.
**Topics**
+ [Activation du partitionnement des locuteurs dans une transcription par lots](conversation-diarization-batch-med.md)
+ [Activation du partitionnement des locuteurs dans des flux en temps réel](conversation-diarization-streaming-med.md)
# Activation du partitionnement des locuteurs dans une transcription par lots
Vous pouvez activer le partitionnement des locuteurs dans une tâche de transcription par lots à l’aide de l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html) ou de la AWS Management Console. Cela vous permet de partitionner le texte par locuteur dans une conversation entre un médecin et son patient et de déterminer qui a dit quoi dans la sortie de la transcription.
## AWS Management Console
AWS Management Console Pour activer la diarisation des haut-parleurs dans votre tâche de transcription, vous devez activer l'identification audio, puis le partitionnement des haut-parleurs.
1. Connectez-vous à la [AWS Management Console](https://console.aws.amazon.com/transcribe/).
1. Dans le volet de navigation, sous Amazon Transcribe Medical, sélectionnez **Transcription jobs**.
1. Choisissez **Créer une tâche**.
1. Sur la page **Spécifier les détails de la tâche**, fournissez des informations sur votre tâche de transcription.
1. Choisissez **Suivant**.
1. Activez **Identification audio**.
1. Pour **Type d’identification audio**, choisissez **Partitionnement des locuteurs**.
1. Pour **Nombre maximal de locuteurs**, entrez le nombre maximal de locuteurs qui, selon vous, parlent dans votre fichier audio.
1. Choisissez **Créer**.
## API
**Pour activer le partitionnement des locuteurs à l’aide d’une tâche de transcription par lots (API)**
+ Pour l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), spécifiez ce qui suit.
1. Pour `MedicalTranscriptionJobName`, spécifiez un nom unique dans votre Compte AWS.
1. Pour `LanguageCode`, spécifiez le code de langue correspondant à la langue parlée dans le fichier audio.
1. Pour le paramètre `MediaFileUri` de l’objet `Media`, spécifiez le nom du fichier audio que vous souhaitez transcrire.
1. Pour `Specialty`, spécifiez la spécialité médicale du médecin qui parle dans le fichier audio.
1. Pour `Type`, spécifiez `CONVERSATION`.
1. Pour`OutputBucketName`, spécifiez le Amazon S3 compartiment dans lequel stocker les résultats de transcription.
1. Pour l’objet `Settings`, spécifiez ce qui suit :
1. `ShowSpeakerLabels` – `true`.
1. `MaxSpeakerLabels` – Entier compris entre 2 et 10 pour indiquer le nombre de locuteurs qui, selon vous, parlent dans votre audio.
La demande suivante utilise le AWS SDK pour Python (Boto3) pour démarrer une tâche de transcription par lots d'un dialogue entre un clinicien de soins primaires et un patient avec le partitionnement des haut-parleurs activé.
```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
job_name = "my-first-transcription-job"
job_uri = "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
transcribe.start_medical_transcription_job(
MedicalTranscriptionJobName = job_name,
Media={
'MediaFileUri': job_uri
},
OutputBucketName = 'amzn-s3-demo-bucket',
OutputKey = 'my-output-files/',
LanguageCode = 'en-US',
Specialty = 'PRIMARYCARE',
Type = 'CONVERSATION',
OutputBucketName = 'amzn-s3-demo-bucket',
Settings = {'ShowSpeakerLabels': True,
'MaxSpeakerLabels': 2
}
)
while True:
status = transcribe.get_medical_transcription_job(MedicalTranscriptionJobName = job_name)
if status['MedicalTranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']:
break
print("Not ready yet...")
time.sleep(5)
print(status)
```
L’exemple de code suivant montre les résultats de transcription d’une tâche de transcription avec le partitionnement des locuteurs activé.
```
{
"jobName": "job ID",
"accountId": "111122223333",
"results": {
"transcripts": [
{
"transcript": "Professional answer."
}
],
"speaker_labels": {
"speakers": 1,
"segments": [
{
"start_time": "0.000000",
"speaker_label": "spk_0",
"end_time": "1.430",
"items": [
{
"start_time": "0.100",
"speaker_label": "spk_0",
"end_time": "0.690"
},
{
"start_time": "0.690",
"speaker_label": "spk_0",
"end_time": "1.210"
}
]
}
]
},
"items": [
{
"start_time": "0.100",
"end_time": "0.690",
"alternatives": [
{
"confidence": "0.8162",
"content": "Professional"
}
],
"type": "pronunciation"
},
{
"start_time": "0.690",
"end_time": "1.210",
"alternatives": [
{
"confidence": "0.9939",
"content": "answer"
}
],
"type": "pronunciation"
},
{
"alternatives": [
{
"content": "."
}
],
"type": "punctuation"
}
]
},
"status": "COMPLETED"
}
```
## AWS CLI
**Pour transcrire un fichier audio d’une conversation entre un médecin de soins primaires et un patient (AWS CLI)**
+ Exécutez le code suivant.
```
aws transcribe start-transcription-job \
--region us-west-2 \
--cli-input-json file://example-start-command.json
```
Le code suivant affiche le contenu du fichier `example-start-command.json`.
```
{
"MedicalTranscriptionJobName": "my-first-med-transcription-job",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-audio-file.flac"
},
"OutputBucketName": "amzn-s3-demo-bucket",
"OutputKey": "my-output-files/",
"LanguageCode": "en-US",
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION",
"Settings":{
"ShowSpeakerLabels": true,
"MaxSpeakerLabels": 2
}
}
```
# Activation du partitionnement des locuteurs dans des flux en temps réel
Pour partitionner les locuteurs et étiqueter leur discours dans un flux en temps réel, utilisez la AWS Management Console ou une demande de diffusion. Le partitionnement des locuteurs fonctionne mieux pour deux à cinq locuteurs dans un flux. Bien que Amazon Transcribe Medical puisse partitionner plus de cinq haut-parleurs dans un flux, la précision des partitions diminue si vous dépassez ce nombre.
Pour démarrer une requête HTTP/2, utilisez l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html). Pour démarrer une WebSocket demande, utilisez un URI pré-signé. L’URI contient les informations nécessaires pour configurer une communication bidirectionnelle entre votre application et Amazon Transcribe Medical.
## Activation du partitionnement des locuteurs dans l’audio dicté dans votre microphone (AWS Management Console)
Vous pouvez utiliser le AWS Management Console pour démarrer une diffusion en temps réel d'une conversation entre un médecin et son patient, ou une dictée prononcée dans votre micro en temps réel.
1. Connectez-vous à la [AWS Management Console](https://console.aws.amazon.com/transcribe/).
1. Dans le volet de navigation, pour Amazon Transcribe Medical, sélectionnez **Transcription en temps réel**.
1. Pour **Type d’entrée audio**, choisissez le type de discours médical que vous souhaitez transcrire.
1. Pour **Paramètres supplémentaires**, choisissez **Partitionnement des locuteurs**.
1. Choisissez **Démarrer le streaming** pour commencer à transcrire votre audio en temps réel.
1. Parlez dans le microphone.
## Activation du partitionnement des locuteurs dans un flux HTTP/2
Pour activer le partitionnement des locuteurs dans le flux HTTP/2 d’une conversation médicale, utilisez l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html) et spécifiez les éléments suivants :
+ Pour `LanguageCode`, spécifiez le code de langue correspondant à la langue parlée dans le flux. La valeur valide est `en-US`.
+ Pour `MediaSampleHertz`, spécifiez la fréquence d’échantillonnage de l’audio.
+ Pour `Specialty`, spécifiez la spécialité médicale du prestataire.
+ `ShowSpeakerLabel` – `true`
Pour plus d’informations sur la configuration d’un flux HTTP/2 pour transcrire une conversation médicale, consultez la section [Configuration d’un flux HTTP/2](streaming-setting-up.md#streaming-http2).
## Activation du partitionnement des haut-parleurs dans une demande WebSocket
Pour partitionner les haut-parleurs en WebSocket flux à l'aide de l'API, utilisez le format suivant pour créer une URI pré-signée afin de démarrer une WebSocket demande et de la `show-speaker-label` définir `true` sur.
```
GET wss://transcribestreaming.us-west-2.amazonaws.com:8443/medical-stream-transcription-websocket
?language-code=languageCode
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20220208%2Fus-west-2%2Ftranscribe%2Faws4_request
&X-Amz-Date=20220208T235959Z
&X-Amz-Expires=300
&X-Amz-Security-Token=security-token
&X-Amz-Signature=Signature Version 4 signature
&X-Amz-SignedHeaders=host
&media-encoding=flac
&sample-rate=16000
&session-id=sessionId
&specialty=medicalSpecialty
&type=CONVERSATION
&vocabulary-name=vocabularyName
&show-speaker-label=boolean
```
Le code suivant montre l’exemple de réponse tronqué d’une demande de streaming.
```
{
"Transcript": {
"Results": [
{
"Alternatives": [
{
"Items": [
{
"Confidence": 0.97,
"Content": "From",
"EndTime": 18.98,
"Speaker": "0",
"StartTime": 18.74,
"Type": "pronunciation",
"VocabularyFilterMatch": false
},
{
"Confidence": 1,
"Content": "the",
"EndTime": 19.31,
"Speaker": "0",
"StartTime": 19,
"Type": "pronunciation",
"VocabularyFilterMatch": false
},
{
"Confidence": 1,
"Content": "last",
"EndTime": 19.86,
"Speaker": "0",
"StartTime": 19.32,
"Type": "pronunciation",
"VocabularyFilterMatch": false
},
...
{
"Confidence": 1,
"Content": "chronic",
"EndTime": 22.55,
"Speaker": "0",
"StartTime": 21.97,
"Type": "pronunciation",
"VocabularyFilterMatch": false
},
...
"Confidence": 1,
"Content": "fatigue",
"EndTime": 24.42,
"Speaker": "0",
"StartTime": 23.95,
"Type": "pronunciation",
"VocabularyFilterMatch": false
},
{
"EndTime": 25.22,
"StartTime": 25.22,
"Type": "speaker-change",
"VocabularyFilterMatch": false
},
{
"Confidence": 0.99,
"Content": "True",
"EndTime": 25.63,
"Speaker": "1",
"StartTime": 25.22,
"Type": "pronunciation",
"VocabularyFilterMatch": false
},
{
"Content": ".",
"EndTime": 25.63,
"StartTime": 25.63,
"Type": "punctuation",
"VocabularyFilterMatch": false
}
],
"Transcript": "From the last note she still has mild sleep deprivation and chronic fatigue True."
}
],
"EndTime": 25.63,
"IsPartial": false,
"ResultId": "XXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX",
"StartTime": 18.74
}
]
}
}
```
Amazon Transcribe Medical interrompt votre flux audio entrant en fonction de segments vocaux naturels, tels qu'un changement de haut-parleur ou une pause audio. La transcription est renvoyée progressivement à votre application, chaque réponse contenant plus de paroles transcrites que la précédente, jusqu’à la transcription de la totalité du segment. Le code précédent est un exemple tronqué d’un segment de discours entièrement transcrit. Les étiquettes des locuteurs n’apparaissent que pour les segments entièrement transcrits.
La liste suivante montre l’organisation des objets et des paramètres dans une sortie de transcription en streaming.
**`Transcript`**
Chaque segment de discours possède son propre objet `Transcript`.
**`Results`**
Chaque objet `Transcript` possède son propre objet `Results`. Cet objet contient le champ `isPartial`. Lorsque sa valeur est `false`, les résultats renvoyés concernent un segment de discours entier.
**`Alternatives`**
Chaque objet `Results` possède un objet `Alternatives`.
**`Items`**
Chaque objet `Alternatives` possède son propre objet `Items` qui contient des informations sur chaque mot et chaque signe de ponctuation présents dans la sortie de transcription. Lorsque vous activez le partitionnement des haut-parleurs, chaque mot possède une `Speaker` étiquette pour les segments vocaux entièrement transcrits. Amazon Transcribe Medical utilise cette étiquette pour attribuer un entier unique à chaque intervenant du stream. Le paramètre `Type` ayant une valeur `speaker-change` indique qu’une personne a cessé de parler et qu’une autre personne est sur le point de commencer.
**`Transcript`**
Chaque objet Éléments contient un segment de discours transcrit comme valeur du champ `Transcript`.
Pour plus d'informations sur WebSocket les demandes, consultez[Configuration d'un WebSocket stream](streaming-setting-up.md#streaming-websocket).
# Transcription audio multicanal
Si vous avez un fichier audio ou un flux comportant plusieurs canaux, vous pouvez utiliser l'*identification des canaux* pour transcrire le discours de chacun de ces canaux. Amazon Transcribe Medical transcrit le discours de chaque canal séparément. Il combine les transcriptions distinctes de chaque canal en une seule sortie de transcription.
Utilisez l’identification des canaux pour identifier les différents canaux de votre audio et transcrire le discours de chacun de ces canaux. Activez cette option dans des situations telles qu’un scénario d’appelant et d’agent. Utilisez-la pour distinguer un appelant d’un agent dans des enregistrements ou des flux des centres d’appels chargés de la surveillance de la sécurité des médicaments.
Vous pouvez activer l’identification des canaux pour le traitement par lots et le streaming en temps réel. La liste suivante décrit comment l’activer pour chaque méthode.
+ Transcription par lots — AWS Management Console et [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html)API
+ Transcription en streaming — WebSocket streaming et [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html)API
## Transcription de fichiers audio multicanal
Lorsque vous transcrivez un fichier audio, Amazon Transcribe Medical renvoie une liste d'*éléments* pour chaque canal. Un élément est un mot transcrit ou un signe de ponctuation. Chaque mot possède une heure de début et une heure de fin. Si une personne parle sur un canal en même temps qu’une autre personne sur un autre canal, les horodatages des éléments de chaque canal se chevauchent pendant que les personnes parlent l’une et l’autre.
Par défaut, vous pouvez transcrire des fichiers audio sur deux canaux. Vous pouvez demander une augmentation du quota si vous devez transcrire des fichiers comportant plus de deux canaux. Pour plus d’informations sur la demande d’augmentation de quota, consultez la section [Quotas Service AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html).
Pour transcrire du son multicanal dans le cadre d'une tâche de transcription par lots, utilisez l' AWS Management Console [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html)API ou.
### AWS Management Console
AWS Management Console Pour activer l'identification des canaux dans votre tâche de transcription par lots, vous devez activer l'identification audio, puis l'identification des canaux. L'identification des canaux est un sous-ensemble de l'identification audio dans le AWS Management Console.
1. Connectez-vous à la [AWS Management Console](https://console.aws.amazon.com/transcribe/).
1. Dans le volet de navigation, sous Amazon Transcribe Medical, sélectionnez **Transcription jobs**.
1. Choisissez **Créer une tâche**.
1. Sur la page **Spécifier les détails de la tâche**, fournissez des informations sur votre tâche de transcription.
1. Choisissez **Suivant**.
1. Activez **Identification audio**.
1. Pour **Type d’identification audio**, choisissez **Identification des canaux**.
1. Choisissez **Créer**.
### API
**Pour transcrire un fichier audio multicanal (API)**
+ Pour l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), spécifiez ce qui suit.
1. Pour `TranscriptionJobName`, spécifiez un nom unique dans votre Compte AWS.
1. Pour `LanguageCode`, spécifiez le code de langue correspondant à la langue parlée dans le fichier audio. La valeur valide est `en-US`.
1. Pour le paramètre `MediaFileUri` de l’objet `Media`, spécifiez le nom du fichier multimédia que vous souhaitez transcrire.
1. Pour l’objet `Settings`, définissez `ChannelIdentification` sur `true`.
Voici un exemple de demande utilisant le AWS SDK pour Python (Boto3).
```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
job_name = "my-first-transcription-job"
job_name = "my-first-med-transcription-job"
job_uri = "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
transcribe.start_medical_transcription_job(
MedicalTranscriptionJobName = job_name,
Media = {
'MediaFileUri': job_uri
},
OutputBucketName = 'amzn-s3-demo-bucket',
OutputKey = 'output-files/',
LanguageCode = 'en-US',
Specialty = 'PRIMARYCARE',
Type = 'CONVERSATION',
Settings = {
'ChannelIdentification': True
}
)
while True:
status = transcribe.get_transcription_job(MedicalTranscriptionJobName = job_name)
if status['MedicalTranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']:
break
print("Not ready yet...")
time.sleep(5)
print(status)
```
### AWS CLI
**Pour transcrire un fichier audio multicanal à l’aide d’une tâche de transcription par lots (AWS CLI)**
+ Exécutez le code suivant.
```
aws transcribe start-medical-transcription-job \
--region us-west-2 \
--cli-input-json file://example-start-command.json
```
Le code suivant provient du fichier `example-start-command.json`.
```
{
"MedicalTranscriptionJobName": "my-first-med-transcription-job",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-audio-file.flac"
},
"OutputBucketName": "amzn-s3-demo-bucket",
"OutputKey": "my-output-files/",
"LanguageCode": "en-US",
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION",
"Settings":{
"ChannelIdentification": true
}
}
```
Le code suivant montre la sortie de transcription d’un fichier audio contenant une conversation sur deux canaux.
```
{
"jobName": "job id",
"accountId": "111122223333",
"results": {
"transcripts": [
{
"transcript": "When you try ... It seems to ..."
}
],
"channel_labels": {
"channels": [
{
"channel_label": "ch_0",
"items": [
{
"start_time": "12.282",
"end_time": "12.592",
"alternatives": [
{
"confidence": "1.0000",
"content": "When"
}
],
"type": "pronunciation"
},
{
"start_time": "12.592",
"end_time": "12.692",
"alternatives": [
{
"confidence": "0.8787",
"content": "you"
}
],
"type": "pronunciation"
},
{
"start_time": "12.702",
"end_time": "13.252",
"alternatives": [
{
"confidence": "0.8318",
"content": "try"
}
],
"type": "pronunciation"
},
...
]
},
{
"channel_label": "ch_1",
"items": [
{
"start_time": "12.379",
"end_time": "12.589",
"alternatives": [
{
"confidence": "0.5645",
"content": "It"
}
],
"type": "pronunciation"
},
{
"start_time": "12.599",
"end_time": "12.659",
"alternatives": [
{
"confidence": "0.2907",
"content": "seems"
}
],
"type": "pronunciation"
},
{
"start_time": "12.669",
"end_time": "13.029",
"alternatives": [
{
"confidence": "0.2497",
"content": "to"
}
],
"type": "pronunciation"
},
...
]
}
}
```
## Transcription de flux audio multicanal
Vous pouvez transcrire le son provenant de canaux distincts en HTTP/2 ou en WebSocket flux à l'aide de l'[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html)API.
Par défaut, vous pouvez transcrire des flux sur deux canaux. Vous pouvez demander une augmentation du quota si vous devez transcrire des flux comportant plus de deux canaux. Pour plus d’informations sur la demande d’une augmentation de quota, consultez la section [Service Quotas AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html).
### Transcription de fichiers audio multicanal dans un flux HTTP/2
Pour transcrire du son multicanal dans un flux HTTP/2, utilisez l'[StartMedicalStreamTranscription](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html)API et spécifiez les éléments suivants :
+ `LanguageCode` – Code de langue de l’élément audio. La valeur valide est `en-US`.
+ `MediaEncoding` – Encodage de l’audio. Les valeurs valides sont `ogg-opus`, `flac` et `pcm`.
+ `EnableChannelIdentification` – `true`
+ `NumberOfChannels` – Nombre de canaux dans votre audio en streaming.
Pour plus d’informations sur la configuration d’un flux HTTP/2 pour transcrire une conversation médicale, consultez la section [Configuration d’un flux HTTP/2](streaming-setting-up.md#streaming-http2).
### Transcrire du son multicanal dans un flux WebSocket
Pour partitionner les haut-parleurs en WebSocket flux, utilisez le format suivant pour créer une URI pré-signée et lancer une WebSocket demande. Spécifiez `enable-channel-identification` avec la valeur `true` et le nombre de canaux dans votre flux dans `number-of-channels`. Un URI pré-signé contient les informations nécessaires pour configurer une communication bidirectionnelle entre votre application et Amazon Transcribe Medical.
```
GET wss://transcribestreaming.us-west-2.amazonaws.com:8443/medical-stream-transcription-websocket
?language-code=languageCode
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20220208%2Fus-west-2%2Ftranscribe%2Faws4_request
&X-Amz-Date=20220208T235959Z
&X-Amz-Expires=300
&X-Amz-Security-Token=security-token
&X-Amz-Signature=Signature Version 4 signature
&X-Amz-SignedHeaders=host
&media-encoding=flac
&sample-rate=16000
&session-id=sessionId
&enable-channel-identification=true
&number-of-channels=2
```
Les définitions des paramètres se trouvent dans la [référence d'API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html) ; les paramètres communs à toutes les opérations d' AWS API sont répertoriés dans la section [Paramètres communs](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html).
Pour plus d'informations sur WebSocket les demandes, consultez[Configuration d'un WebSocket stream](streaming-setting-up.md#streaming-websocket).
### Sortie de transcription en streaming multicanal
Le résultat d'une transcription en streaming est le même pour le HTTP/2 et les WebSocket requêtes. Voici un exemple de sortie.
```
{
"resultId": "XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX",
"startTime": 0.11,
"endTime": 0.66,
"isPartial": false,
"alternatives": [
{
"transcript": "Left.",
"items": [
{
"startTime": 0.11,
"endTime": 0.45,
"type": "pronunciation",
"content": "Left",
"vocabularyFilterMatch": false
},
{
"startTime": 0.45,
"endTime": 0.45,
"type": "punctuation",
"content": ".",
"vocabularyFilterMatch": false
}
]
}
],
"channelId": "ch_0"
}
```
Pour chaque segment de discours, une balise `channelId` indique à quel canal appartient le discours.
# Transcription d’une dictée médicale
Vous pouvez utiliser Amazon Transcribe Medical pour transcrire les notes médicales dictées par le médecin à l'aide d'un travail de transcription par lots ou d'un flux en temps réel. Les tâches de transcription par lots vous permettent de transcrire des fichiers audio. Vous spécifiez la spécialité médicale du clinicien dans votre travail ou votre stream de transcription afin de garantir que Amazon Transcribe Medical produit des résultats de transcription avec la plus grande précision possible.
Vous pouvez transcrire une dictée médicale dans les spécialités suivantes :
+ Cardiologie – Disponible en transcription en streaming uniquement
+ Neurologie – Disponible en transcription en streaming uniquement
+ Oncologie – Disponible en transcription en streaming uniquement
+ Soins primaires – Incluent les types de pratique médicale suivants :
+ Médecine familiale
+ Médecine interne
+ Obstétrique et gynécologie (OB-GYN)
+ Pédiatrie
+ Radiologie – Disponible en transcription en streaming uniquement
+ Urologie – Disponible en transcription en streaming uniquement
Vous pouvez améliorer la précision de la transcription en utilisant des vocabulaires personnalisés. Pour plus d’informations sur le fonctionnement des vocabulaires personnalisés médicaux, consultez la section [Amélioration de la précision de la transcription grâce à des vocabulaires personnalisés médicaux](vocabulary-med.md).
Par défaut, Amazon Transcribe Medical renvoie la transcription avec le niveau de confiance le plus élevé. Si vous souhaitez le configurer pour renvoyer des transcriptions alternatives, consultez la section [Génération de transcriptions alternatives](alternative-med-transcriptions.md).
Pour plus d’informations sur la façon dont les nombres et les mesures médicales apparaissent dans la sortie de transcription, consultez les sections [Transcription des nombres](how-numbers-med.md) et [Transcription des termes médicaux et des mesures](how-measurements-med.md).
**Topics**
+ [Transcription d’un fichier audio d’une dictée médicale](batch-medical-dictation.md)
+ [Transcription d’une dictée médicale dans un flux en temps réel](streaming-medical-dictation.md)
# Transcription d’un fichier audio d’une dictée médicale
Utilisez une tâche de transcription par lots pour transcrire les fichiers audio de conversations médicales. Vous pouvez l’utiliser pour transcrire un dialogue entre un médecin et son patient. Vous pouvez démarrer une tâche de transcription par lots dans l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html) ou la AWS Management Console.
Lorsque vous démarrez une tâche de transcription médicale avec l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), vous spécifiez `PRIMARYCARE` comme valeur du paramètre `Specialty`.
## AWS Management Console
**Pour transcrire un dialogue entre un médecin et son patient (AWS Management Console)**
**Pour utiliser le AWS Management Console pour transcrire un dialogue clinicien-patient, créez une tâche de transcription et choisissez le type d'entrée **Conversation for Audio**.**
1. Connectez-vous à la [AWS Management Console](https://console.aws.amazon.com/transcribe/).
1. Dans le volet de navigation, sous Amazon Transcribe Medical, sélectionnez **Transcription jobs**.
1. Choisissez **Créer une tâche**.
1. Sur la page **Spécifier les détails de la tâche**, sous **Paramètres de la tâche**, indiquez les valeurs suivantes :
1. **Nom** : nom de la tâche de transcription.
1. **Type d’entrée audio** : **Dictée**
1. Pour les autres champs, spécifiez l' Amazon S3 emplacement de votre fichier audio et l'endroit où vous souhaitez stocker le résultat de votre travail de transcription.
1. Choisissez **Suivant**.
1. Choisissez **Créer**.
## API
**Pour transcrire une conversation médicale à l’aide d’une tâche de transcription par lots (API)**
+ Pour l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), spécifiez ce qui suit.
1. Pour `MedicalTranscriptionJobName`, spécifiez un nom unique dans votre Compte AWS.
1. Pour `LanguageCode`, spécifiez le code de langue correspondant à la langue parlée dans votre fichier audio et la langue de votre filtre de vocabulaire.
1. Dans le paramètre `MediaFileUri` de l’objet `Media`, spécifiez le nom du fichier audio que vous souhaitez transcrire.
1. Pour `Specialty`, spécifiez la spécialité médicale du médecin qui parle dans le fichier audio.
1. Pour `Type`, spécifiez `DICTATION`.
1. Pour `OutputBucketName`, spécifiez le compartiment Amazon S3 dans lequel stocker les résultats de transcription.
Voici un exemple de demande qui utilise le AWS SDK pour Python (Boto3) pour transcrire une dictée médicale d'un clinicien de la spécialité. `PRIMARYCARE`
```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe')
job_name = "my-first-med-transcription-job"
job_uri = "s3://amzn-s3-demo-bucket/my-input-files/my-audio-file.flac"
transcribe.start_medical_transcription_job(
MedicalTranscriptionJobName = job_name,
Media = {
'MediaFileUri': job_uri
},
OutputBucketName = 'amzn-s3-demo-bucket',
OutputKey = 'my-output-files/',
LanguageCode = 'en-US',
Specialty = 'PRIMARYCARE',
Type = 'DICTATION'
)
while True:
status = transcribe.get_medical_transcription_job(MedicalTranscriptionJobName = job_name)
if status['MedicalTranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']:
break
print("Not ready yet...")
time.sleep(5)
print(status)
```
L’exemple de code suivant montre les résultats de transcription d’une dictée médicale.
```
{
"jobName": "dictation-medical-transcription-job",
"accountId": "111122223333",
"results": {
"transcripts": [
{
"transcript": "... came for a follow up visit today..."
}
],
"items": [
{
...
"start_time": "4.85",
"end_time": "5.12",
"alternatives": [
{
"confidence": "1.0",
"content": "came"
}
],
"type": "pronunciation"
},
{
"start_time": "5.12",
"end_time": "5.29",
"alternatives": [
{
"confidence": "1.0",
"content": "for"
}
],
"type": "pronunciation"
},
{
"start_time": "5.29",
"end_time": "5.33",
"alternatives": [
{
"confidence": "0.9955",
"content": "a"
}
],
"type": "pronunciation"
},
{
"start_time": "5.33",
"end_time": "5.66",
"alternatives": [
{
"confidence": "0.9754",
"content": "follow"
}
],
"type": "pronunciation"
},
{
"start_time": "5.66",
"end_time": "5.75",
"alternatives": [
{
"confidence": "0.9754",
"content": "up"
}
],
"type": "pronunciation"
},
{
"start_time": "5.75",
"end_time": "6.02",
"alternatives": [
{
"confidence": "1.0",
"content": "visit"
}
]
...
},
"status": "COMPLETED"
}
```
## AWS CLI
**Pour activer le partitionnement des locuteurs dans une tâche de transcription par lots (AWS CLI)**
+ Exécutez le code suivant.
```
aws transcribe start-medical-transcription-job \
--region us-west-2 \
--cli-input-json file://example-start-command.json
```
Le code suivant affiche le contenu du fichier `example-start-command.json`.
```
{
"MedicalTranscriptionJobName": "my-first-med-transcription-job",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-audio-file.flac"
},
"OutputBucketName": "amzn-s3-demo-bucket",
"OutputKey": "my-output-files/",
"LanguageCode": "en-US",
"Specialty": "PRIMARYCARE",
"Type": "DICTATION"
}
```
# Transcription d’une dictée médicale dans un flux en temps réel
Utilisez un WebSocket flux pour transcrire une dictée médicale sous forme de flux audio. Vous pouvez également l'utiliser AWS Management Console pour transcrire le discours que vous ou d'autres personnes prononcez directement dans un microphone.
Pour un HTTP/2 ou un WebSocket flux, vous pouvez transcrire du son dans les spécialités médicales suivantes :
+ Cardiologie
+ Oncologie
+ Neurologie
+ Soins primaires
+ Radiologie
+ Urologie
Chaque spécialité médicale comprend de nombreux types de procédures et de rendez-vous. Les médecins dictent donc de nombreux types de notes. Utilisez les exemples suivants pour vous aider à spécifier la valeur du paramètre `specialty` URI de la WebSocket demande ou du `Specialty` paramètre de l'[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html)API :
+ Pour une dictée après une procédure d’électrophysiologie ou d’échocardiogramme, choisissez `CARDIOLOGY`.
+ Pour une dictée après une intervention de chirurgie oncologique ou de radio-oncologie, choisissez `ONCOLOGY`.
+ Pour un médecin dictant des notes indiquant un diagnostic d’encéphalite, choisissez `NEUROLOGY`.
+ Pour une dictée de notes de procédure visant à briser un calcul vésical, choisissez `UROLOGY`.
+ Pour une dictée de notes de médecin après une consultation en médecine interne, choisissez `PRIMARYCARE`.
+ Pour une dictée d’un médecin communiquant les résultats d’une tomodensitométrie, d’une TEP, d’une IRM ou d’une radiographie, choisissez `RADIOLOGY`.
+ Pour une dictée de notes de médecin après une consultation en gynécologie, choisissez `PRIMARYCARE`.
Pour améliorer la précision de transcription de termes spécifiques dans un flux en temps réel, utilisez un vocabulaire personnalisé. Pour activer un vocabulaire personnalisé, définissez la valeur du `vocabulary-name` sur le nom du vocabulaire personnalisé que vous souhaitez utiliser.
## Transcrire une dictée prononcée dans votre micro à l'aide du AWS Management Console
AWS Management Console Pour transcrire le son en streaming d'une dictée médicale, choisissez l'option permettant de transcrire une dictée médicale, de démarrer le flux et de commencer à parler dans le microphone.
**Pour transcrire l’audio en streaming d’une dictée médicale (AWS Management Console)**
1. Connectez-vous à la [AWS Management Console](https://console.aws.amazon.com/transcribe/).
1. Dans le volet de navigation, sous Amazon Transcribe Médical, sélectionnez **Transcription en temps réel**.
1. Choisissez **Dictée.**
1. Pour **Spécialité médicale**, choisissez la spécialité médicale du médecin qui parle dans le flux.
1. Choisissez **Démarrer le streaming**.
1. Parlez dans le microphone.
## Transcription d’une dictée dans un flux HTTP/2
Pour transcrire le flux HTTP/2 d’une dictée médicale, utilisez l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html) et spécifiez les éléments suivants :
+ `LanguageCode` – Code de langue. La valeur valide est `en-US`.
+ `MediaEncoding` – Encodage utilisé pour l’audio en entrée. Les valeurs valides sont `pcm`, `ogg-opus` et `flac`.
+ `Specialty` – Spécialité du professionnel de santé.
+ `Type` – `DICTATION`
Pour plus d’informations sur la configuration d’un flux HTTP/2 pour transcrire une dictée médicale, consultez la section [Configuration d’un flux HTTP/2](streaming-setting-up.md#streaming-http2).
## Utiliser une demande de WebSocket streaming pour transcrire une dictée médicale
Pour transcrire une dictée médicale dans un flux en temps réel à l'aide d'une WebSocket demande, vous devez créer un URI présigné. Cet URI contient les informations nécessaires pour configurer le flux audio entre votre application et Amazon Transcribe Medical. Pour plus d'informations sur la création de WebSocket demandes, consultez[Configuration d'un WebSocket stream](streaming-setting-up.md#streaming-websocket).
Utilisez le modèle suivant pour créer votre URI pré-signé.
```
GET wss://transcribestreaming.us-west-2.amazonaws.com:8443/medical-stream-transcription-websocket
?language-code=languageCode
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20220208%2Fus-west-2%2Ftranscribe%2Faws4_request
&X-Amz-Date=20220208T235959Z
&X-Amz-Expires=300
&X-Amz-Security-Token=security-token
&X-Amz-Signature=Signature Version 4 signature
&X-Amz-SignedHeaders=host
&media-encoding=flac
&sample-rate=16000
&session-id=sessionId
&specialty=medicalSpecialty
&type=DICTATION
&vocabulary-name=vocabularyName
&show-speaker-label=boolean
```
Pour plus d'informations sur la création de documents pré-signés URIs, consultez[Configuration d'un WebSocket stream](streaming-setting-up.md#streaming-websocket).
# Amélioration de la précision de la transcription grâce à des vocabulaires personnalisés médicaux
Pour améliorer la précision de la transcription dans Amazon Transcribe Medical, créez et utilisez un ou plusieurs vocabulaires médicaux personnalisés. Un *vocabulaire personnalisé* est un ensemble de mots ou d’expressions spécifiques à un domaine. Cette collection contribue à améliorer les performances de Amazon Transcribe Medical dans la transcription de ces mots ou phrases.
Vous êtes responsable de l'intégrité de vos propres données lorsque vous utilisez Amazon Transcribe Medical. N’entrez pas d’informations confidentielles, personnelles (PII) ou de renseignements personnels sur la santé (PHI) protégés dans un vocabulaire personnalisé.
Pour de meilleurs résultats, créez de petits vocabulaires personnalisés distincts qui aident à transcrire un enregistrement audio spécifique. La précision de la transcription sera plus grande que si vous aviez créé un grand vocabulaire personnalisé à utiliser avec tous vos enregistrements.
Par défaut, vous pouvez avoir jusqu'à 100 vocabulaires personnalisés dans votre. Compte AWS La taille d’un vocabulaire personnalisé ne doit pas dépasser 50 Ko. Pour plus d'informations sur les demandes d'augmentation du nombre de vocabulaires personnalisés que vous pouvez inclure dans votre compte Compte AWS, consultez la section Quotas de [AWS service](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html).
Les vocabulaires personnalisés sont disponibles en anglais américain (en-US).
**Topics**
+ [Création d’un fichier texte pour votre vocabulaire personnalisé médical](create-med-vocab-text.md)
+ [Utilisation d’un fichier texte pour créer un vocabulaire personnalisé médical](create-med-custom-vocabulary.md)
+ [Transcription d’un fichier audio à l’aide d’un vocabulaire personnalisé médical](start-med-custom-vocab-job.md)
+ [Transcription d’un flux en temps réel à l’aide d’un vocabulaire personnalisé médical](start-med-vocab-stream.md)
+ [Jeu de caractères pour Amazon Transcribe Medical](charsets-med.md)
# Création d’un fichier texte pour votre vocabulaire personnalisé médical
Pour créer un vocabulaire personnalisé, vous devez créer un fichier texte au format UTF-8. Dans ce fichier, créez un tableau à quatre colonnes, chaque colonne spécifiant un champ. Chaque champ indique à Amazon Transcribe Medical comment les termes spécifiques au domaine sont prononcés ou comment les afficher dans vos transcriptions. Stockez le fichier texte contenant ces champs dans un compartiment Amazon S3 .
## Formatage de votre fichier texte
Pour créer un vocabulaire personnalisé médical, entrez les noms des colonnes sous forme de ligne d’en-tête. Entrez les valeurs de chaque colonne sous la ligne d’en-tête.
Les noms des quatre colonnes du tableau sont les suivants :
+ `Phrase` – colonne obligatoire, valeurs obligatoires
+ `IPA` – colonne obligatoire, valeurs facultatives
+ `SoundsLike` – colonne obligatoire, valeurs facultatives
+ `DisplayAs` – colonne obligatoire, valeurs facultatives
Avant de créer un vocabulaire personnalisé :
+ Séparez chaque colonne par un seul caractère de tabulation. Amazon Transcribe renvoie un message d'erreur si vous essayez de séparer les colonnes par des espaces ou par plusieurs caractères de tabulation.
+ Assurez-vous qu’il n’y a pas d’espaces de fin ou d’espaces blanc après chaque valeur d’une colonne.
Assurez-vous que les valeurs que vous entrez pour chaque colonne :
+ ont moins de 256 caractères, tirets compris ;
+ utilisent uniquement des caractères du jeu de caractères autorisés (voir [Jeu de caractères pour Amazon Transcribe Medical](charsets-med.md)).
## Saisie de valeurs pour les colonnes du tableau
Les informations suivantes expliquent comment définir des valeurs pour les quatre colonnes du tableau :
+ `Phrase` – Terme ou expression qui doit être reconnu. Vous devez entrer des valeurs dans cette colonne.
Si l’entrée est une expression, séparez les termes par un trait d’union (-). Par exemple, entrez **cerebral autosomal dominant arteriopathy with subcortical infarcts and leukoencephalopathy** en tant que **cerebral-autosomal-dominant-arteriopathy-with-subcortical-infarcts-and-leukoencephalopathy**.
Saisissez les acronymes ou les autres termes dont les lettres doivent être prononcées individuellement en séparant les lettres par un point, par exemple **D.N.A.** ou **S.T.E.M.I.**. Pour saisir le pluriel d'un acronyme, tel que « »STEMIs, séparez le « s » de l'acronyme par un trait d'union : « **S.T.E.M.I-s** » Vous pouvez utiliser des lettres majuscules ou minuscules pour les acronymes.
La colonne `Phrase` est obligatoire. Vous pouvez utiliser n’importe quel caractère autorisé pour la langue saisie. Pour connaître les caractères autorisés, veuillez consulter [Jeu de caractères pour Amazon Transcribe Medical](charsets-med.md). Si vous ne spécifiez pas la `DisplayAs` colonne, Amazon Transcribe Medical utilise le contenu de la `Phrase` colonne dans le fichier de sortie.
+ `IPA` (la colonne est obligatoire, les valeurs peuvent être facultatives) – Pour spécifier la prononciation d’un mot ou d’une expression, vous pouvez inclure des caractères de l’[alphabet phonétique international (API)](https://en.wikipedia.org/wiki/International_Phonetic_Alphabet) dans cette colonne. La colonne `IPA` ne peut pas inclure des espaces de début ou de fin, et vous devez utiliser un seul espace pour séparer chaque phonème dans la saisie. Par exemple, en anglais, pour l’expression **acute-respiratory-distress-syndrome**, vous saisissez **ə k j u t ɹ ɛ s p ɪ ɹ ə t ɔ ɹ i d ɪ s t ɹ ɛ s s ɪ n d ɹ oʊ m**. Pour l’expression **A.L.L.**, vous saisissez **eɪ ɛ l ɛ l**.
Même si vous ne spécifiez pas le contenu de la colonne `IPA`, vous devez inclure une colonne `IPA` vide. Si vous incluez des valeurs dans la colonne `IPA`, vous ne pouvez pas fournir de valeurs pour la colonne `SoundsLike`.
Pour obtenir la liste des caractères phonétiques de l’alphabet phonétique international autorisés pour une langue spécifique, veuillez consulter [Jeu de caractères pour Amazon Transcribe Medical](charsets-med.md). L'anglais américain est la seule langue disponible en Amazon Transcribe médecine.
+ `SoundsLike` (la colonne est obligatoire, les valeurs peuvent être facultatives) – Vous pouvez décomposer un mot ou une expression en plusieurs segments et attribuer une prononciation à chaque segment à l’aide de l’orthographe standard pour imiter la prononciation du mot. Par exemple, en anglais, vous pouvez fournir des conseils pour la prononciation de l’expression **cerebral-autosomal-dominant-arteriopathy-with-subcortical-infarcts-and-leukoencephalopathy** : **sir-e-brul-aut-o-som-ul-dah-mi-nant-ar-ter-ri-o-pa-thy-with-sub-cor-ti-cul-in-farcts-and-lewk-o-en-ce-phul-ah-pu-thy**. Le conseil pour l’expression **atrioventricular-nodal-reentrant-tachycardia** serait : **ay-tree-o-ven-trick-u-lar-node-al-re-entr-ant-tack-ih-card-ia**. Les parties de l’indication doivent être séparées par un trait d’union (-).
Même si vous ne spécifiez pas de valeurs pour la colonne `SoundsLike`, vous devez inclure une colonne `SoundsLike` vide. Si vous incluez des valeurs dans la colonne `SoundsLike`, vous ne pouvez pas fournir de valeurs pour la colonne `IPA`.
Vous pouvez utiliser n’importe quel caractère autorisé pour la langue saisie. Pour obtenir la liste des caractères autorisés, veuillez consulter [Jeu de caractères pour Amazon Transcribe Medical](charsets-med.md).
+ `DisplayAs` (la colonne est obligatoire, les valeurs peuvent être facultatives) – Définit l’affichage du mot ou de l’expression. Par exemple, si le terme ou l’expression est **cerebral-autosomal-dominant-arteriopathy-with-subcortical-infarcts-and-leukoencephalopathy**, vous pouvez décider d’afficher `cerebral autosomal dominant arteriopathy with subcortical infarcts and leukoencephalopathy` afin que les tirets n’apparaissent pas. Vous pouvez également spécifier `DisplayAs` comme `CADASIL` si vous souhaitez afficher l’acronyme au lieu du terme complet dans la sortie.
Si vous ne spécifiez pas de `DisplayAs` colonne, Amazon Transcribe Medical utilise la `Phrase` colonne du fichier d'entrée dans la sortie.
Vous pouvez utiliser n’importe quel caractère UTF-8 dans la colonne `DisplayAs`.
Vous pouvez inclure des espaces uniquement pour les valeurs des colonnes `IPA` et `DisplayAs`.
Pour créer le fichier texte de votre vocabulaire personnalisé, placez chaque mot ou expression de votre fichier texte sur une ligne distincte. Séparez les colonnes par des caractères de tabulation. Incluez des espaces uniquement pour les valeurs des colonnes `IPA` et `DisplayAs`. Enregistrez le fichier avec l'extension `.txt` dans un Amazon S3 compartiment dans Région AWS lequel vous utilisez Amazon Transcribe Medical pour créer votre vocabulaire personnalisé.
Si vous modifiez votre fichier texte dans Windows, assurez-vous que votre fichier est au format `LF` et non au format `CRLF`. Sinon, vous ne pourrez pas créer votre glossaire personnalisé. Certains éditeurs de texte vous permettent de modifier la mise en forme à l’aide des commandes Rechercher et Remplacer.
Les exemples suivants montrent du texte que vous pouvez utiliser pour créer des glossaires personnalisés. Pour créer un glossaire personnalisé à partir de ces exemples, copiez un exemple dans un éditeur de texte, remplacez `[TAB]` par un caractère de tabulation et téléchargez le fichier texte enregistré dans Amazon S3.
```
Phrase[TAB]IPA[TAB]SoundsLike[TAB]DisplayAs
acute-respiratory-distress-syndrome[TAB][TAB][TAB]acute respiratory distress syndrome
A.L.L.[TAB]eɪ ɛ l ɛ l[TAB][TAB]ALL
atrioventricular-nodal-reentrant-tachycardia[TAB][TAB]ay-tree-o-ven-trick-u-lar-node-al-re-entr-ant-tack-ih-card-ia[TAB]
```
Vous pouvez entrer des colonnes dans n’importe quel ordre. Les exemples suivants montrent d’autres structures valides pour le fichier d’entrée du glossaire personnalisé.
```
Phrase[TAB]SoundsLike[TAB]IPA[TAB]DisplayAs
acute-respiratory-distress-syndrome[TAB][TAB][TAB]acute respiratory distress syndrome
A.L.L.[TAB][TAB]eɪ ɛ l ɛ l[TAB]ALL
atrioventricular-nodal-reentrant-tachycardia[TAB]ay-tree-o-ven-trick-u-lar-node-al-re-entr-ant-tack-ih-card-ia[TAB][TAB]
```
```
DisplayAs[TAB]SoundsLike[TAB]IPA[TAB]Phrase
acute respiratory distress syndrome[TAB][TAB][TAB]acute-respiratory-distress-syndrome
ALL[TAB][TAB]eɪ ɛ l ɛ l[TAB]A.L.L.
[TAB]ay-tree-o-ven-trick-u-lar-node-al-re-entr-ant-tack-ih-card-ia[TAB][TAB]atrioventricular-nodal-reentrant-tachycardia
```
Pour faciliter la lecture, les tableaux suivants montrent plus clairement les exemples précédents au format html. Ils ne sont destinés qu’à illustrer les exemples.
| Expression | IPA | SoundsLike | DisplayAs |
| --- | --- | --- | --- |
| acute-respiratory-distress-syndrome | | | acute respiratory distress syndrome |
| A.L.L. | eɪ ɛ l ɛ l | | ALL |
| atrioventricular-nodal-reentrant-tachycardia | | ay-tree-o-ven-trick-u-lar-node-al-re-entr-ant-tack-ih-card-ia | |
| Expression | SoundsLike | IPA | DisplayAs |
| --- | --- | --- | --- |
| acute-respiratory-distress-syndrome | | | acute respiratory distress syndrome |
| atrioventricular-nodal-reentrant-tachycardia | ay-tree-o-ven-trick-u-lar-node-al-re-entr-ant-tack-ih-card-ia | | |
| A.L.L. | | eɪ ɛ l ɛ l | ALL |
| DisplayAs | SoundsLike | IPA | Expression |
| --- | --- | --- | --- |
| acute respiratory distress syndrome | | | acute-respiratory-distress-syndrome |
| ALL | | eɪ ɛ l ɛ l | A.L.L. |
| | ay-tree-o-ven-trick-u-lar-node-al-re-entr-ant-tack-ih-card-ia | | atrioventricular-nodal-reentrant-tachycardia |
# Utilisation d’un fichier texte pour créer un vocabulaire personnalisé médical
Pour créer un vocabulaire personnalisé, vous devez avoir préparé un fichier texte contenant un ensemble de mots ou de phrases. Amazon Transcribe Medical utilise ce fichier texte pour créer un vocabulaire personnalisé que vous pouvez utiliser pour améliorer la précision de transcription de ces mots ou phrases. Vous pouvez créer un vocabulaire personnalisé à l'aide de l'[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html)API ou de la console Amazon Transcribe médicale.
## AWS Management Console
Pour utiliser le AWS Management Console afin de créer un vocabulaire personnalisé, vous devez fournir l' Amazon S3 URI du fichier texte contenant vos mots ou expressions.
1. Connectez-vous à la [AWS Management Console](https://console.aws.amazon.com/transcribe/).
1. Dans le volet de navigation, sous Amazon Transcribe Médical, sélectionnez **Vocabulaire personnalisé**.
1. Pour **Nom**, sous **Paramètres de vocabulaire**, choisissez un nom pour votre vocabulaire personnalisé.
1. Spécifiez l’emplacement de votre fichier audio ou vidéo dans Amazon S3 :
+ Pour **Emplacement du fichier d’entrée de vocabulaire sur S3**, sous **Paramètres de vocabulaire**, spécifiez l’URI Amazon S3 qui identifie le fichier texte que vous utiliserez pour créer votre vocabulaire personnalisé.
+ Pour **Emplacement du fichier d’entrée de vocabulaire dans S3**, choisissez **Parcourir S3** pour rechercher le fichier texte et sélectionnez-le.
1. Choisissez **Créer un vocabulaire**.
Vous pouvez voir le statut de traitement de votre vocabulaire personnalisé dans la AWS Management Console.
## API
**Pour créer un vocabulaire personnalisé médical (API)**
+ Pour l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html), spécifiez ce qui suit.
1. Pour `LanguageCode`, spécifiez `en-US`.
1. Pour`VocabularyFileUri`, spécifiez l' Amazon S3 emplacement du fichier texte que vous utilisez pour définir votre vocabulaire personnalisé.
1. Pour `VocabularyName`, spécifiez un nom pour votre vocabulaire personnalisé. Le nom que vous spécifiez doit être unique au sein de votre Compte AWS.
Pour voir le statut de traitement de votre vocabulaire personnalisé, utilisez l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetMedicalVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetMedicalVocabulary.html).
Voici un exemple de demande utilisant le AWS SDK pour Python (Boto3) pour créer un vocabulaire personnalisé.
```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
vocab_name = "my-first-vocabulary"
response = transcribe.create_medical_vocabulary(
VocabularyName = job_name,
VocabularyFileUri = 's3://amzn-s3-demo-bucket/my-vocabularies/my-vocabulary-table.txt'
LanguageCode = 'en-US',
)
while True:
status = transcribe.get_medical_vocabulary(VocabularyName = vocab_name)
if status['VocabularyState'] in ['READY', 'FAILED']:
break
print("Not ready yet...")
time.sleep(5)
print(status)
```
## AWS CLI
**Pour activer le partitionnement des locuteurs dans une tâche de transcription par lots (AWS CLI)**
+ Exécutez le code suivant.
```
aws transcribe create-medical-vocabulary \
--vocabulary-name my-first-vocabulary \
--vocabulary-file-uri s3://amzn-s3-demo-bucket/my-vocabularies/my-vocabulary-file.txt \
--language-code en-US
```
# Transcription d’un fichier audio à l’aide d’un vocabulaire personnalisé médical
Utilisez le [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html)ou AWS Management Console pour démarrer une tâche de transcription qui utilise un vocabulaire personnalisé afin d'améliorer la précision de la transcription.
## AWS Management Console
1. Connectez-vous à la [AWS Management Console](https://console.aws.amazon.com/transcribe/).
1. Dans le volet de navigation, sous Amazon Transcribe Medical, sélectionnez **Transcription jobs**.
1. Choisissez **Créer une tâche**.
1. Sur la page **Spécifier les détails de la tâche**, fournissez des informations sur votre tâche de transcription.
1. Choisissez **Suivant**.
1. Sous **Personnalisation**, activez **Vocabulaire personnalisé**.
1. Sous **Sélection du vocabulaire**, choisissez un vocabulaire personnalisé.
1. Choisissez **Créer**.
## API
**Pour activer le partitionnement de locuteurs dans un fichier audio à l’aide d’une tâche de transcription par lots (API)**
+ Pour l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), spécifiez ce qui suit.
1. Pour `MedicalTranscriptionJobName`, spécifiez un nom unique dans votre Compte AWS.
1. Pour `LanguageCode`, spécifiez le code de langue correspondant à la langue parlée dans votre fichier audio et la langue de votre filtre de vocabulaire.
1. Pour le paramètre `MediaFileUri` de l’objet `Media`, spécifiez le nom du fichier audio que vous souhaitez transcrire.
1. Pour `Specialty`, spécifiez la spécialité médicale du médecin qui parle dans le fichier audio.
1. Pour `Type`, spécifiez si le fichier audio est une conversation ou une dictée.
1. Pour `OutputBucketName`, spécifiez le compartiment Amazon S3 dans lequel stocker les résultats de transcription.
1. Pour l’objet `Settings`, spécifiez ce qui suit :
1. `VocabularyName` – Nom de votre vocabulaire personnalisé.
La requête suivante utilise le AWS SDK pour Python (Boto3) pour démarrer une tâche de transcription par lots avec un vocabulaire personnalisé.
```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
job_name = "my-first-med-transcription-job"
job_uri = "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
transcribe.start_medical_transcription_job(
MedicalTranscriptionJobName = job_name,
Media = {
'MediaFileUri': job_uri
},
OutputBucketName = 'amzn-s3-demo-bucket',
OutputKey = 'my-output-files/',
LanguageCode = 'en-US',
Specialty = 'PRIMARYCARE',
Type = 'CONVERSATION',
Settings = {
'VocabularyName': 'example-med-custom-vocab'
}
)
while True:
status = transcribe.get_medical_transcription_job(MedicalTranscriptionJobName = job_name)
if status['MedicalTranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']:
break
print("Not ready yet...")
time.sleep(5)
print(status)
```
# Transcription d’un flux en temps réel à l’aide d’un vocabulaire personnalisé médical
Pour améliorer la précision de la transcription dans un flux en temps réel, vous pouvez utiliser un vocabulaire personnalisé en utilisant HTTP/2 ou WebSocket des flux. Pour démarrer une requête HTTP/2, utilisez l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html). Vous pouvez utiliser un vocabulaire personnalisé en temps réel à AWS Management Console l'aide de l'[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html)API ou du WebSocket protocole.
## Transcription d’une dictée prononcée dans votre microphone (AWS Management Console)
AWS Management Console Pour transcrire le son en streaming d'une dictée médicale, choisissez l'option permettant de transcrire une dictée médicale, de démarrer le flux et de commencer à parler dans le microphone.
**Pour transcrire l’audio en streaming d’une dictée médicale (AWS Management Console)**
1. Connectez-vous à la [AWS Management Console](https://console.aws.amazon.com/transcribe/).
1. Dans le volet de navigation, sous Amazon Transcribe Médical, sélectionnez **Transcription en temps réel**.
1. Pour **Spécialité médicale**, choisissez la spécialité médicale du médecin qui parle dans le flux.
1. Pour **Type d’entrée audio**, choisissez **Conversation** ou **Dictée**.
1. Pour **Paramètres supplémentaires**, choisissez **Vocabulaire personnalisé**.
1. Pour **Sélection du vocabulaire**, choisissez le vocabulaire personnalisé.
1. Choisissez **Démarrer le streaming**.
1. Parlez dans le microphone.
## Activation du partitionnement des locuteurs dans un flux HTTP/2
Voici la syntaxe des paramètres d’une requête HTTP/2.
```
POST /medical-stream-transcription HTTP/2
host: transcribestreaming.us-west-2.amazonaws.com
authorization: Generated value
x-amz-target: com.amazonaws.transcribe.Transcribe.StartMedicalStreamTranscription
x-amz-content-sha256: STREAMING-MED-AWS4-HMAC-SHA256-EVENTS
x-amz-date: 20220208T235959Z
x-amzn-transcribe-session-id: my-first-http2-med-stream
x-amzn-transcribe-language-code: en-US
x-amzn-transcribe-media-encoding: flac
x-amzn-transcribe-sample-rate: 16000
x-amzn-transcribe-vocabulary-name: my-first-med-vocab
x-amzn-transcribe-specialty: PRIMARYCARE
x-amzn-transcribe-type: CONVERSATION
x-amzn-transcribe-show-speaker-label: true
Content-type: application/vnd.amazon.eventstream
transfer-encoding: chunked
```
Descriptions des paramètres :
+ **host** : Mettez à jour le Région AWS (« us-west-2 » dans l'exemple précédent) avec le nom que vous appelez. Région AWS Pour obtenir la liste des points de terminaison valides Régions AWS, consultez la section [Régions AWS et les points de terminaison](https://docs.aws.amazon.com/general/latest/gr/rande.html#transcribe_region).
+ **authorization** : il s’agit d’un champ généré. Pour en savoir plus sur la création d'une signature, voir [Signature des AWS demandes avec Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/sigv4_signing.html).
+ **x-amz-target**: Ne modifiez pas ce champ ; utilisez le contenu indiqué dans l'exemple précédent.
+ **x-amz-content-sha256** : Il s'agit d'un champ généré. Pour en savoir plus sur le calcul d'une signature, voir [Signature des AWS demandes avec Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/sigv4_signing.html).
+ **x-amz-date**: date et heure de création de la signature. Le format est YYYYMMDDTHHMMSSZ, où YYYY=année, MM=mois, DD=jour, HH=heure, MM=minute, SS=secondes, et ’T’ et ’Z’ sont des caractères fixes. Pour plus d’informations, consultez la section [Gestion des dates dans Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/sigv4-date-handling.html).
+ **x-amzn-transcribe-session-id** : nom de votre session de streaming.
+ **x-amzn-transcribe-language-code** : L'encodage utilisé pour votre entrée audio. Reportez-vous à la section [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html) ou [Langues prises en charge et fonctionnalités spécifiques aux langues](supported-languages.md) pour obtenir la liste des valeurs valides.
+ **x-amzn-transcribe-media-encoding** : L'encodage utilisé pour votre entrée audio. Les valeurs valides sont `pcm`, `ogg-opus` et `flac`.
+ **x-amzn-transcribe-sample-rate : fréquence** d'échantillonnage de l'audio d'entrée (en Hertz). Amazon Transcribe prend en charge une plage de 8 000 Hz à 48 000 Hz. Le son de faible qualité, tel que le son du téléphone, se situe généralement autour de 8 000 Hz. Le son de haute qualité est généralement compris entre 16 000 Hz et 48 000 Hz. Notez que la fréquence d’échantillonnage que vous spécifiez **doit** correspondre à celle de votre audio.
+ **x-amzn-transcribe-vocabulary-name** : nom du vocabulaire que vous souhaitez utiliser pour votre transcription.
+ **x-amzn-transcribe-specialty**: La spécialité médicale en cours de transcription.
+ **x-amzn-transcribe-type**: Choisissez s'il s'agit d'une dictée ou d'une conversation.
+ **x-amzn-transcribe-show-speaker-label** : pour activer la diarisation, cette valeur doit être. `true`
+ **content-type** : ne modifiez pas ce champ ; utilisez le contenu indiqué dans l’exemple précédent.
## Activation du partitionnement des haut-parleurs dans une demande WebSocket
Pour partitionner les locuteurs en WebSocket flux à l'aide de l'API, utilisez le format suivant pour créer une URI pré-signée afin de lancer une WebSocket demande et de définir `vocabulary-name` le nom du vocabulaire personnalisé.
```
GET wss://transcribestreaming.us-west-2.amazonaws.com:8443/medical-stream-transcription-websocket
?language-code=en-US
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20220208%2Fus-west-2%2Ftranscribe%2Faws4_request
&X-Amz-Date=20220208T235959Z
&X-Amz-Expires=300
&X-Amz-Security-Token=security-token
&X-Amz-Signature=Signature Version 4 signature
&X-Amz-SignedHeaders=host
&media-encoding=flac
&sample-rate=16000
&session-id=sessionId
&specialty=medicalSpecialty
&type=CONVERSATION
&vocabulary-name=vocabularyName
&show-speaker-label=boolean
```
# Jeu de caractères pour Amazon Transcribe Medical
Pour utiliser des vocabulaires personnalisés dans Amazon Transcribe Medical, utilisez le jeu de caractères suivant.
## Jeu de caractères anglais
Pour les glossaires personnalisés en anglais, vous pouvez utiliser les caractères suivants dans les colonnes `Phrase` et `SoundsLike` :
+ a - z
+ A - Z
+ ’ (apostrophe)
+ - (trait d'union)
+ . (point)
Vous pouvez utiliser les caractères de l’alphabet phonétique international dans la colonne `IPA` du fichier d’entrée du glossaire.
| Caractère | Code | Caractère | Code |
| --- | --- | --- | --- |
| aʊ | 0061 028A | w | 0077 |
| aɪ | 0061 026A | z | 007A |
| b | 0062 | æ | 00E6 |
| d | 0064 | ð | 00F0 |
| eɪ | 0065 026A | ŋ | 014B |
| f | 0066 | ɑ | 0251 |
| g | 0067 | ɔ | 0254 |
| h | 0068 | ɔɪ | 0254 026A |
| i | 0069 | ə | 0259 |
| j | 006A | ɛ | 025B |
| k | 006B | ɝ | 025D |
| l | 006C | ɡ | 0261 |
| l̩ | 006C 0329 | ɪ | 026A |
| m | 006D | ɹ | 0279 |
| n | 006E | ʃ | 0283 |
| n̩ | 006E 0329 | ʊ | 028A |
| oʊ | 006F 028A | ʌ | 028C |
| p | 0070 | ʍ | 028D |
| s | 0073 | ʒ | 0292 |
| t | 0074 | ʤ | 02A4 |
| u | 0075 | ʧ | 02A7 |
| v | 0076 | θ | 03B8 |
# Identification des renseignements personnels sur la santé (PHI) dans une transcription
Utilisez l’*Identification des renseignements personnels sur la santé* pour marquer les PHI dans vos résultats de transcription. En consultant les étiquettes, vous pouvez trouver des PHI qui pourraient être utilisés pour identifier un patient.
Vous pouvez identifier les PHI à l’aide d’un flux en temps réel ou d’une tâche de transcription par lots.
Vous pouvez utiliser votre propre post-traitement pour expurger les PHI identifiés dans la sortie de la transcription.
Utilisez l’Identification des renseignements personnels sur la santé pour identifier les types de PHI suivants :
+ PHI personnels :
+ Noms – Nom complet ou nom de famille et initiale
+ Gender
+ Age
+ Numéros de téléphone
+ Dates (année non comprise) directement liées au patient
+ Adresses e-mail
+ PHI géographique :
+ Adresse physique
+ Code postal
+ Nom du centre médical ou du cabinet
+ PHI de compte :
+ Numéros de télécopie
+ Numéros de sécurité sociale (SSNs)
+ Numéros des bénéficiaires de l’assurance maladie
+ Numéros de comptes
+ Numéros de certificat ou de licence
+ PHI de véhicule :
+ Numéro d’identification de véhicule (VIN)
+ Numéro de plaque d’immatriculation
+ Autres PHI :
+ Emplacement uniforme des ressources sur le Web (URL)
+ Numéros d’adresse IP (Internet Protocol)
Amazon Transcribe Medical est un service éligible à la Health Insurance Portability and Accountability Act de 1996 (HIPAA). Pour de plus amples informations, veuillez consulter [Amazon Transcribe Médical](transcribe-medical.md). Pour plus d’informations sur l’identification des PHI dans un fichier audio, consultez la section [Identification des PHI dans un fichier audio](phi-id-batch.md). Pour plus d’informations sur l’identification des PHI dans un flux, consultez la section [Identification des PHI dans un flux en temps réel](phi-id-stream.md).
**Topics**
+ [Identification des PHI dans un fichier audio](phi-id-batch.md)
+ [Identification des PHI dans un flux en temps réel](phi-id-stream.md)
# Identification des PHI dans un fichier audio
Utilisez une tâche de transcription par lots pour transcrire des fichiers audio et identifier les renseignements personnels sur la santé (PHI) qu’ils contiennent. Lorsque vous activez l'identification par les informations de santé personnelles (PHI), Amazon Transcribe Medical étiquette le PHI identifié dans les résultats de transcription. Pour plus d'informations sur le PHI que Amazon Transcribe Medical peut identifier, consultez[Identification des renseignements personnels sur la santé (PHI) dans une transcription](phi-id.md).
Vous pouvez démarrer une tâche de transcription par lots à l’aide de l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html) ou de la AWS Management Console.
## AWS Management Console
**Pour utiliser le AWS Management Console pour transcrire un dialogue clinicien-patient, créez une tâche de transcription et choisissez le type d'entrée **Conversation for Audio**.**
**Pour transcrire un fichier audio et identifier ses PHI (AWS Management Console)**
1. Connectez-vous à la [AWS Management Console](https://console.aws.amazon.com/transcribe/).
1. Dans le volet de navigation, sous Amazon Transcribe Medical, sélectionnez **Transcription jobs**.
1. Choisissez **Créer une tâche**.
1. Sur la page **Spécifier les détails de la tâche**, sous **Paramètres de la tâche**, indiquez les valeurs suivantes :
1. **Nom** — Le nom de la tâche de transcription qui est propre à votre Compte AWS.
1. **Type d’entrée audio** – **Conversation** ou **Dictée**.
1. Pour les autres champs, spécifiez l' Amazon S3 emplacement de votre fichier audio et l'endroit où vous souhaitez stocker le résultat de votre travail de transcription.
1. Choisissez **Suivant**.
1. Sous **Paramètres audio**, choisissez **Identification des PHI**.
1. Choisissez **Créer**.
## API
**Pour transcrire un fichier audio et identifier ses PHI à l’aide d’une tâche de transcription par lots (API)**
+ Pour l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), spécifiez ce qui suit.
1. Pour `MedicalTranscriptionJobName`, spécifiez un nom unique pour votre Compte AWS.
1. Pour `LanguageCode`, spécifiez le code de langue correspondant à la langue parlée dans votre fichier audio.
1. Pour le paramètre `MediaFileUri` de l’objet `Media`, spécifiez le nom du fichier audio que vous souhaitez transcrire.
1. Pour `Specialty`, indiquez `PRIMARYCARE` comme spécialité médicale du médecin qui parle dans le fichier audio.
1. Pour `Type`, spécifiez `CONVERSATION` ou `DICTATION`.
1. Pour `OutputBucketName`, spécifiez le compartiment Amazon S3 dans lequel stocker les résultats de transcription.
Voici un exemple de demande qui utilise le AWS SDK pour Python (Boto3) pour transcrire un fichier audio et identifier le PHI d'un patient.
```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe')
job_name = "my-first-transcription-job"
job_uri = "s3://amzn-s3-demo-bucket/my-input-files/my-audio-file.flac"
transcribe.start_medical_transcription_job(
MedicalTranscriptionJobName = job_name,
Media = {'MediaFileUri': job_uri},
LanguageCode = 'en-US',
ContentIdentificationType = 'PHI',
Specialty = 'PRIMARYCARE',
Type = 'type', # Specify 'CONVERSATION' for a medical conversation. Specify 'DICTATION' for a medical dictation.
OutputBucketName = 'amzn-s3-demo-bucket'
)
while True:
status = transcribe.get_medical_transcription_job(MedicalTranscriptionJobName = job_name)
if status['MedicalTranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']:
break
print("Not ready yet...")
time.sleep(5)
print(status)
```
L’exemple de code suivant montre les résultats de transcription avec les PHI du patient identifiés.
```
{
"jobName": "my-medical-transcription-job-name",
"accountId": "111122223333",
"results": {
"transcripts": [{
"transcript": "The patient's name is Bertrand."
}],
"items": [{
"id": 0,
"start_time": "0.0",
"end_time": "0.37",
"alternatives": [{
"confidence": "0.9993",
"content": "The"
}],
"type": "pronunciation"
}, {
"id": 1,
"start_time": "0.37",
"end_time": "0.44",
"alternatives": [{
"confidence": "0.9981",
"content": "patient's"
}],
"type": "pronunciation"
}, {
"id": 2,
"start_time": "0.44",
"end_time": "0.52",
"alternatives": [{
"confidence": "1.0",
"content": "name"
}],
"type": "pronunciation"
}, {
"id": 3,
"start_time": "0.52",
"end_time": "0.92",
"alternatives": [{
"confidence": "1.0",
"content": "is"
}],
"type": "pronunciation"
}, {
"id": 4,
"start_time": "0.92",
"end_time": "0.9989",
"alternatives": [{
"confidence": "1.0",
"content": "Bertrand"
}],
"type": "pronunciation"
}, {
"id": 5,
"alternatives": [{
"confidence": "0.0",
"content": "."
}],
"type": "punctuation"
}],
"entities": [{
"content": "Bertrand",
"category": "PHI*-Personal*",
"startTime": 0.92,
"endTime": 1.2,
"confidence": 0.9989
}],
"audio_segments": [
{
"id": 0,
"transcript": "The patient's name is Bertrand.",
"start_time": "0.0",
"end_time": "0.9989",
"items": [
0,
1,
2,
3,
4,
5
]
}
]
},
"status": "COMPLETED"
}
```
## AWS CLI
**Pour transcrire un fichier audio et identifier les PHI à l’aide d’une tâche de transcription par lots (AWS CLI)**
+ Exécutez le code suivant.
```
aws transcribe start-medical-transcription-job \
--medical-transcription-job-name my-medical-transcription-job-name\
--language-code en-US \
--media MediaFileUri="s3://amzn-s3-demo-bucket/my-input-files/my-audio-file.flac" \
--output-bucket-name amzn-s3-demo-bucket \
--specialty PRIMARYCARE \
--type type \ # Choose CONVERSATION to transcribe a medical conversation. Choose DICTATION to transcribe a medical dictation.
--content-identification-type PHI
```
# Identification des PHI dans un flux en temps réel
Vous pouvez identifier les informations de santé personnelles (PHI) dans le HTTP/2 ou dans WebSocket les flux. Lorsque vous activez l'identification PHI, Amazon Transcribe Medical étiquette le PHI qu'il identifie dans les résultats de transcription. Pour plus d'informations sur le PHI que Amazon Transcribe Medical peut identifier, consultez[Identification des renseignements personnels sur la santé (PHI) dans une transcription](phi-id.md).
## Identification des PHI dans une dictée prononcée dans votre microphone
AWS Management Console Pour transcrire le discours capté par votre microphone et identifier un PHI, choisissez **Dictée** comme type d'entrée audio, lancez le flux et commencez à parler dans le microphone de votre ordinateur.
**Pour identifier le PHI dans une dictée à l'aide du AWS Management Console**
1. Connectez-vous à la [AWS Management Console](https://console.aws.amazon.com/transcribe/).
1. Dans le panneau de navigation, choisissez **Transcription en temps réel**.
1. Pour le **Type d’entrée audio**, choisissez **Dictée**.
1. Pour **Paramètres supplémentaires**, choisissez **Identification des PHI**.
1. Choisissez **Démarrer le streaming** et parlez dans le microphone.
1. Choisissez **Arrêter le streaming** pour mettre fin à la dictée.
## Identification des PHI dans un flux HTTP/2
Pour démarrer un flux HTTP/2 avec l’identification PHI activée, utilisez l’API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html) et spécifiez les éléments suivants :
+ Pour `LanguageCode`, spécifiez le code de langue pour la langue parlée dans le flux. Pour l’anglais américain, spécifiez `en-US`.
+ Pour `MediaSampleHertz`, spécifiez la fréquence d’échantillonnage de l’audio.
+ Pour `content-identification-type`, spécifiez `PHI`.
## Identifier le PHI dans un WebSocket flux
Pour démarrer un WebSocket flux avec l'identification PHI activée, utilisez le format suivant pour créer une URL présignée.
```
GET wss://transcribestreaming.us-west-2.amazonaws.com:8443/medical-stream-transcription-websocket?
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20220208%2Fus-west-2%2Ftranscribe%2Faws4_request
&X-Amz-Date=20220208T235959Z
&X-Amz-Expires=300
&X-Amz-Security-Token=security-token
&X-Amz-Signature=Signature Version 4 signature
&X-Amz-SignedHeaders=host
&language-code=en-US
&media-encoding=flac
&sample-rate=16000
&specialty=medical-specialty
&content-identification-type=PHI
```
Les définitions des paramètres se trouvent dans la [référence d'API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html) ; les paramètres communs à toutes les opérations d' AWS API sont répertoriés dans la section [Paramètres communs](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html).
# Génération de transcriptions alternatives
Lorsque vous utilisez Amazon Transcribe Medical, vous obtenez la transcription dont le niveau de confiance est le plus élevé. Cependant, vous pouvez configurer Amazon Transcribe Medical pour renvoyer des transcriptions supplémentaires avec des niveaux de confiance inférieurs.
Utilisez des transcriptions alternatives pour voir différentes interprétations de la transcription audio. Par exemple, dans une application qui permet à une personne de vérifier la transcription, vous pouvez présenter les transcriptions alternatives parmi lesquelles elle peut choisir.
Vous pouvez générer des transcriptions alternatives à l'aide de l'API AWS Management Console ou de l'[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html)API.
## AWS Management Console
Pour utiliser le AWS Management Console pour générer des transcriptions alternatives, vous devez activer des résultats alternatifs lorsque vous configurez votre tâche.
1. Connectez-vous à la [AWS Management Console](https://console.aws.amazon.com/transcribe/).
1. Dans le volet de navigation, sous Amazon Transcribe Medical, sélectionnez **Tâches de transcription**.
1. Choisissez **Créer une tâche**.
1. Sur la page **Spécifier les détails de la tâche**, fournissez des informations sur votre tâche de transcription.
1. Choisissez **Suivant**.
1. Activez **Autres résultats**.
1. Dans le champ **Nombre maximal d’autres résultats**, entrez une valeur entière comprise entre 2 et 10, pour le nombre maximal de transcriptions alternatives que vous souhaitez voir apparaître dans la sortie.
1. Choisissez **Créer**.
## API
**Pour séparer le texte par locuteur dans un fichier audio à l’aide d’une tâche de transcription par lots (API)**
+ Pour l’[API `StartMedicalTranscriptionJob`](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), spécifiez ce qui suit.
1. Pour `MedicalTranscriptionJobName`, spécifiez un nom unique dans votre Compte AWS.
1. Pour `LanguageCode`, spécifiez le code de langue correspondant à la langue parlée dans votre fichier multimédia et à la langue de votre filtre de vocabulaire.
1. Dans le paramètre `MediaFileUri` de l’objet `Media`, spécifiez l’emplacement du fichier audio à transcrire.
1. Pour `Specialty`, spécifiez la spécialité médicale du médecin qui parle dans le fichier audio.
1. Pour `Type`, indiquez si vous transcrivez une conversation médicale ou une dictée.
1. Pour `OutputBucketName`, spécifiez le compartiment Amazon S3 dans lequel stocker les résultats de transcription.
1. Pour l’objet `Settings`, spécifiez ce qui suit :
1. `ShowAlternatives` – `true`.
1. `MaxAlternatives` - Entier compris entre 2 et 10 qui indique le nombre de transcriptions alternatives que vous souhaitez voir apparaître dans la sortie de transcription.
La requête suivante utilise le AWS SDK pour Python (Boto3) pour démarrer une tâche de transcription qui génère jusqu'à deux transcriptions alternatives.
```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
job_name = "my-first-transcription-job"
job_uri = s3://amzn-s3-demo-bucket/my-input-files/my-audio-file.flac
transcribe.start_medical_transcription_job(
MedicalTranscriptionJobName = job_name,
Media = {
'MediaFileUri': job_uri
},
OutputBucketName = 'amzn-s3-demo-bucket',
OutputKey = 'my-output-files/',
LanguageCode = 'en-US',
Specialty = 'PRIMARYCARE',
Type = 'CONVERSATION',
Settings = {
'ShowAlternatives': True,
'MaxAlternatives': 2
}
)
while True:
status = transcribe.get_medical_transcription_job(MedicalTranscriptionJobName = job_name)
if status['MedicalTranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']:
break
print("Not ready yet...")
time.sleep(5)
print(status)
```
## AWS CLI
**Pour transcrire un fichier audio d’une conversation entre un médecin de soins primaires et un patient dans un fichier audio (AWS CLI)**
+ Exécutez le code suivant.
```
aws transcribe start-transcription-job \
--cli-input-json file://filepath/example-start-command.json
```
Le code suivant affiche le contenu du fichier `example-start-command.json`.
```
{
"MedicalTranscriptionJobName": "my-first-transcription-job",
"LanguageCode": "en-US",
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION",
"OutputBucketName":"amzn-s3-demo-bucket",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-audio-file.flac"
},
"Settings":{
"ShowAlternatives": true,
"MaxAlternatives": 2
}
}
```
# Amazon Transcribe Points de terminaison VPC médicaux et d'interface ()AWS PrivateLink
Vous pouvez établir une connexion privée entre votre VPC et Amazon Transcribe Medical en créant un point de terminaison *VPC d'interface.* Les points de terminaison de l'interface sont alimentés par [AWS PrivateLink](https://aws.amazon.com/privatelink)une technologie qui vous permet d'accéder à Amazon Transcribe Medical en privé APIs sans passerelle Internet, appareil NAT, connexion VPN ou Direct Connect connexion. Les instances de votre VPC n'ont pas besoin d'adresses IP publiques pour communiquer avec Amazon Transcribe Medical. APIs Le trafic entre votre VPC et Amazon Transcribe Medical ne quitte pas le réseau Amazon.
Chaque point de terminaison d’interface est représenté par une ou plusieurs [interfaces réseau Elastic](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html) dans vos sous-réseaux.
Pour de plus amples informations, consultez [Points de terminaison VPC (AWS PrivateLink)](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html) dans le *Guide de l’utilisateur Amazon VPC *.
## Considérations relatives aux Amazon Transcribe terminaux VPC médicaux
Avant de configurer un point de terminaison VPC d'interface pour le secteur Amazon Transcribe médical, assurez-vous de consulter les [propriétés et les limites du point de terminaison d'interface](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#vpce-interface-limitations) dans le guide de l'*Amazon VPC utilisateur*.
Amazon Transcribe Medical prend en charge les appels vers toutes ses actions d'API depuis votre VPC.
## Création d'un point de terminaison VPC d'interface pour le secteur médical Amazon Transcribe
Vous pouvez créer un point de terminaison VPC pour le service Amazon Transcribe médical à l'aide du AWS Management Console ou du. AWS CLI Pour de plus amples informations, veuillez consulter [Création d’un point de terminaison d’interface](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#create-interface-endpoint) dans le *Guide de l’utilisateur Amazon VPC *.
Pour la transcription par lots dans Amazon Transcribe Medical, créez un point de terminaison VPC en utilisant le nom de service suivant :
+ com.amazonaws. *us-west-2*.transcrire
Pour la transcription en continu dans Amazon Transcribe Medical, créez un point de terminaison VPC en utilisant le nom de service suivant :
+ com.amazonaws. *us-west-2*. transcrire le streaming
Si vous activez le DNS privé pour le point de terminaison, vous pouvez envoyer des demandes d'API à Amazon Transcribe Medical en utilisant son nom DNS par défaut pour Région AWS, par exemple,`transcribestreaming.us-east-2.amazonaws.com`.
Pour plus d’informations, consultez la section [Accès à un service via un point de terminaison d’interface](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#access-service-though-endpoint) dans le *Guide de l’utilisateur Amazon VPC *.
## Création d'une politique de point de terminaison VPC pour Amazon Transcribe le streaming médical
Vous pouvez associer une politique de point de terminaison à votre point de terminaison VPC qui contrôle l'accès à Amazon Transcribe Medical. La politique spécifie les informations suivantes :
+ Le principal qui peut exécuter des actions.
+ Les actions qui peuvent être effectuées.
+ Les ressources sur lesquelles les actions peuvent être exécutées.
Pour plus d’informations, consultez [Contrôle de l’accès aux services avec points de terminaison d’un VPC](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-endpoints-access.html) dans le *Guide de l’utilisateur Amazon VPC*.
**Exemple : politique de point de terminaison VPC pour les actions de transcription en streaming Amazon Transcribe médical**
Voici un exemple de politique de point de terminaison pour la transcription en streaming dans Amazon Transcribe Medical. Lorsqu'elle est attachée à un point de terminaison, cette politique donne accès aux actions Amazon Transcribe médicales répertoriées à tous les principaux sur toutes les ressources.
```
{
"Statement":[
{
"Principal":"*",
"Effect":"Allow",
"Action":[
"transcribe:StartMedicalStreamTranscription",
],
"Resource":"*"
}
]
}
```
**Exemple : politique de point de terminaison VPC pour les actions de transcription Amazon Transcribe médicale par lots**
Voici un exemple de politique de point de terminaison pour la transcription par lots dans Amazon Transcribe Medical. Lorsqu'elle est attachée à un point de terminaison, cette politique donne accès aux actions Amazon Transcribe médicales répertoriées à tous les principaux sur toutes les ressources.
```
{
"Statement":[
{
"Principal":"*",
"Effect":"Allow",
"Action":[
"transcribe:StartMedicalTranscriptionJob"
],
"Resource":"*"
}
]
}
```
## Sous-réseaux partagés
Vous ne pouvez pas créer, décrire, modifier ou supprimer de points de terminaison de VPC dans des sous-réseaux qui sont partagés avec vous. Toutefois, vous pouvez utiliser les points de terminaison d’un VPC dans les sous-réseaux qui sont partagés avec vous. Pour plus d'informations sur le partage de VPC, consultez la section [Partager votre VPC avec d'autres comptes](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-sharing.html#vpc-sharing-service-behavior) dans le guide. Amazon Virtual Private Cloud