

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.

# Transcription d’une dictée médicale
<a name="transcribe-medical-dictation"></a>

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
<a name="batch-medical-dictation"></a>

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
<a name="batch-med-dictation-console"></a>

**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
<a name="batch-med-dictation-api"></a>

**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
<a name="batch-med-dictation-cli"></a>

**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
<a name="streaming-medical-dictation"></a>

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
<a name="streaming-medical-dictation-console"></a>

 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
<a name="http2-med-dictation-streaming"></a>

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
<a name="transcribe-medical-dictation-websocket"></a>

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).