Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Amazon Transcribe Medical
Amazon Transcribe Medical es un servicio de reconocimiento automático de voz (ASR) diseñado para profesionales médicos que desean transcribir palabras relacionadas con la medicina, como notas dictadas por el médico, controles de seguridad de los medicamentos, citas de telemedicina o conversaciones entre el médico y el paciente. Amazon Transcribe Medical está disponible mediante transmisión en tiempo real (a través del micrófono) o mediante la transcripción de un archivo cargado (por lotes).
**importante**
Amazon Transcribe Medical no sustituye el asesoramiento, el diagnóstico o el tratamiento médico profesional. Identifique el umbral de confianza adecuado para su caso de uso y utilice umbrales de confianza elevados en situaciones que requieran una alta precisión. En ciertos casos de uso, los resultados deberán ser revisados y verificados por revisores humanos debidamente preparados. Amazon Transcribe Todas las transcripciones de Medical sólo deben utilizarse en escenarios de atención al paciente después de que un profesional médico debidamente formado haya revisado la exactitud y aplicado su buen juicio médico.
Amazon Transcribe Medical funciona bajo un modelo de responsabilidad compartida, según el cual AWS es responsable de proteger la infraestructura en la que se ejecuta Amazon Transcribe Medical y usted es responsable de administrar sus datos. Para obtener más información, consulte el [Modelo de responsabilidad compartida](https://aws.amazon.com/compliance/shared-responsibility-model/).
Amazon Transcribe Medical está disponible en inglés estadounidense (en-US).
Para obtener resultados óptimos, utilice un formato de audio sin pérdida como FLAC o WAV con codificación PCM de 16 bits. Amazon Transcribe Medical admite frecuencias de muestreo de 16 000 Hz o superiores.
Para el análisis de sus transcripciones, puede utilizar otras Servicios de AWS, como. [Amazon Comprehend Medical](https://docs.aws.amazon.com/comprehend/latest/dg/comprehend-medical.html).
**Especialidades admitidas**
| Especialidad | Subespecialidad | Entrada de audio |
| --- | --- | --- |
| Cardiología | none | sólo en streaming |
| Neurología | none | sólo en streaming |
| Oncología | none | sólo en streaming |
| Atención primaria | Medicina familiar | batch, streaming |
| Atención primaria | Medicina interna | batch, streaming |
| Atención primaria | Obstetricia y ginecología (OB-GYN) | batch, streaming |
| Atención primaria | Pediatría | batch, streaming |
| Radiología | none | sólo en streaming |
| Urología | none | sólo en streaming |
## Disponibilidad y cuotas por región
Call Analytics es compatible con las siguientes Regiones de AWS:
| **Región** | **Tipo de transcripción** |
| --- | --- |
| af-south-1 (Ciudad del Cabo) | batch |
| ap-east-1 (Hong Kong) | batch |
| ap-northeast-1 (Tokio) | batch, streaming |
| ap-northeast-2 (Seúl) | batch, streaming |
| ap-south-1 (Bombay) | batch |
| ap-southeast-1 (Singapur) | batch |
| ap-southeast-2 (Sídney) | batch, streaming |
| ca-central-1: Canadá (centro) | batch, streaming |
| eu-central-1 (Fráncfort) | batch, streaming |
| eu-north-1 (Estocolmo) | batch |
| eu-west-1 (Irlanda) | batch, streaming |
| eu-west-2 (Londres) | batch, streaming |
| eu-west-3 (París) | batch |
| me-south-1 (Baréin) | batch |
| sa-east-1 (São Paulo) | batch, streaming |
| us-east-1 (Norte de Virginia) | batch, streaming |
| us-east-2 (Ohio) | batch, streaming |
| us-gov-east-1 (GovCloud, Este de EE. UU.) | batch, streaming |
| us-gov-west-1, GovCloud (Oeste de EE. UU.) | batch, streaming |
| us-west-1 (San Francisco) | batch |
| us-west-2 (Oregón) | batch, streaming |
Tenga en cuenta que el soporte regional es diferente para [Amazon Transcribe](what-is.md#tsc-regions), Amazon Transcribe Medical y [Call Analytics.](call-analytics.md#tca-regions).
Para conocer los puntos de conexión para cada Región admitida, consulte los [Puntos de conexión](https://docs.aws.amazon.com/general/latest/gr/transcribe.html#transcribe_region) en la *Referencia general de AWS*.
Para obtener una lista de las cuotas correspondientes a sus transcripciones, consulte [Service quotas](https://docs.aws.amazon.com/general/latest/gr/transcribe.html#limits-amazon-transcribe) en la *Referencia general de AWS*. Algunas cuotas se pueden cambiar a petición. Si la columna **Ajustable** contiene la palabra “**Sí**”, puede solicitar un aumento. Para ello, seleccione el enlace proporcionado.
# Especialidades y términos médicos
Al crear un trabajo de transcripción médica, especifique el idioma, la especialidad médica y el tipo de audio del archivo de origen. Para el idioma debe especificar inglés estadounidense (en-US) y para la especialidad médica, `PRIMARYCARE`. Especificar "atención primaria" como valor le permite generar transcripciones a partir de audio de origen en las siguientes especialidades médicas:
+ Medicina familiar
+ Medicina interna
+ Obstetricia y ginecología (OB-GYN)
+ Pediatría
Puede elegir entre dictado y conversación para su tipo de audio. Elija dictado para archivos de audio en los que el médico está dando un informe sobre una visita o procedimiento del paciente. Elija conversación para archivos de audio que contengan una conversación entre un médico y un paciente o una conversación entre médicos.
Para almacenar el resultado de su trabajo de transcripción, seleccione un Amazon S3 depósito que ya haya creado. Para obtener más información sobre los Amazon S3 cubos, consulta [Cómo empezar con Amazon Simple Storage Service](https://docs.aws.amazon.com/AmazonS3/latest/gsg/GetStartedWithS3.html).
Puede consultar el número mínimo de parámetros de solicitud que debe especificar en el JSON de ejemplo que se incluye aquí.
```
{
"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 le permite generar transcripciones alternativas. Para obtener más información, consulte [Generar transcripciones alternativas](alternative-med-transcriptions.md).
También puede activar la partición de los altavoces o identificar los canales del audio. Para obtener más información, consulte [Habilitar la partición de voces](conversation-diarization-med.md) y [Transcripción de audio multicanal](conversation-channel-id-med.md).
# Transcripción de mediciones y términos médicos
Amazon Transcribe Medical puede transcribir términos y medidas médicas. Amazon Transcribe Productos médicos: abreviaturas para términos hablados. Por ejemplo, "blood pressure" (presión arterial) se transcribe como BP. Puede encontrar una lista de las convenciones que la Amazon Transcribe medicina utiliza para los términos y medidas médicos en la tabla de esta página. La columna *Spoken Term (Término hablado)* hace referencia al término hablado en el audio de origen. La columna *Output (Salida)* hace referencia a la abreviatura que aparece en los resultados de la transcripción.
Aquí puede ver cómo los términos hablados en el audio de origen corresponden a la salida de la transcripción.
| Término hablado en el audio de origen | Abreviatura utilizada en el resultado | Ejemplo de resultado de |
| --- | --- | --- |
| Centigrade | C | La temperatura del paciente es de 37,4 °C. |
| Celsius | C | La temperatura del paciente es de 37,4 °C. |
| Fahrenheit | F | La temperatura del paciente es de 101 °F. |
| grams | g | Se extrajo una masa de 100 g del paciente. |
| meters | m | El paciente mide 1,8 m de altura. |
| feet | ft | El paciente mide 6 ft de altura. |
| kilos | kg | El paciente pesa 80 kg. |
| kilograms | kg | El paciente pesa 80 kg. |
| c c | cc | El paciente recibió 100 cc de solución salina. |
| cubic centimeter | cc | El paciente recibió 100 cc de solución salina. |
| milliliter | mL | El paciente excretó 100 mL de orina. |
| blood pressure | BP | La BP del paciente era alta. |
| b p | BP | La BP del paciente era alta. |
| X over Y | X/Y | La presión arterial del paciente fue de 120/80. |
| beats per min | BPM | Paciente con fibrilación auricular con frecuencia cardíaca de 160 BPM. |
| beats per minute | BPM | Paciente con fibrilación auricular con frecuencia cardíaca de 160 BPM. |
| O 2 | O2 | La saturación de O2 del paciente era del 98 %. |
| CO2 | CO2 | El paciente necesitó soporte respiratorio para elevarse CO2. |
| post operation | POSTOP | El paciente vino para la evaluación POSTOP. |
| post op | POSTOP | El paciente vino para la evaluación POSTOP. |
| cat scan | CT Scan | La indicación del paciente de hemorragia cerebral requirió el uso de CT Scan. |
| Pulse 80 | P 80 | Los signos vitales del paciente fueron P 80, R 17, etc. |
| Respiration 17 | R 17 | Los signos vitales del paciente fueron P 80, R 17, etc. |
| in and out | E/S | El paciente tenía I/O ritmo sinusal |
| L five | L5 | Se realizó punción lumbar entre L4 y L5 |
# Transcripción de números
Amazon Transcribe El médico transcribe los dígitos como números en lugar de palabras. Por ejemplo, el número hablado "one thousand two hundred forty two" (mil doscientos cuarenta y dos) se transcribe como `1242`.
Los números se transcriben de acuerdo con las reglas siguientes.
| Regla | Description (Descripción) |
| --- | --- |
| Convertir números cardinales mayores de 10 en números. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/how-numbers-med.html) |
| Convertir números cardinales seguidos de "million" o "billion" en números seguidos de una palabra cuando "million" o "billion" no vaya seguido de un número. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/how-numbers-med.html) |
| Convertir números ordinales mayores de 10 en números. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/how-numbers-med.html) |
| Convertir fracciones a su formato numérico. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/how-numbers-med.html) |
| Convertir números menores de 10 en dígitos si hay varios números consecutivos. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/how-numbers-med.html) |
| Los decimales se indican mediante "dot" o "point". | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/how-numbers-med.html) |
| Convertir la palabra "percent" después de un número en el signo de porcentaje (%). | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/how-numbers-med.html) |
| Convertir las palabras "dollar", "US dollar", "Australian dollar", "AUD" o "USD" detrás de un número en un símbolo de dólar (\$1) delante del número. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/how-numbers-med.html) |
| Convertir las palabras "pounds" o "milligrams" en "lbs" o "mg". | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/how-numbers-med.html) |
| Convertir las palabras "rupees", "Indian rupees" o "INR" detrás de un número a un símbolo de rupia (₹) delante del número. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/how-numbers-med.html) |
| Convertir horas en números. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/how-numbers-med.html) |
| Combinar años expresados como dos dígitos en cuatro. Solo válido para los siglos XX, XXI y XXII. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/how-numbers-med.html) |
| Convertir fechas en números. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/how-numbers-med.html) |
| Separar intervalos de números por la palabra "to". | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/transcribe/latest/dg/how-numbers-med.html) |
# Transcripción de una conversación médica
Puede usar Amazon Transcribe Medical para transcribir una conversación médica entre un médico y un paciente mediante un trabajo de transcripción por lotes o una transmisión en tiempo real. Los trabajos de transcripción por lotes le permiten transcribir archivos de audio. Para garantizar que Amazon Transcribe Medical produzca los resultados de la transcripción con la mayor precisión posible, debe especificar la especialidad médica del médico en su trabajo o transmisión de transcripción.
Puede transcribir una visita entre un médico y un paciente en las siguientes especialidades médicas:
+ Cardiología: sólo disponible en streaming con transcripción
+ Cardiología: sólo disponible en transcripción de streaming
+ Cardiología: sólo disponible en transcripción de streaming
+ Atención primaria: incluye los siguientes tipos de práctica médica:
+ Medicina familiar
+ Medicina interna
+ Obstetricia y ginecología (OB-GYN)
+ Pediatría
+ Urología: sólo disponible en streaming con transcripción
Puede mejorar la precisión de la transcripción mediante el uso de vocabularios médicos personalizados. Para obtener información sobre cómo funcionan los vocabularios médicos personalizados, consulte [Mejora de la precisión de la transcripción con vocabularios médicos personalizados](vocabulary-med.md).
De forma predeterminada, Amazon Transcribe Medical devuelve la transcripción con el nivel de confianza más alto. Si desea configurarlo para que devuelva transcripciones alternativas, consulte. [Generar transcripciones alternativas](alternative-med-transcriptions.md)
Para obtener información sobre cómo aparecen los números y las medidas médicas en el resultado de la transcripción, consulte [Transcripción de números](how-numbers-med.md) y [Transcripción de mediciones y términos médicos](how-measurements-med.md).
**Topics**
+ [Transcripción de un archivo de audio de una conversación médica](batch-medical-conversation.md)
+ [Transcribir una conversación médica en una secuencia en tiempo real](streaming-medical-conversation.md)
+ [Habilitar la partición de voces](conversation-diarization-med.md)
+ [Transcripción de audio multicanal](conversation-channel-id-med.md)
# Transcripción de un archivo de audio de una conversación médica
Utilice un trabajo de transcripción por lotes para transcribir archivos de audio de conversaciones médicas. Puede usarlo para transcribir un diálogo entre el médico y el paciente. Puede iniciar un trabajo de transcripción por lotes en la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html) o en Consola de administración de AWS.
Al iniciar un trabajo de transcripción médica con la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), debe especificar `PRIMARYCARE` como valor del parámetro `Specialty`.
## Consola de administración de AWS
**Para transcribir un diálogo entre el médico y el paciente (Consola de administración de AWS)**
**Para usar el para Consola de administración de AWS transcribir un diálogo entre el médico y el paciente, cree un trabajo de transcripción y seleccione **Conversación** como tipo de entrada de audio.**
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/transcribe/).
1. **En el panel de navegación, en Amazon Transcribe Medicina, selecciona Trabajos de transcripción.**
1. Seleccione **Crear trabajo**.
1. En la página **Especificar detalles del trabajo**, en **Configuración del trabajo**, especifique lo siguiente.
1. **Nombre**: el nombre del trabajo de transcripción.
1. **Tipo de entrada de audio**: **conversación**
1. Para el resto de los campos, especifique la Amazon S3 ubicación del archivo de audio y dónde desea almacenar el resultado del trabajo de transcripción.
1. Elija **Next (Siguiente)**.
1. Seleccione **Crear**.
## API
**Para transcribir una conversación médica mediante un trabajo de transcripción por lotes (API)**
+ En la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), especifique lo siguiente.
1. Para `MedicalTranscriptionJobName`, especifique un nombre único en su Cuenta de AWS.
1. En `LanguageCode`, especifique el código de idioma correspondiente al idioma hablado en el archivo multimedia y el idioma del filtro de vocabulario.
1. En el parámetro `MediaFileUri` del objeto `Media`, especifique el nombre del archivo multimedia que desea transcribir.
1. Para `Specialty`, especifique la especialidad médica del profesional que habla en el archivo de audio como`PRIMARYCARE`.
1. En `Type`, especifique `CONVERSATION`.
1. Para `OutputBucketName`, especifique el bucket de Amazon S3 en el que se almacenarán los resultados de la transcripción.
El siguiente es un ejemplo de solicitud que utiliza la AWS SDK para Python (Boto3) para transcribir una conversación médica entre un médico de la `PRIMARYCARE` especialidad y un paciente.
```
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)
```
El siguiente código de ejemplo muestra los resultados de la transcripción de una conversación entre el médico y el paciente.
```
{
"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
**Para transcribir una conversación médica mediante un trabajo de transcripción por lotes (AWS CLI)**
+ Ejecute el siguiente código.
```
aws transcribe start-medical-transcription-job \
--region us-west-2 \
--cli-input-json file://example-start-command.json
```
El texto siguiente muestra el contenido de `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"
}
```
# Transcribir una conversación médica en una secuencia en tiempo real
Puede transcribir la transmisión de audio de una conversación médica mediante el HTTP/2 o los protocolos. [WebSocket ](https://tools.ietf.org/html/rfc6455) Para obtener información sobre cómo iniciar una transmisión mediante el WebSocket protocolo, consulte. [Configurar una WebSocket transmisión](streaming-setting-up.md#streaming-websocket) Para iniciar una transmisión HTTP/2, utilice la 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).
Puede transcribir la transmisión de audio en los siguientes idiomas:
+ Cardiología
+ Neurología
+ Oncología
+ Atención primaria
+ Urología
Cada especialidad médica incluye muchos tipos de procedimientos y consultas. Por lo tanto, los médicos dictan muchos tipos diferentes de notas. Usa los siguientes ejemplos como guía para ayudarte a especificar el valor del parámetro `specialty` URI de la WebSocket solicitud o el `Specialty` parámetro de la [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:
+ Para consultas de electrofisiología o ecocardiografía, elija `CARDIOLOGY`.
+ Para consultas de oncología médica, oncología quirúrgica u oncología radioterápica, elija `ONCOLOGY`.
+ Para un médico que pasa consulta a un paciente que ha sufrido un accidente cerebrovascular, ya sea un ataque isquémico transitorio o un ataque cerebrovascular, elija `NEUROLOGY`.
+ Para una consulta sobre la incontinencia urinaria, elija `UROLOGY`.
+ Para chequeos anuales o visitas de atención de urgencia, elija `PRIMARYCARE`.
+ Para visitas hospitalarias de pacientes hospitalizados, elija `PRIMARYCARE`.
+ Para consultas relacionadas con la fertilidad, la ligadura de trompas, la inserción de un DIU o el aborto, elija `PRIMARYCARE`.
## Consola de administración de AWS
**Para transcribir una conversación médica en streaming (Consola de administración de AWS)**
Para usar la transmisión Consola de administración de AWS para transcribir un diálogo entre el médico y el paciente en tiempo real, elija la opción de transcribir una conversación médica, inicie la transmisión y comience a hablar por el micrófono.
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/transcribe/).
1. **En el panel de navegación, en Amazon Transcribe Medicina, selecciona Transcripción en tiempo real.**
1. Elija **Conversación**.
1. Para **Especialidad médica**, elija la especialidad del médico.
1. Elija **Comenzar streaming**.
1. Hable al micrófono.
## Transcribir una conversación médica en una secuencia HTTP/2
A continuación se proporciona la sintaxis de los parámetros de una solicitud HTTP/2.
Para transcribir una secuencia HTTP/2 de una conversación médica, utilice la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html) y especifique lo siguiente:
+ `LanguageCode`: código de idioma. El valor válido es `en-US`
+ `MediaEncoding`: codificación utilizada para el audio de entrada. Los valores válidos son `pcm`, `ogg-opus` y `flac`.
+ `Specialty`: especialidad del profesional médico.
+ `Type` – `CONVERSATION`
Para mejorar la precisión de la transcripción de términos específicos en una secuencia en tiempo real, utilice un vocabulario personalizado. Para habilitar un vocabulario personalizado, establezca el valor del parámetro `VocabularyName` en el nombre del vocabulario personalizado que desee usar. Para obtener más información, consulte [Mejora de la precisión de la transcripción con vocabularios médicos personalizados](vocabulary-med.md).
Para etiquetar la voz de distintos hablantes, defina el parámetro `ShowSpeakerLabel` en `true`. Para obtener más información, consulte [Habilitar la partición de voces](conversation-diarization-med.md).
Para obtener más información sobre cómo configurar una secuencia HTTP/2 para transcribir una conversación médica, consulte [Configuración de una secuencia HTTP/2](streaming-setting-up.md#streaming-http2).
## Transcribir una conversación médica en una transmisión WebSocket
Puede utilizar una WebSocket solicitud para transcribir una conversación médica. Cuando realizas una WebSocket solicitud, creas un URI prefirmado. Este URI contiene la información necesaria para configurar la secuencia de audio entre su aplicación y Amazon Transcribe Medical. Para obtener más información sobre la creación de WebSocket solicitudes, consulte[Configurar una WebSocket transmisión](streaming-setting-up.md#streaming-websocket).
Use la siguiente plantilla para crear el URI prefirmado.
```
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
```
Para mejorar la precisión de la transcripción de términos específicos en una secuencia en tiempo real, utilice un vocabulario personalizado. Para habilitar un vocabulario personalizado, establezca el valor de `vocabulary-name` en el nombre del vocabulario personalizado que desee usar. Para obtener más información, consulte [Mejora de la precisión de la transcripción con vocabularios médicos personalizados](vocabulary-med.md).
Para etiquetar el discurso de distintas voces, defina el parámetro `show-speaker-label` en `true`. Para obtener más información, consulte [Habilitar la partición de voces](conversation-diarization-med.md).
Para obtener más información sobre la creación de prefirmados URIs, consulte[Configurar una WebSocket transmisión](streaming-setting-up.md#streaming-websocket).
# Habilitar la partición de voces
*Para habilitar la partición de los altavoces en la versión Amazon Transcribe médica, utilice la diarización de los altavoces.* Esto permite ver lo que dijo el paciente y lo que dijo el médico en el resultado de la transcripción.
Al activar la diarización de los altavoces, Amazon Transcribe Medical etiqueta cada *enunciado* del altavoz con un identificador único para cada altavoz. Un *enunciado* es una unidad de voz en el canal de audio que normalmente está separado de otros enunciados por un silencio. En la transcripción por lotes, un enunciado del médico podría recibir una etiqueta `spk_0` y un enunciado con el que el paciente podría recibir una etiqueta `spk_1`.
Si un enunciado de un hablante se superpone con un enunciado de otro hablante, Amazon Transcribe Medical lo ordenará en la transcripción antes de la hora de inicio. Los enunciados que se solapan en el audio de entrada no se solapan en la salida de la transcripción.
Puede activar la diarización de las voces al transcribir un archivo de audio mediante un trabajo de transcripción por lotes o en una secuencia en tiempo real.
**Topics**
+ [Habilitar la partición de las voces en las transcripciones por lotes](conversation-diarization-batch-med.md)
+ [Habilitar la partición de los hablantes en secuencias en tiempo real](conversation-diarization-streaming-med.md)
# Habilitar la partición de las voces en las transcripciones por lotes
Puede habilitar la partición de las voces en un trabajo de transcripción por lotes mediante la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html) o Consola de administración de AWS. Esto le permite dividir el texto por voz en una conversación entre el médico y el paciente y determinar quién dijo qué en el resultado de la transcripción.
## Consola de administración de AWS
Para utilizar la Consola de administración de AWS diarización de los altavoces en su trabajo de transcripción, active la identificación del audio y, a continuación, la partición de los altavoces.
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/transcribe/).
1. **En el panel de navegación, en Amazon Transcribe Medicina, selecciona Trabajos de transcripción.**
1. Seleccione **Crear trabajo**.
1. En la página **Especificar detalles del trabajo**, proporcione información sobre su trabajo de transcripción.
1. Elija **Siguiente**.
1. Habilite **Identificación por audio**.
1. En **Tipo de identificación de audio**, seleccione **Partición de voces**.
1. En **Número máximo de voces**, introduzca el número máximo de voces que cree que están hablando en el archivo de audio.
1. Seleccione **Crear**.
## API
**Para habilitar la partición de las voces en un trabajo de transcripción por lotes (API)**
+ Para la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), especifique lo siguiente.
1. Para`MedicalTranscriptionJobName`, especifique un nombre que sea único en su Cuenta de AWS.
1. Para `LanguageCode`, especifique el código de idioma que corresponda al idioma hablado en el archivo de audio.
1. En el parámetro `MediaFileUri` del objeto `Media`, especifique el nombre del archivo multimedia que desea transcribir.
1. Para `Specialty`, especifique la especialidad médica del profesional que habla en el archivo de audio.
1. En `Type`, especifique `CONVERSATION`.
1. Para`OutputBucketName`, especifique el Amazon S3 depósito en el que almacenar los resultados de la transcripción.
1. En el objeto `Settings`, especifique lo siguiente.
1. `ShowSpeakerLabels` – `true`.
1. `MaxSpeakerLabels`: número entero entre 2 y 10 para indicar el número de voces que cree que están hablando en el audio.
La siguiente solicitud utiliza el AWS SDK para Python (Boto3) para iniciar un trabajo de transcripción por lotes de un diálogo entre un paciente y un médico de atención primaria con la partición de altavoces habilitada.
```
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)
```
El siguiente código de ejemplo muestra los resultados de la transcripción de un trabajo de transcripción con la partición de las voces habilitada.
```
{
"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
**Para transcribir un archivo de audio de una conversación entre un médico de atención primaria y un paciente (AWS CLI)**
+ Ejecute el siguiente código.
```
aws transcribe start-transcription-job \
--region us-west-2 \
--cli-input-json file://example-start-command.json
```
El texto siguiente muestra el contenido de `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
}
}
```
# Habilitar la partición de los hablantes en secuencias en tiempo real
Para dividir los altavoces y etiquetar su discurso en una transmisión en tiempo real, utilice la Consola de administración de AWS o una solicitud de transmisión. La partición de las voces funciona mejor con entre dos y cinco hablantes en una transmisión. Aunque Amazon Transcribe Medical puede dividir más de cinco altavoces en una transmisión, la precisión de las particiones disminuye si se supera ese número.
Para iniciar una solicitud HTTP/2, utilice la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html). Para iniciar una WebSocket solicitud, utilice un URI prefirmado. El URI contiene la información necesaria para configurar la comunicación bidireccional entre la aplicación y Amazon Transcribe Medical.
## Habilitar la partición de las voces en el audio que se escucha en el micrófono (Consola de administración de AWS)
Puedes usar el Consola de administración de AWS para iniciar una transmisión en tiempo real de una conversación entre el médico y el paciente, o un dictado que se escucha en el micrófono en tiempo real.
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/transcribe/).
1. **En el panel de navegación, en Amazon Transcribe Medicina, selecciona Transcripción en tiempo real.**
1. En **Tipo de entrada de audio**, elija el tipo de discurso médico que desee transcribir.
1. En **Ajustes adicionales**, seleccion **Partición de las voces**.
1. Elija **Comenzar streaming** para empezar a transcribir su audio en tiempo real.
1. Hable al micrófono.
## Habilitar la partición de las voces en una secuencia HTTP/2
Para habilitar la partición de las voces en una secuencia HTTP/2 de una conversación médica, utilice la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html) y especifique lo siguiente:
+ Para `LanguageCode`, especifique el código de idioma que corresponda al idioma hablado en la secuencia. El valor válido es `en-US`.
+ Para `MediaSampleHertz`, especifique la frecuencia de muestreo del audio.
+ Para`Specialty`, especifique la especialidad médica del proveedor.
+ `ShowSpeakerLabel` – `true`
Para obtener más información sobre cómo configurar una secuencia HTTP/2 para transcribir una conversación médica, consulte [Configuración de una secuencia HTTP/2](streaming-setting-up.md#streaming-http2).
## Habilitar la partición de los altavoces en una solicitud WebSocket
Para particionar los altavoces en las WebSocket transmisiones con la API, usa el siguiente formato para crear un URI prefirmado para iniciar una WebSocket solicitud y `show-speaker-label` configurarlo. `true`
```
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
```
El siguiente código muestra el ejemplo truncado de la respuesta de una solicitud 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 divide la transmisión de audio entrante en función de los segmentos naturales de la voz, como un cambio de altavoz o una pausa en el audio. La transcripción se devuelve progresivamente a la aplicación, y cada respuesta contiene más discurso transcrito hasta que se transcribe el segmento completo. El código anterior es un ejemplo truncado de un segmento de voz completamente transcrito. Las etiquetas de las voces sólo aparecen en los segmentos totalmente transcritos.
La siguiente lista muestra la organización de los objetos y parámetros en un resultado de una transcripción en streaming.
**`Transcript`**
Cada segmento de voz tiene su propio objeto `Transcript`.
**`Results`**
Cada objeto `Transcript` tiene su propio objeto `Results`. Este objeto contiene el subcampo `isPartial`. Si su valor es `false`, los resultados devueltos son para un segmento de voz completo.
**`Alternatives`**
Cada objeto `Results` tiene un objeto `Alternatives`.
**`Items`**
Cada objeto `Alternatives` tiene su propio objeto `Items` que contiene información sobre cada palabra y signo de puntuación del resultado de la transcripción. Al activar la partición de los altavoces, cada palabra tiene una `Speaker` etiqueta para los segmentos del discurso completamente transcritos. Amazon Transcribe Medical utiliza esta etiqueta para asignar un número entero único a cada altavoz de la transmisión. El parámetro `Type` que tiene un valor de `speaker-change` indica que una persona ha dejado de hablar y que otra está a punto de empezar.
**`Transcript`**
Cada objeto de Items contiene un segmento de voz transcrito como valor del campo `Transcript`.
Para obtener más información sobre WebSocket las solicitudes, consulte[Configurar una WebSocket transmisión](streaming-setting-up.md#streaming-websocket).
# Transcripción de audio multicanal
Si tiene un archivo o una transmisión de audio que tiene varios canales, puede usar la *identificación del canal* para transcribir la voz de cada uno de esos canales. Amazon Transcribe Medical transcribe el discurso de cada canal por separado. Combina las transcripciones independientes de cada canal en una única salida de transcripción.
Utilice la identificación de canales para identificar los distintos canales del audio y transcriba la voz de cada uno de esos canales. Habilite esto en situaciones como la de una persona que llama o un agente. Úselo para distinguir a la persona que llama de un agente en las grabaciones o secuencias de los centros de contacto que realizan la supervisión de la seguridad de los medicamentos.
Puede habilitar la identificación de canales tanto para el procesamiento por lotes como para la transmisión en tiempo real. La siguiente lista describe cómo habilitarla para cada método.
+ Transcripción por lotes Consola de administración de AWS y [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html)API
+ Transcripción en WebSocket streaming: streaming y [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
## Transcripción de archivos de audio multicanal
Al transcribir un archivo de audio, Amazon Transcribe Medical devuelve una lista de *elementos* para cada canal. Un elemento es una palabra o un signo de puntuación transcritos. Cada palabra tiene una hora de inicio y una hora de finalización. Si una persona de un canal habla por encima de otra persona de otro canal, las horas de inicio y finalización de los elementos de cada canal se superponen mientras unas personas hablan por encima de las otras.
De forma predeterminada, puede transcribir archivos de audio con dos canales. Puede solicitar un aumento de cuota si necesita transcribir archivos que tengan más de dos canales. Para obtener más información acerca de cómo solicitar un aumento de cuota, consulte [cuotas de Servicio de AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html).
Para transcribir audio multicanal en un trabajo de transcripción por lotes, utilice la Consola de administración de AWS o la API. [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html)
### Consola de administración de AWS
Para utilizar la Consola de administración de AWS identificación de canales en su trabajo de transcripción por lotes, active la identificación de audio y, a continuación, la identificación de canales. La identificación de canales es un subconjunto de la identificación de audio en. Consola de administración de AWS
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/transcribe/).
1. En el panel de navegación, en Amazon Transcribe Medicina, seleccione **Trabajos de transcripción**.
1. Seleccione **Crear trabajo**.
1. En la página **Especificar detalles del trabajo**, proporcione información sobre su trabajo de transcripción.
1. Elija **Siguiente**.
1. Habilite **Identificación por audio**.
1. En **Tipo de identificación de audio**, seleccione **Identificación de canal**.
1. Seleccione **Crear**.
### API
**Para transcribir un archivo de audio multicanal (API)**
+ Para la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), especifique lo siguiente.
1. Para `TranscriptionJobName`, especifique un nombre único en su Cuenta de AWS.
1. Para `LanguageCode`, especifique el código de idioma que corresponda al idioma hablado en el archivo de audio. El valor válido es `en-US`.
1. Para el parámetro `MediaFileUri` del objeto `Media`, especifique el nombre del archivo multimedia que desea transcribir.
1. Para el objeto `Settings`, establezca `ChannelIdentification` en `true`.
A continuación, se muestra un ejemplo de solicitud que utiliza AWS SDK para 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
**Para transcribir audio multicanal en un trabajo de transcripción por lotes (AWS CLI)**
+ Ejecute el siguiente código.
```
aws transcribe start-medical-transcription-job \
--region us-west-2 \
--cli-input-json file://example-start-command.json
```
El siguiente es el código de `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
}
}
```
El siguiente código muestra el resultado de la transcripción de un archivo de audio que tiene una conversación en dos canales.
```
{
"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"
},
...
]
}
}
```
## Transcripción de secuencias de audio multicanal
Puede transcribir audio de distintos canales en HTTP/2 o en WebSocket transmisiones mediante la [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.
De forma predeterminada, puede transcribir secuencias de audio con dos canales. Puede solicitar un aumento de cuota si necesita transcribir secuencias que tengan más de dos canales. Para obtener más información acerca de cómo solicitar un aumento de cuota, consulte [Service Quotas de AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html).
### Transcripción de audio multicanal en una secuencia HTTP/2
Para transcribir audio multicanal en una transmisión HTTP/2, usa la [StartMedicalStreamTranscription](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html)API y especifica lo siguiente:
+ `LanguageCode`: el código de idioma del audio. El valor válido es `en-US`.
+ `MediaEncoding`: la codificación del audio. Los valores válidos son `ogg-opus`, `flac` y `pcm`.
+ `EnableChannelIdentification` – `true`
+ `NumberOfChannels`: el número de canales en su streaming de audio.
Para obtener más información sobre cómo configurar una secuencia HTTP/2 para transcribir una conversación médica, consulte [Configuración de una secuencia HTTP/2](streaming-setting-up.md#streaming-http2).
### Transcribir audio multicanal en una transmisión WebSocket
Para particionar los altavoces en las WebSocket transmisiones, utilice el siguiente formato para crear un URI prefirmado e iniciar una solicitud. WebSocket Especifique `enable-channel-identification` como `true` y el número de canales de la secuencia en `number-of-channels`. Un URI prefirmado contiene la información necesaria para configurar la comunicación bidireccional entre la aplicación y Medical. Amazon Transcribe
```
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
```
Las definiciones de los parámetros se encuentran en la [referencia de la API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html); los parámetros comunes a todas las operaciones de la AWS API se enumeran en la sección [Parámetros comunes](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html).
Para obtener más información sobre WebSocket las solicitudes, consulte[Configurar una WebSocket transmisión](streaming-setting-up.md#streaming-websocket).
### Resultado del streaming multicanal
El resultado de una transcripción en streaming es el mismo para HTTP/2 y para WebSocket las solicitudes. El siguiente es un ejemplo de salida.
```
{
"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"
}
```
Para cada segmento de voz, hay una marca `channelId` que indica a qué canal pertenece la voz.
# Transcripción de un dictado médico
Puede usar Amazon Transcribe Medical para transcribir notas médicas dictadas por el médico mediante un trabajo de transcripción por lotes o una transmisión en tiempo real. Los trabajos de transcripción por lotes le permiten transcribir archivos de audio. Usted especifica la especialidad médica del médico en su trabajo o transmisión de transcripción para garantizar que Amazon Transcribe Medical produzca los resultados de la transcripción con la mayor precisión posible.
Puede transcribir la transmisión de audio en las siguientes especialidades:
+ Cardiología: sólo disponible en transcripción de streaming
+ Cardiología: sólo disponible en transcripción de streaming
+ Cardiología: sólo disponible en transcripción de streaming
+ Atención primaria: incluye los siguientes tipos de práctica médica:
+ Medicina familiar
+ Medicina interna
+ Obstetricia y ginecología (OB-GYN)
+ Pediatría
+ Radiología: disponible sólo en transcripción de streaming
+ Urología: disponible sólo en transcripción de streaming
Puede mejorar la precisión de la transcripción mediante el uso de vocabularios personalizados. Para obtener información sobre cómo funcionan los vocabularios médicos personalizados, consulte [Mejora de la precisión de la transcripción con vocabularios médicos personalizados](vocabulary-med.md).
De forma predeterminada, Amazon Transcribe Medical devuelve la transcripción con el nivel de confianza más alto. Si desea configurarlo para que devuelva transcripciones alternativas, consulte. [Generar transcripciones alternativas](alternative-med-transcriptions.md)
Para obtener información sobre cómo aparecen los números y las medidas médicas en el resultado de la transcripción, consulte [Transcripción de números](how-numbers-med.md) y [Transcripción de mediciones y términos médicos](how-measurements-med.md).
**Topics**
+ [Transcripción de un archivo de audio de un dictado médico](batch-medical-dictation.md)
+ [Transcribir un dictado médico en una transmisión en tiempo real](streaming-medical-dictation.md)
# Transcripción de un archivo de audio de un dictado médico
Utilice un trabajo de transcripción por lotes para transcribir archivos de audio de conversaciones médicas. Puede usarlo para transcribir un diálogo entre el médico y el paciente. Puede iniciar un trabajo de transcripción por lotes en la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html) o en Consola de administración de AWS.
Al iniciar un trabajo de transcripción médica con la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), debe especificar `PRIMARYCARE` como valor del parámetro `Specialty`.
## Consola de administración de AWS
**Para transcribir un diálogo entre el médico y el paciente (Consola de administración de AWS)**
**Para usar el Consola de administración de AWS para transcribir un diálogo entre el médico y el paciente, cree un trabajo de transcripción y seleccione **Conversación** como tipo de entrada de audio.**
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/transcribe/).
1. **En el panel de navegación, en Amazon Transcribe Medicina, selecciona Trabajos de transcripción.**
1. Seleccione **Crear trabajo**.
1. En la página **Especificar detalles del trabajo**, en **Configuración del trabajo**, especifique lo siguiente.
1. **Nombre**: el nombre del trabajo de transcripción.
1. **Tipo de entrada de audio**: **dictado**
1. Para el resto de los campos, especifique la Amazon S3 ubicación del archivo de audio y dónde desea almacenar el resultado del trabajo de transcripción.
1. Elija **Next (Siguiente)**.
1. Seleccione **Crear**.
## API
**Para transcribir una conversación médica mediante un trabajo de transcripción por lotes (API)**
+ En la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), especifique lo siguiente.
1. Para `MedicalTranscriptionJobName`, especifique un nombre único en su Cuenta de AWS.
1. En `LanguageCode`, especifique el código de idioma correspondiente al idioma hablado en el archivo multimedia y el idioma de su filtro de vocabulario.
1. En el parámetro `MediaFileUri` del objeto `Media`, especifique el nombre del archivo que desea transcribir.
1. Para `Specialty`, especifique la especialidad médica del profesional que habla en el archivo de audio.
1. En `Type`, especifique `DICTATION`.
1. Para `OutputBucketName`, especifique el bucket de Amazon S3 en el que se almacenarán los resultados de la transcripción.
El siguiente es un ejemplo de solicitud que utiliza el AWS SDK para Python (Boto3) para transcribir un dictado médico de un médico de la especialidad. `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)
```
El siguiente código de ejemplo muestra los resultados de la transcripción de un dictado médico.
```
{
"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
**Para habilitar la partición de las voces en un trabajo de transcripción por lotes (AWS CLI)**
+ Ejecute el siguiente código.
```
aws transcribe start-medical-transcription-job \
--region us-west-2 \
--cli-input-json file://example-start-command.json
```
El texto siguiente muestra el contenido de `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"
}
```
# Transcribir un dictado médico en una transmisión en tiempo real
Utilice una WebSocket transmisión para transcribir un dictado médico como una transmisión de audio. También puede utilizarla Consola de administración de AWS para transcribir el discurso que usted u otras personas pronuncien directamente a un micrófono.
Para un HTTP/2 o una WebSocket transmisión, puedes transcribir audio en las siguientes especialidades médicas:
+ Cardiología
+ Oncología
+ Neurología
+ Atención primaria
+ Radiología
+ Urología
Cada especialidad médica incluye muchos tipos de procedimientos y consultas. Por lo tanto, los médicos dictan muchos tipos diferentes de notas. Usa los siguientes ejemplos como guía para ayudarte a especificar el valor del parámetro `specialty` URI de la WebSocket solicitud o el `Specialty` parámetro de la [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:
+ Para un dictado después de un procedimiento de electrofisiología o ecocardiograma, elija `CARDIOLOGY`.
+ Para un dictado después de un procedimiento de oncología quirúrgica u oncología radioterápica, elija. `ONCOLOGY`
+ Para que un médico dicte notas que indiquen un diagnóstico de encefalitis, elija. `NEUROLOGY`
+ Para obtener un dictado de notas sobre el procedimiento para disolver un cálculo en la vejiga, elija. `UROLOGY`
+ Para dictar las notas del médico después de una consulta de medicina interna, elija. `PRIMARYCARE`
+ Para dictar las notas del médico que comunica los resultados de una tomografía computarizada, una tomografía por emisión de positrones, una resonancia magnética o una radiografía elija `RADIOLOGY`.
+ Para dictar las notas del médico después de una consulta de ginecología, elija. `PRIMARYCARE`
Para mejorar la precisión de la transcripción de términos específicos en una secuencia en tiempo real, utilice un vocabulario personalizado. Para habilitar un vocabulario personalizado, establezca el valor de `vocabulary-name` en el nombre del vocabulario personalizado que desee usar.
## Transcribir un dictado pronunciado al micrófono con el Consola de administración de AWS
Para usar el Consola de administración de AWS para transcribir el audio en streaming de un dictado médico, elige la opción de transcribir un dictado médico, inicia la transmisión y comienza a hablar por el micrófono.
**Para transcribir el audio en streaming de un dictado médico (Consola de administración de AWS)**
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/transcribe/).
1. **En el panel de navegación, en Amazon Transcribe Medicina, selecciona Transcripción en tiempo real.**
1. Seleccione **Dictado.**
1. Para **Especialidad médica**, elija la especialidad médica del profesional que habla en la transmisión.
1. Elija **Comenzar streaming**.
1. Hable por el micrófono.
## Transcripción de un dictado en una secuencia HTTP/2
Para transcribir una secuencia HTTP/2 de un dictado médico, utilice la 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) y especifique lo siguiente:
+ `LanguageCode`: código de idioma. El valor válido es `en-US`
+ `MediaEncoding`: codificación utilizada para el audio de entrada. Los valores válidos son `pcm`, `ogg-opus` y `flac`.
+ `Specialty`: especialidad del profesional médico.
+ `Type` – `DICTATION`
Para obtener más información sobre cómo configurar una transmisión HTTP/2 para transcribir un dictado médico, consulte [Configuración de una secuencia HTTP/2](streaming-setting-up.md#streaming-http2).
## Uso de una solicitud WebSocket de streaming para transcribir un dictado médico
Para transcribir un dictado médico en una transmisión en tiempo real mediante una WebSocket solicitud, debes crear un URI prefirmado. Este URI contiene la información necesaria para configurar la transmisión de audio entre la aplicación y Medical. Amazon Transcribe Para obtener más información sobre la creación de WebSocket solicitudes, consulte[Configurar una WebSocket transmisión](streaming-setting-up.md#streaming-websocket).
Use la siguiente plantilla para crear el URI prefirmado.
```
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
```
Para obtener más información sobre la creación de prefirmados URIs, consulte[Configurar una WebSocket transmisión](streaming-setting-up.md#streaming-websocket).
# Mejora de la precisión de la transcripción con vocabularios médicos personalizados
Para mejorar la precisión de la transcripción en Amazon Transcribe Medicina, crea y usa uno o más vocabularios médicos personalizados. Un *vocabulario personalizado* es una colección de palabras o frases que son específicas de un dominio. Esta colección ayuda a mejorar el rendimiento de Amazon Transcribe Medical a la hora de transcribir esas palabras o frases.
Usted es responsable de la integridad de sus propios datos cuando utiliza Amazon Transcribe Medical. No introduzca información confidencial, información personal (PII) ni información de salud protegida (PHI) en un vocabulario personalizado.
Para obtener los mejores resultados, cree pequeños vocabularios personalizados separados, cada uno de los cuales ayude a transcribir una grabación de audio específica. Obtendrá mayores mejoras en la precisión de la transcripción que si creara un vocabulario personalizado de gran tamaño para usarlo en todas sus grabaciones.
De forma predeterminada, puede tener hasta 100 vocabularios personalizados en su Cuenta de AWS. Un vocabulario personalizado no puede superar los 50 KB de tamaño. Para obtener información sobre cómo solicitar un aumento del número de vocabularios personalizados que puedes tener en tu cuenta Cuenta de AWS, consulta las cuotas de [AWS servicio](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html).
Los vocabularios personalizados están disponibles en inglés estadounidense (en-US).
**Topics**
+ [Crear un archivo de texto para su vocabulario médico personalizado](create-med-vocab-text.md)
+ [Usar un archivo de texto para crear un vocabulario médico personalizado](create-med-custom-vocabulary.md)
+ [Transcribir un archivo de audio utilizando un vocabulario médico personalizado](start-med-custom-vocab-job.md)
+ [Transcribir una transmisión en tiempo real utilizando un vocabulario médico personalizado](start-med-vocab-stream.md)
+ [Juego de caracteres para medicina Amazon Transcribe](charsets-med.md)
# Crear un archivo de texto para su vocabulario médico personalizado
Para crear un vocabulario personalizado, debe crear un archivo de texto en formato UTF-8. En este archivo, se crea una tabla de cuatro columnas, en la que cada columna especifica un campo. Cada campo indica a Amazon Transcribe Medical cómo se pronuncian los términos específicos del dominio o cómo debe mostrarlos en las transcripciones. El archivo de texto que contiene estos campos se guarda en un bucket de Amazon S3 .
## Entender cómo dar formato a un archivo de texto
Para crear un vocabulario médico personalizado, escriba los nombres de las columnas como una fila de encabezado. Ingrese los valores de cada columna debajo de la fila de encabezado.
Los nombres de las cuatro columnas de la tabla son los siguientes:
+ `Phrase`: columna obligatoria, valores obligatorios
+ `IPA`: columna obligatoria, los valores pueden ser opcionales
+ `SoundsLike`: columna obligatoria, los valores pueden ser opcionales
+ `DisplayAs`: columna obligatoria, los valores pueden ser opcionales
Al crear un vocabulario personalizado, asegúrese de:
+ Separe cada columna con un único carácter de tabulación. Amazon Transcribe muestra un mensaje de error si intenta separar las columnas con espacios o varios caracteres de tabulación.
+ Asegúrese de que no haya espacios finales ni espacios en blanco después de cada valor de una columna.
Asegúrese de que los valores que ingresa para cada columna:
+ Tengan menos de 256 caracteres, guiones incluidos
+ Utilice sólo caracteres del conjunto de caracteres permitido; consulte [Juego de caracteres para medicina Amazon Transcribe](charsets-med.md).
## Ingresar valores para las columnas de la tabla
La siguiente información muestra cómo especificar valores para las cuatro columnas de la tabla:
+ `Phrase`: palabra o frase que deben reconocerse. Debe escribir valores en esta columna.
Si la entrada es una frase, separe las palabras con guiones (-). Por ejemplo, escriba **cerebral autosomal dominant arteriopathy with subcortical infarcts and leukoencephalopathy** como **cerebral-autosomal-dominant-arteriopathy-with-subcortical-infarcts-and-leukoencephalopathy**.
Escriba acrónimos u otras palabras cuyas letras deben pronunciarse individualmente como letras simples seguidas de puntos, como **D.N.A.** o **S.T.E.M.I.**. Para introducir la forma plural de un acrónimo, como «»STEMIs, separe la «s» del acrónimo con un guión: "**S.T.E.M.I-s**" Puede utilizar letras mayúsculas o minúsculas para los acrónimos.
La columna `Phrase` es obligatoria. Puede utilizar cualquiera de los caracteres permitidos en el idioma de entrada. Para conocer los caracteres permitidos, consulte [Juego de caracteres para medicina Amazon Transcribe](charsets-med.md). Si no especifica la `DisplayAs` columna, Amazon Transcribe Medical utilizará el contenido de la columna en el archivo de salida. `Phrase`
+ `IPA` (columna obligatoria, los valores pueden ser opcionales): para especificar la pronunciación de una palabra o frase, puede incluir caracteres del [Alfabeto Fonético Internacional (IPA)](https://en.wikipedia.org/wiki/International_Phonetic_Alphabet) en esta columna. La columna `IPA` no puede contener espacios iniciales o finales y sólo debe utilizarse un espacio para separar cada fonema de la entrada. Por ejemplo, en inglés escribiría la frase **acute-respiratory-distress-syndrome** como **ə k j u t ɹ ɛ s p ɪ ɹ ə t ɔ ɹ i d ɪ s t ɹ ɛ s s ɪ n d ɹ oʊ m**. Escribiría la frase **A.L.L.** como **eɪ ɛ l ɛ l**.
Incluso si no especifica el contenido de la columna `IPA`, debe incluir una columna `IPA` en blanco. Si incluye valores en la columna `IPA`, no puede proporcionar valores para la columna `SoundsLike`.
Para obtener una lista de caracteres IPA permitidos para un idioma específico, consulte [Juego de caracteres para medicina Amazon Transcribe](charsets-med.md). El inglés estadounidense es el único idioma disponible en Amazon Transcribe Medicina.
+ `SoundsLike` (la columna es obligatoria, los valores pueden ser opcionales): puede dividir una palabra o frase en segmentos más pequeños y proporcionar una pronunciación para cada segmento utilizando la ortografía estándar del idioma para imitar la forma en que suena la palabra. Por ejemplo, puede proporcionar sugerencias de pronunciación para la frase **cerebral-autosomal-dominant-arteriopathy-with-subcortical-infarcts-and-leukoencephalopathy** de este modo: **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**. La sugerencia para la frase **atrioventricular-nodal-reentrant-tachycardia** sería: **ay-tree-o-ven-trick-u-lar-node-al-re-entr-ant-tack-ih-card-ia**. Separe cada parte de la sugerencia con un guion (-).
Incluso si no proporciona valores para la columna `SoundsLike`, debe incluir una columna `SoundsLike` en blanco. Si incluye valores en la columna `SoundsLike`, no puede proporcionar valores para la columna `IPA`.
Puede utilizar cualquiera de los caracteres permitidos en el idioma de entrada. Para obtener una lista de los caracteres permitidos, consulte [Juego de caracteres para medicina Amazon Transcribe](charsets-med.md).
+ `DisplayAs` (columna obligatoria, los valores pueden ser opcionales): define el aspecto de la palabra o frase cuando se imprime. Por ejemplo, si la palabra o frase es **cerebral-autosomal-dominant-arteriopathy-with-subcortical-infarcts-and-leukoencephalopathy**, puede indicar que debe mostrarse como `cerebral autosomal dominant arteriopathy with subcortical infarcts and leukoencephalopathy` para que el guion no aparezca. También puede especificar `DisplayAs` como `CADASIL` si desea mostrar el acrónimo en lugar del término completo en la salida.
Si no especifica la `DisplayAs` columna, Amazon Transcribe Medical utilizará la `Phrase` columna del archivo de entrada en la salida.
Puede utilizar cualquier carácter UTF-8 en la columna `DisplayAs`.
Incluya espacios sólo para los valores de las columnas `IPA` y `DisplayAs`.
Para crear el archivo de texto de su vocabulario personalizado, coloque cada palabra o frase del archivo de texto en una línea separada. Separe las columnas con caracteres de tabulación. Incluya espacios solo para los valores de las columnas `IPA` y `DisplayAs`. Guarda el archivo con la extensión `.txt` en un compartimento Amazon S3 en el mismo Región de AWS lugar en el que usaste Amazon Transcribe Medical para crear tu vocabulario personalizado.
Si edita el archivo de texto en Windows, asegúrese de que el archivo está en formato `LF` y no en formato `CRLF`. De lo contrario, no podrá crear su vocabulario personalizado. Algunos editores de texto le permiten cambiar el formato con los comandos Find (Buscar) y Replace (Reemplazar).
En los ejemplos siguientes se muestra texto que puede utilizar para crear vocabularios personalizados. Para crear un vocabulario personalizado a partir de estos ejemplos, copie un ejemplo en un editor de texto, reemplace `[TAB]` por un carácter de tabulación y cargue el archivo de texto guardado en 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]
```
Puede especificar las columnas en cualquier orden. Los siguientes ejemplos muestran otras estructuras válidas para el archivo de entrada de vocabulario personalizado.
```
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
```
Para facilitar la lectura, las siguientes tablas muestran los ejemplos anteriores con mayor claridad en formato html. Están destinadas únicamente a ilustrar los ejemplos.
| Phrase | 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 | |
| Phrase | 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 | Phrase |
| --- | --- | --- | --- |
| 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 |
# Usar un archivo de texto para crear un vocabulario médico personalizado
Para crear un vocabulario personalizado, debe haber preparado un archivo de texto que contenga una colección de palabras o frases. Amazon Transcribe Medical utiliza este archivo de texto para crear un vocabulario personalizado que puede utilizar para mejorar la precisión de la transcripción de esas palabras o frases. Puede crear un vocabulario personalizado mediante la [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html)API o la consola Amazon Transcribe médica.
## Consola de administración de AWS
Para usarlo y Consola de administración de AWS crear un vocabulario personalizado, debes proporcionar el Amazon S3 URI del archivo de texto que contiene tus palabras o frases.
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/transcribe/).
1. En el panel de navegación, en Amazon Transcribe Medicina, selecciona **Vocabulario personalizado**.
1. En **Nombre**, en **Configuración de vocabulario**, elija un nombre para su vocabulario personalizado.
1. Especifique la ubicación del archivo de audio o de vídeo en Amazon S3:
+ En **Ubicación del archivo de entrada de vocabulario en S3**, en **Configuración de vocabulario**, especifique el URi de Amazon S3 que identifica el archivo de texto que utilizará para crear su vocabulario personalizado.
+ En **Ubicación del archivo de entrada de vocabulario en S3**, seleccione **Examinar S3** para buscar el archivo de texto y seleccionarlo.
1. Seleccione **Crear vocabulario**.
Puede ver el estado de procesamiento de su vocabulario personalizado en Consola de administración de AWS.
## API
**Para crear un vocabulario médico personalizado (API)**
+ En la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html), especifique lo siguiente.
1. En `LanguageCode`, especifique `en-US`.
1. Para`VocabularyFileUri`, especifique la Amazon S3 ubicación del archivo de texto que utiliza para definir su vocabulario personalizado.
1. En `VocabularyName`, especifique un nombre para su vocabulario personalizado. El nombre que especifique debe ser único dentro de su Cuenta de AWS.
Puede ver el estado de procesamiento de su vocabulario personalizado, utilice la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetMedicalVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetMedicalVocabulary.html).
El siguiente es un ejemplo de solicitud AWS SDK para Python (Boto3) que se utiliza para crear un vocabulario personalizado.
```
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
**Para habilitar la partición de las voces en un trabajo de transcripción por lotes (AWS CLI)**
+ Ejecute el siguiente código.
```
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
```
# Transcribir un archivo de audio utilizando un vocabulario médico personalizado
Utilice el [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html)o el Consola de administración de AWS para iniciar un trabajo de transcripción que utilice un vocabulario personalizado para mejorar la precisión de la transcripción.
## Consola de administración de AWS
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/transcribe/).
1. En el panel de navegación, en Amazon Transcribe Medicina, selecciona **Trabajos de transcripción**.
1. Seleccione **Crear trabajo**.
1. En la página **Especificar detalles del trabajo**, proporcione información sobre su trabajo de transcripción.
1. Elija **Siguiente**.
1. En **Personalización**, habilite **Vocabulario personalizado**.
1. En **Selección de vocabulario**, elija un vocabulario personalizado.
1. Seleccione **Crear**.
## API
**Para habilitar la partición de las voces en un archivo de audio mediante un trabajo de transcripción por lotes (API)**
+ En la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), especifique lo siguiente.
1. En `MedicalTranscriptionJobName`, especifique un nombre que sea único en su Cuenta de AWS.
1. En `LanguageCode`, especifique el código de idioma correspondiente al idioma hablado en el archivo multimedia y el idioma del filtro de vocabulario.
1. En el parámetro `MediaFileUri` del objeto `Media`, especifique el nombre del archivo multimedia que desea transcribir.
1. En `Specialty`, especifique la especialidad médica del profesional que habla en el archivo de audio.
1. En `Type`, especifique si el archivo de audio es una conversación o un dictado.
1. En `OutputBucketName`, especifique el bucket de Amazon S3 en el que se almacenarán los resultados de la transcripción.
1. En el objeto `Settings`, especifique lo siguiente.
1. `VocabularyName`: el nombre de su vocabulario personalizado.
La siguiente solicitud utiliza el AWS SDK para Python (Boto3) para iniciar un trabajo de transcripción por lotes con un vocabulario personalizado.
```
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)
```
# Transcribir una transmisión en tiempo real utilizando un vocabulario médico personalizado
Para mejorar la precisión de la transcripción en una transmisión en tiempo real, puedes usar un vocabulario personalizado utilizando HTTP/2 o WebSocket secuencias. Para iniciar una solicitud HTTP/2, utilice la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html). Puedes usar un vocabulario personalizado en tiempo real mediante la [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 o mediante el WebSocket protocolo. Consola de administración de AWS
## Transcribir un dictado que se pronuncia en el micrófono (Consola de administración de AWS)
Para usar la Consola de administración de AWS transcripción del audio en streaming de un dictado médico, elige la opción de transcribir un dictado médico, inicia la transmisión y comienza a hablar por el micrófono.
**Para transcribir el audio en streaming de un dictado médico (Consola de administración de AWS)**
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/transcribe/).
1. **En el panel de navegación, en Amazon Transcribe Medicina, selecciona Transcripción en tiempo real.**
1. Para **Especialidad médica**, elija la especialidad médica del médico que habla en la transmisión.
1. En **Tipo de entrada de audio**, seleccione **Conversación** o **Dictado**.
1. En **ajustes adicionales**, seleccione **Vocabulario personalizado**.
1. En **Selección de vocabulario**, elija el vocabulario personalizado.
1. Elija **Comenzar streaming**.
1. Hable al micrófono.
## Habilitar la partición de las voces en una secuencia HTTP/2
La siguiente es la sintaxis de los parámetros de una solicitud 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
```
Descripciones de los parámetros:
+ **host**: actualiza el Región de AWS ('us-west-2' en el ejemplo anterior) con Región de AWS el que estás llamando. Para obtener una lista de puntos finales válidos Regiones de AWS, consulte [Regiones de AWS y](https://docs.aws.amazon.com/general/latest/gr/rande.html#transcribe_region) Endpoints.
+ **autorización**: se trata de un campo generado. Para obtener más información sobre cómo crear una firma, consulte [Firmar AWS solicitudes con la versión 4 de Signature](https://docs.aws.amazon.com/general/latest/gr/sigv4_signing.html).
+ **x-amz-target**: No modifique este campo; utilice el contenido que se muestra en el ejemplo anterior.
+ **x-amz-content-sha256**: Se trata de un campo generado. Para obtener más información sobre el cálculo de una firma, consulte [Firmar AWS solicitudes con firma, versión 4](https://docs.aws.amazon.com/general/latest/gr/sigv4_signing.html).
+ **x-amz-date**: la fecha y la hora en que se creó la firma. El formato es YYYMMDDTHHMMSSZ, donde YYYY=año, MM=mes, DD=día, HH=hora, MM=minuto, SS=segundos y 'T' y 'Z' son caracteres fijos. Para obtener más información, consulte [Control de fechas en Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/sigv4-date-handling.html).
+ **x-amzn-transcribe-session-id**: el nombre de tu sesión de streaming.
+ **x-amzn-transcribe-language-code**: la codificación utilizada para el audio de entrada. Consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html) o [Idiomas compatibles y características específicas de cada idioma](supported-languages.md) para obtener una lista de valores válidos.
+ **x-amzn-transcribe-media-codificación**: la codificación utilizada para el audio de entrada. Los valores válidos son `pcm`, `ogg-opus` y `flac`.
+ **x-amzn-transcribe-sample-frecuencia: frecuencia** de muestreo del audio de entrada (en hercios). Amazon Transcribe admite un rango de 8.000 Hz a 48.000 Hz. El audio de baja calidad, como el audio de un teléfono, suele rondar los 8 000 Hz. El audio de alta calidad suele oscilar entre 16 000 Hz y 48 000 Hz. Tenga en cuenta que la frecuencia de muestreo que especifique **debe** coincidir con la del audio.
+ **x-amzn-transcribe-vocabulary-name**: el nombre del vocabulario que quieres usar con tu transcripción.
+ **x-amzn-transcribe-specialty**: La especialidad médica que se está transcribiendo.
+ **x-amzn-transcribe-type**: Elige si se trata de un dictado o de una conversación.
+ **x-amzn-transcribe-show-speaker-label**: para habilitar la diarización, este valor debe ser. `true`
+ **x-amz-target**: no modifique este campo; utilice el contenido que se muestra en el ejemplo anterior.
## Habilitar la partición de los altavoces en una solicitud WebSocket
Para particionar los altavoces en las WebSocket transmisiones con la API, usa el siguiente formato para crear un URI prefirmado para iniciar una WebSocket solicitud y `vocabulary-name` establecer el nombre del vocabulario personalizado.
```
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
```
# Juego de caracteres para medicina Amazon Transcribe
Para utilizar los vocabularios personalizados en Amazon Transcribe Medicina, utilice el siguiente juego de caracteres.
## Juego de caracteres en inglés
En el caso de los vocabularios personalizados del inglés, puede utilizar los siguientes caracteres en las columnas `Phrase` y `SoundsLike`:
+ a - z
+ A - Z
+ ' (apóstrofo)
+ - (guion)
+ . (punto)
Puede utilizar los siguientes caracteres del Alfabeto Fonético Internacional en la columna `IPA` del archivo de entrada del vocabulario.
| Character | Código | Character | Código |
| --- | --- | --- | --- |
| 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 |
# Identificación de información médica protegida (PHI) en una transcripción
Use la *identificación de información médica protegida* para etiquetar la información médica protegida (PHI) en los resultados de su transcripción. Al revisar las etiquetas, puede encontrar la PHI que podría usarse para identificar a un paciente.
Puede identificar la PHI mediante un trabajo de transcripción en tiempo real o por lotes.
Puede utilizar su propio procesamiento posterior para redactar la PHI identificada en el resultado de la transcripción.
Use la identificación de información médica protegida para identificar los siguientes tipos de PHI:
+ PIN personal:
+ Nombres: nombre completo o apellido e inicial
+ Gender
+ Antigüedad
+ Números de teléfono
+ Fechas (sin incluir el año) que se relacionan directamente con el paciente
+ Direcciones de correo electrónico
+ PHI geográfica:
+ Dirección física
+ Código postal
+ Nombre del centro o consultorio médico
+ PHI de la cuenta:
+ Números de fax
+ Números de seguro social (SSNs)
+ Números de beneficiarios del seguro de salud
+ Números de cuenta
+ Números de certificado o licencia
+ PHI del vehículo:
+ Número de identificación de vehículo (VIN)
+ Número de matrícula
+ Otros PHI:
+ Ubicación uniforme de recursos en la web (URL)
+ Números de dirección del Protocolo de Internet (IP)
Amazon Transcribe Medical es un servicio que cumple con los requisitos de la Ley de Portabilidad y Responsabilidad de los Seguros Médicos de 1996 (HIPAA). Para obtener más información, consulte [Amazon Transcribe Medical](transcribe-medical.md). Para obtener información sobre cómo identificar la PHI en un archivo de audio, consulte. [Identificación de la PHI en un archivo de audio](phi-id-batch.md) Para obtener información sobre cómo identificar la PHI en una secuencia, consulte. [Identificar la PHI en una secuencia en tiempo real](phi-id-stream.md)
**Topics**
+ [Identificación de la PHI en un archivo de audio](phi-id-batch.md)
+ [Identificar la PHI en una secuencia en tiempo real](phi-id-stream.md)
# Identificación de la PHI en un archivo de audio
Utilice un trabajo de transcripción por lotes para transcribir archivos de audio e identificar la información médica protegida (PHI) que contienen. Cuando activa la identificación de información de salud personal (PHI), Amazon Transcribe Medical etiqueta la PHI que identificó en los resultados de la transcripción. Para obtener información sobre la PHI que Amazon Transcribe Medical puede identificar, consulte[Identificación de información médica protegida (PHI) en una transcripción](phi-id.md).
Puede iniciar un trabajo de transcripción por lotes en la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html) o en Consola de administración de AWS.
## Consola de administración de AWS
**Para usar el Consola de administración de AWS para transcribir un diálogo entre el médico y el paciente, cree un trabajo de transcripción y seleccione **Conversación** como tipo de entrada de audio.**
**Para transcribir un archivo de audio e identificar su PHI (Consola de administración de AWS)**
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/transcribe/).
1. **En el panel de navegación, en Amazon Transcribe Medicina, selecciona Trabajos de transcripción.**
1. Seleccione **Crear trabajo**.
1. En la página **Especificar detalles del trabajo**, en **Configuración del trabajo**, especifique lo siguiente.
1. **Nombre**: el nombre del trabajo de transcripción que es exclusivo para usted Cuenta de AWS.
1. **Tipo de entrada de audio**: **conversación** o **Dictado.**
1. Para el resto de los campos, especifique la Amazon S3 ubicación del archivo de audio y dónde desea almacenar el resultado del trabajo de transcripción.
1. Elija **Siguiente**.
1. En **Configuración de audio**, seleccione **Identificación PHI**.
1. Seleccione **Crear**.
## API
**Para transcribir un archivo de audio e identificar su PHI mediante un trabajo de transcripción por lotes (API)**
+ Para la API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), especifique lo siguiente.
1. Para `MedicalTranscriptionJobName`, especifique un nombre que sea exclusivo de su Cuenta de AWS.
1. Para `LanguageCode`, especifique el código de idioma que corresponda al idioma hablado en el archivo de audio.
1. En el parámetro `MediaFileUri` del objeto `Media`, especifique el nombre del archivo multimedia que desea transcribir.
1. Para `Specialty`, especifique la especialidad médica del profesional que habla en el archivo de audio como `PRIMARYCARE`.
1. En `Type`, especifique `CONVERSATION` o `DICTATION`.
1. Para `OutputBucketName`, especifique el bucket de Amazon S3 en el que desee almacenar los resultados de la transcripción.
El siguiente es un ejemplo de solicitud que utiliza el AWS SDK para Python (Boto3) para transcribir un archivo de audio e identificar la PHI de un paciente.
```
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)
```
El siguiente código de ejemplo muestra los resultados de la transcripción con la PHI del paciente identificada.
```
{
"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
**Para transcribir un archivo de audio e identificar su PHI mediante un trabajo de transcripción por lotes (AWS CLI)**
+ Ejecute el siguiente código.
```
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
```
# Identificar la PHI en una secuencia en tiempo real
Puede identificar la información de salud personal (PHI) en HTTP/2 o en WebSocket Streams. Al activar la identificación de la PHI, Amazon Transcribe Medical etiqueta la PHI que identifica en los resultados de la transcripción. Para obtener información sobre la PHI que Amazon Transcribe Medical puede identificar, consulte[Identificación de información médica protegida (PHI) en una transcripción](phi-id.md).
## Cómo identificar la PHI mediante un dictado pronunciado por el micrófono
Para usar el Consola de administración de AWS para transcribir el discurso captado por el micrófono e identificar cualquier PHI, elija **Dictado** como tipo de entrada de audio, inicie la transmisión y comience a hablar por el micrófono de su computadora.
**Para identificar la PHI en un dictado mediante el Consola de administración de AWS**
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/transcribe/).
1. En el panel de navegación, elija **Transcripción en tiempo real**.
1. En el **Tipo de entrada de audio**, elija **Dictado**.
1. Para **Ajustes adicionales**, seleccione **Identificación PHI**.
1. Seleccione **Iniciar transmisión** y hable por el micrófono.
1. Seleccione **Detener transmisión** para finalizar el dictado.
## Identificación de PHI en un flujo HTTP/2
Para iniciar una secuencia HTTP/2 con la identificación de PHI activada, utilice la 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) y especifique lo siguiente:
+ Para `LanguageCode`, especifique el código de idioma que corresponda al idioma hablado en la secuencia. Para el inglés estadounidense, especifique `en-US`.
+ Para `MediaSampleHertz`, especifique la frecuencia de muestreo del audio.
+ En `content-identification-type`, especifique `PHI`.
## Identificar la PHI en una transmisión WebSocket
Para iniciar una WebSocket transmisión con la identificación de la PHI activada, utilice el siguiente formato para crear una URL prefirmada.
```
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
```
Las definiciones de los parámetros se encuentran en la [referencia de la API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html); los parámetros comunes a todas las operaciones de la AWS API se enumeran en la sección [Parámetros comunes](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html).
# Generar transcripciones alternativas
Cuando utilizas Amazon Transcribe Medical, obtienes la transcripción con el mayor nivel de confianza. Sin embargo, puede configurar Amazon Transcribe Medical para que devuelva transcripciones adicionales con niveles de confianza más bajos.
Utilice transcripciones alternativas para ver diferentes interpretaciones del audio transcrito. Por ejemplo, si utiliza una aplicación que permite que una persona revise la transcripción, puede presentar las transcripciones alternativas para que esa persona elija.
Puede generar transcripciones alternativas con la API Consola de administración de AWS o la [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html)API.
## Consola de administración de AWS
Si desea utilizarla Consola de administración de AWS para generar transcripciones alternativas, habilite los resultados alternativos al configurar su trabajo.
1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/transcribe/).
1. En el panel de navegación, en Amazon Transcribe Medicina, seleccione **Trabajos de transcripción**.
1. Seleccione **Crear trabajo**.
1. En la página **Especificar detalles del trabajo**, proporcione información sobre su trabajo de transcripción.
1. Elija **Siguiente**.
1. Habilite **Resultados alternativos**.
1. En **Alternativas máximas**, escriba un valor entero entre 2 y 10 para obtener el número máximo de transcripciones alternativas que desee incluir en el resultado.
1. Seleccione **Crear**.
## API
**Para habilitar la partición de las voces en un archivo de audio mediante un trabajo de transcripción por lotes (API)**
+ En la API de [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), especifique lo siguiente.
1. En `MedicalTranscriptionJobName`, especifique un nombre que sea único en su Cuenta de AWS.
1. En `LanguageCode`, especifique el código de idioma correspondiente al idioma hablado en el archivo multimedia y el idioma del filtro de vocabulario.
1. En el parámetro `MediaFileUri` del objeto `Media`, especifique el nombre del archivo multimedia que desee transcribir.
1. Para `Specialty`, especifique la especialidad médica del profesional que habla en el archivo de audio.
1. En `Type`, especifique si va a transcribir una conversación médica o un dictado.
1. En `OutputBucketName`, especifique el bucket de Amazon S3 para almacenar los resultados de la transcripción.
1. En el objeto `Settings`, especifique lo siguiente.
1. `ShowAlternatives` – `true`.
1. `MaxAlternatives`: un número entero entre 2 y 10 para indicar el número de transcripciones alternativas que desea incluir en el resultado de la transcripción.
La siguiente solicitud utiliza el AWS SDK para Python (Boto3) para iniciar un trabajo de transcripción que genera hasta dos transcripciones alternativas.
```
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
**Para transcribir un archivo de audio de una conversación entre un médico de atención primaria y un paciente (AWS CLI)**
+ Ejecute el siguiente código.
```
aws transcribe start-transcription-job \
--cli-input-json file://filepath/example-start-command.json
```
El texto siguiente muestra el contenido de `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 Terminales de VPC médicas y de interfaz ()AWS PrivateLink
Puede establecer una conexión privada entre su VPC y Amazon Transcribe Medical mediante la creación de un punto final de interfaz de *VPC*. Los terminales de interfaz funcionan con una tecnología que le permite acceder al sector Amazon Transcribe médico de forma privada APIs sin una pasarela de Internet, un dispositivo NAT, una conexión VPN o una conexión. [AWS PrivateLink](https://aws.amazon.com/privatelink) Direct Connect Las instancias de su VPC no necesitan direcciones IP públicas para comunicarse con Amazon Transcribe Medical. APIs El tráfico entre tu VPC y Amazon Transcribe Medical no sale de la red de Amazon.
Cada punto de conexión de la interfaz está representado por una o más [interfaces de red elásticas](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html) en las subredes.
Para obtener más información, consulte [Puntos de conexión de VPC de interfaz (AWS PrivateLink)](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html) en la *Guía del usuario de Amazon VPC *.
## Consideraciones sobre los criterios de Amazon Transcribe valoración de la VPC médica
Antes de configurar un punto final de VPC de interfaz para uso Amazon Transcribe médico, asegúrese de revisar las [propiedades y limitaciones del punto final de la interfaz](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#vpce-interface-limitations) en la Guía del *Amazon VPC usuario*.
Amazon Transcribe Medical admite realizar llamadas a todas sus acciones de API desde su VPC.
## Creación de un punto final de VPC de interfaz para medicina Amazon Transcribe
Puede crear un punto final de VPC para el servicio Amazon Transcribe médico mediante el Consola de administración de AWS o el. AWS CLI Para obtener más información, consulte [Creación de un punto de conexión de interfaz](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#create-interface-endpoint) en la *Guía del usuario de Amazon VPC *.
Para la transcripción por lotes en Amazon Transcribe Medical, cree un punto final de VPC con el siguiente nombre de servicio:
+ com.amazonaws. *us-west-2*.transcribir
Para transmitir la transcripción en Amazon Transcribe Medical, cree un punto final de VPC con el siguiente nombre de servicio:
+ com.amazonaws. *us-west-2*.transcriba la transmisión
Si habilita el DNS privado para el punto final, puede realizar solicitudes de API a Amazon Transcribe Medical utilizando su nombre de DNS predeterminado para, por ejemplo Región de AWS,. `transcribestreaming.us-east-2.amazonaws.com`
Para obtener más información, consulte [Acceso a un servicio a través de un punto de conexión de interfaz](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#access-service-though-endpoint) en la *Guía del usuario de Amazon VPC *.
## Creación de una política de puntos finales de VPC para la transmisión médica Amazon Transcribe
Puede adjuntar una política de punto final a su punto final de VPC que controle el acceso a Amazon Transcribe Medical. La política especifica la siguiente información:
+ La entidad principal que puede realizar acciones.
+ Las acciones que se pueden realizar.
+ Los recursos en los que se pueden llevar a cabo las acciones.
Para más información, consulte [Control del acceso a los servicios con puntos de enlace de la VPC](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-endpoints-access.html) en la *Guía del usuario de Amazon VPC*.
**Ejemplo: política de puntos finales de VPC para acciones de transcripción de streaming Amazon Transcribe médico**
El siguiente es un ejemplo de una política de punto final para la transmisión de transcripciones en Amazon Transcribe Medical. Cuando se adjunta a un punto final, esta política otorga acceso a las acciones Amazon Transcribe médicas enumeradas a todos los directores de todos los recursos.
```
{
"Statement":[
{
"Principal":"*",
"Effect":"Allow",
"Action":[
"transcribe:StartMedicalStreamTranscription",
],
"Resource":"*"
}
]
}
```
**Ejemplo: política de puntos finales de VPC para acciones de transcripción de lotes Amazon Transcribe médicos**
El siguiente es un ejemplo de una política de puntos finales para la transcripción por lotes en Amazon Transcribe Medical. Cuando se adjunta a un punto final, esta política otorga acceso a las acciones Amazon Transcribe médicas enumeradas a todos los directores de todos los recursos.
```
{
"Statement":[
{
"Principal":"*",
"Effect":"Allow",
"Action":[
"transcribe:StartMedicalTranscriptionJob"
],
"Resource":"*"
}
]
}
```
## Subredes compartidas
No puede crear, describir, modificar ni eliminar puntos de conexión de VPC en subredes que se compartan con usted. No obstante, puede usar los puntos de conexión de VPC en las subredes que se compartan con usted. Para obtener información sobre el uso compartido de VPC, consulte [Compartir su VPC con otras cuentas](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-sharing.html#vpc-sharing-service-behavior) en la guía. Amazon Virtual Private Cloud