As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Amazon Transcribe Medical O Amazon Transcribe Medical é um serviço de reconhecimento automático de fala (ASR) projetado para profissionais médicos que desejam transcrever falas relacionadas à medicina, como notas ditadas por médicos, monitoramento de segurança de medicamentos, consultas de telemedicina ou conversas entre médico e paciente. O Amazon Transcribe Medical está disponível por meio de streaming em tempo real (via microfone) ou transcrição de um arquivo carregado (lote). **Importante** O Amazon Transcribe Medical não substitui a orientação, o diagnóstico ou o tratamento médico profissional. Identifique o limite de confiança certo para seu caso de uso e use limites de alta confiança em situações que exigem alta precisão. Para determinados casos de uso, os resultados devem ser revisados e verificados por revisores humanos devidamente treinados. As transcrições do Amazon Transcribe Medical só devem ser usadas em cenários de atendimento ao paciente depois que profissionais médicos treinados fizerem uma análise de precisão e fornecerem um parecer médico minucioso. O Amazon Transcribe Medical opera sob um modelo de responsabilidade compartilhada, no qual a AWS é responsável por proteger a infraestrutura que executa o Amazon Transcribe Medical e você é responsável por gerenciar seus dados. Para obter mais informações, consulte [Modelo de responsabilidade compartilhada](https://aws.amazon.com/compliance/shared-responsibility-model/). O Amazon Transcribe Medical está disponível em inglês americano (en-US). Para obter melhores resultados, use um formato de áudio sem perdas, como FLAC ou WAV, com codificação PCM de 16 bits. O Amazon Transcribe Medical é compatível com taxas de amostragem de 16.000 Hz ou mais. Para a análise de transcrições, você pode usar outros Serviços da AWS, como o [Amazon Comprehend Medical](https://docs.aws.amazon.com/comprehend/latest/dg/comprehend-medical.html). **Especialidades compatíveis** | Especialidade | Subespecialidade | Entrada de áudio | | --- | --- | --- | | Cardiologia | nenhuma | somente streaming | | Neurologia | nenhuma | somente streaming | | Oncologia | nenhuma | somente streaming | | Atenção primária | Medicina da família | lote de streaming | | Atenção primária | Medicina interna | lote de streaming | | Atenção primária | Obstetrícia e ginecologia (OB-GYN) | lote de streaming | | Atenção primária | Pediatria | lote de streaming | | Radiologia | nenhuma | somente streaming | | Urologia | nenhuma | somente streaming | ## Disponibilidade e cotas da região O Call Analytics é compatível com as seguintes Regiões da AWS: | **Região da** | **Tipo de transcrição** | | --- | --- | | af-south-1 (Cidade do Cabo) | lote | | ap-east-1 (Hong Kong) | lote | | ap-northeast-1 (Tóquio) | lote de streaming | | ap-northeast-2 (Seul) | lote de streaming | | ap-south-1 (Mumbai) | lote | | ap-southeast-1 (Singapura) | lote | | ap-southeast-2 (Sydney) | lote de streaming | | ca-central-1: (Canadá, Central) | lote de streaming | | eu-central-1 (Frankfurt) | lote de streaming | | eu-north-1 (Estocolmo) | lote | | eu-west-1 (Irlanda) | lote de streaming | | eu-west-2 (Londres) | lote de streaming | | eu-west-3 (Paris) | lote | | me-south-1 (Bahrein) | lote | | sa-east-1 (São Paulo) | lote de streaming | | us-east-1 (N. Virginia) | lote de streaming | | us-east-2 (Ohio) | lote de streaming | | us-gov-east-1: (GovCloud, Leste dos EUA) | lote de streaming | | us-gov-west-1, GovCloud (US-West) | lote de streaming | | us-west-1 (São Francisco) | lote | | us-west-2 (Oregon) | lote de streaming | Observe que o suporte de região é diferente para o [Amazon Transcribe](what-is.md#tsc-regions), o Amazon Transcribe Medical e o [Call Analytics](call-analytics.md#tca-regions). Para obter os endpoints de cada região com suporte, consulte [Service endpoints](https://docs.aws.amazon.com/general/latest/gr/transcribe.html#transcribe_region) na *Referência geral da AWS*. Para obter uma lista de cotas referentes às suas transcrições, consulte as [Service quotas](https://docs.aws.amazon.com/general/latest/gr/transcribe.html#limits-amazon-transcribe) na *Referência geral da AWS*. Algumas cotas podem ser alteradas mediante solicitação. Se a coluna **Ajustável** contiver “**Sim**”, você poderá solicitar um aumento. Para fazer isso, selecione o link fornecido. # Especialidades e termos médicos Ao criar um trabalho de transcrição médica, especifique o idioma, a especialidade médica e o tipo de áudio do arquivo de origem. Insira inglês dos EUA (en-US) como o idioma e `PRIMARYCARE` como a especialidade médica. Inserir a atenção primária como o valor permite gerar transcrições do áudio de origem nas seguintes especialidades médicas: + Medicina da família + Medicina interna + Obstetrícia e ginecologia (OB-GYN) + Pediatria Você pode escolher entre ditado e conversa para o tipo de áudio. Escolha ditado para arquivos de áudio onde o médico está passando um relatório sobre uma consulta ou um procedimento do paciente. Escolha conversa para arquivos de áudio que envolvam uma conversa entre um médico e um paciente ou entre médicos. Para armazenar a saída do seu trabalho de transcrição, selecione um Amazon S3 bucket que você já tenha criado. Para obter mais informações sobre Amazon S3 buckets, consulte [Introdução ao Amazon Simple Storage Service](https://docs.aws.amazon.com/AmazonS3/latest/gsg/GetStartedWithS3.html). Veja a seguir o número mínimo de parâmetros de solicitação a serem inseridos no JSON de amostra. ``` { "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 O Medical permite que você gere transcrições alternativas. Para obter mais informações, consulte [Gerar transcrições alternativas](alternative-med-transcriptions.md). Você também pode habilitar a separação de locutores ou identificar canais no áudio. Para obter mais informações, consulte [Habilitar a separação de locutores](conversation-diarization-med.md) e [Transcrever áudio multicanal](conversation-channel-id-med.md). # Transcrever medidas e termos médicos Amazon Transcribe Médico pode transcrever termos e medidas médicas. Amazon Transcribe Abreviações de resultados médicos para termos falados. Por exemplo, "pressão arterial" é transcrita como PA. Você pode encontrar uma lista das convenções que a Amazon Transcribe Medical usa para termos e medidas médicas na tabela desta página. A coluna *Termo falado* refere-se ao termo falado no áudio de origem. A coluna *Resultado* refere-se à abreviatura que você verá nos resultados da transcrição. Você pode ver como os termos falados no áudio fonte correspondem ao resultado da transcrição aqui. | Termo falado no áudio de origem | Abreviatura usada na saída | Exemplo de saída de | | --- | --- | --- | | Centígrado | C | A temperatura do paciente é de 37,4 C. | | Célsius | C | A temperatura do paciente é de 37,4 C. | | Fahrenheit | F | A temperatura do paciente é 101 F. | | gramas | g | Uma massa de 100 g foi extraída do paciente. | | metros | m | O paciente tem 1,8 m de altura. | | pés | ft | O paciente tem 6 ft de altura. | | Quilos | kg | O paciente pesa 80 kg. | | quilogramas | kg | O paciente pesa 80 kg. | | c c | cc | O paciente recebeu 100 cc de solução salina. | | centímetro cúbico | cc | O paciente recebeu 100 cc de solução salina. | | mililitro | mL | O paciente excretou 100 mL de urina. | | pressão arterial | PA | A pressão arterial do paciente estava alta. | | p a | PA | A pressão arterial do paciente estava alta. | | X por Y | X/Y | A PA do paciente era de 120/80. | | batimentos por min | BPM | O paciente teve fibrilação atrial com frequência cardíaca de 160 BPM. | | batimentos por minuto | BPM | O paciente teve fibrilação atrial com frequência cardíaca de 160 BPM. | | O 2 | O2 | A saturação de O2 do paciente estava em 98%. | | CO2 | CO2 | O paciente necessitou de suporte respiratório para elevação CO2. | | pós-operação | POSTOP | O paciente veio para avaliação de POSTOP. | | pós-operatório | POSTOP | O paciente veio para avaliação de POSTOP. | | tomografia computadorizada | Tomografia computadorizada | Como o paciente parecia ter sofrido uma hemorragia cerebral, foi necessário fazer uma tomografia computadorizada. | | Pulso 80 | P 80 | Os sinais vitais do paciente foram P 80, R 17,... | | Respiração 17 | R 17 | Os sinais vitais do paciente foram P 80, R 17,... | | arritmia | E/S | Paciente estava com I/O ritmo sinusal | | L cinco | L5 | A punção lombar foi realizada entre a L4 e a L5 | # Transcrever números Amazon Transcribe O médico transcreve dígitos como números em vez de palavras. Por exemplo, o número falado "mil duzentos e quarenta e dois" é transcrito como `1242`. Os números são transcritos de acordo com as regras a seguir. | Rule | Description | | --- | --- | | Converter números cardinais maiores que 10 em números. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/how-numbers-med.html) | | Converter números cardinais seguidos de "milhão" ou "bilhão" em numerais seguidos de uma palavra quando "milhão" ou "bilhão" não for seguido por um número. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/how-numbers-med.html) | | Converter números ordinais maiores que 10 em números. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/how-numbers-med.html) | | Converter frações no respectivo formato numérico. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/how-numbers-med.html) | | Converter números menores que 10 dígitos se houver mais de um em uma linha. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/how-numbers-med.html) | | Os decimais são indicados por "ponto". | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/how-numbers-med.html) | | Converter a palavra "porcento" após um número em um sinal de porcentagem (%). | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/how-numbers-med.html) | | Converter as palavras "dólar", "dólar americano", "dólar australiano", "AUD" ou "USD" após um número em um cifrão (\$1) antes do número. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/how-numbers-med.html) | | Converter as palavras "libras" ou "miligramas" em "lbs" ou "mg", | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/how-numbers-med.html) | | Converter as palavras “rúpias”, “rúpias indianas” ou “INR” após um número no símbolo de rúpia (₹) antes do número. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/how-numbers-med.html) | | Converter horas em números. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/how-numbers-med.html) | | Combinar anos expressos como dois dígitos em quatro. Válido somente para os séculos 20, 21 e 22. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/how-numbers-med.html) | | Converter datas em números. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/how-numbers-med.html) | | Separar intervalos de números pela palavra "a". | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/how-numbers-med.html) | # Transcrever uma conversa médica Você pode usar o Amazon Transcribe Medical para transcrever uma conversa médica entre um médico e um paciente usando um trabalho de transcrição em lote ou uma transmissão em tempo real. Os trabalhos de transcrição em lote permitem que você transcreva arquivos de áudio. Para garantir que o Amazon Transcribe Medical produza resultados de transcrição com a maior precisão possível, você deve especificar a especialidade médica do médico em seu trabalho ou stream de transcrição. Você pode transcrever uma consulta médico-paciente nas seguintes especialidades médicas: + Cardiologia: disponível somente em transcrição de streaming. + Neurologia: disponível somente em transcrição de streaming. + Oncologia: disponível somente em transcrição de streaming. + Atenção primária, que inclui os seguintes tipos de prática médica: + Medicina de família + Medicina interna + Obstetrícia e ginecologia (OB-GYN) + Pediatria + Urologia: disponível apenas em transcrição de streaming. Você pode melhorar a precisão da transcrição usando vocabulários médicos personalizados. Para obter informações sobre como funcionam os vocabulários médicos personalizados, consulte [Melhorar a precisão da transcrição com vocabulários médicos personalizados](vocabulary-med.md). Por padrão, o Amazon Transcribe Medical retorna a transcrição com o maior nível de confiança. Se você quiser configurá-lo para retornar transcrições alternativas, consulte [Gerar transcrições alternativas](alternative-med-transcriptions.md). Para obter informações sobre como os números e as medidas médicas aparecem na saída da transcrição, consulte [Transcrever números](how-numbers-med.md) e [Transcrever medidas e termos médicos](how-measurements-med.md). **Topics** + [Transcrever um arquivo de áudio de uma conversa médica](batch-medical-conversation.md) + [Transcrever uma conversa médica em um fluxo em tempo real](streaming-medical-conversation.md) + [Habilitar a separação de locutores](conversation-diarization-med.md) + [Transcrever áudio multicanal](conversation-channel-id-med.md) # Transcrever um arquivo de áudio de uma conversa médica Use um trabalho de transcrição em lote para transcrever arquivos de áudio de conversas médicas. Você pode usar isso para transcrever um diálogo entre médico e paciente. Você pode iniciar um trabalho de transcrição em lote na API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html) ou no Console de gerenciamento da AWS. Ao iniciar um trabalho de transcrição médica com a API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), você especifica `PRIMARYCARE` como o valor do parâmetro `Specialty`. ## Console de gerenciamento da AWS **Transcrever um diálogo entre médico e paciente (Console de gerenciamento da AWS)** ****Para usar o Console de gerenciamento da AWS para transcrever um diálogo médico-paciente, crie um trabalho de transcrição e escolha Conversação como tipo de entrada de áudio.**** 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/). 1. No painel de navegação, em Amazon Transcribe Medicina, escolha Trabalhos de **transcrição**. 1. Escolha **Criar trabalho**. 1. Na página **Especificar os detalhes da tarefa**, em **Configurações de tarefa**, especifique as configurações a seguir. 1. **Nome**: o nome do trabalho de transcrição. 1. **Tipo de entrada de áudio**: **Conversa** 1. Para os campos restantes, especifique a Amazon S3 localização do seu arquivo de áudio e onde você deseja armazenar a saída do seu trabalho de transcrição. 1. Escolha **Próximo**. 1. Escolha **Criar**. ## solicitações de **Como transcrever uma conversa médica usando um trabalho de transcrição em lote (API)** + Para a API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), especifique o seguinte. 1. Para `MedicalTranscriptionJobName`, especifique um nome exclusivo em sua Conta da AWS. 1. Em `LanguageCode`, especifique o código do idioma falado no arquivo de mídia e o idioma do filtro de vocabulário. 1. Para o parâmetro `MediaFileUri` do objeto `Media`, especifique o nome do arquivo de áudio que você deseja transcrever. 1. Para `Specialty`, especifique a especialidade médica do médico que está se pronunciando no arquivo de áudio como `PRIMARYCARE`. 1. Em `Type`, especifique `CONVERSATION`. 1. Em `OutputBucketName`, especifique o bucket do Amazon S3 para armazenar os resultados da transcrição. A seguir está um exemplo de solicitação que usa o AWS SDK para Python (Boto3) para transcrever uma conversa médica entre um médico da `PRIMARYCARE` especialidade e um 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) ``` O código de exemplo a seguir mostra os resultados da transcrição de uma conversa entre médico e 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 **Como transcrever uma conversa médica usando um trabalho de transcrição em lote (AWS CLI)** + Execute o código a seguir. ``` aws transcribe start-medical-transcription-job \ --region us-west-2 \ --cli-input-json file://example-start-command.json ``` O código a seguir mostra o conteúdo 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" } ``` # Transcrever uma conversa médica em um fluxo em tempo real Você pode transcrever um stream de áudio de uma conversa médica usando o HTTP/2 ou os protocolos. [WebSocket ](https://tools.ietf.org/html/rfc6455) Para obter informações sobre como iniciar um stream usando o WebSocket protocolo, consulte[Configurando um WebSocket stream](streaming-setting-up.md#streaming-websocket). Para iniciar um fluxo HTTP/2, use a 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). Você pode transcrever o áudio de streaming nas seguintes especialidades médicas: + Cardiologia + Neurologia + Oncologia + Atenção primária + Urologia Cada especialidade médica inclui vários tipos de procedimentos e consultas. Portanto, os médicos ditam vários tipos diferentes de notas. Use os exemplos a seguir como orientação para ajudá-lo a especificar o valor do parâmetro `specialty` URI da WebSocket solicitação ou o `Specialty` parâmetro da [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 eletrofisiologia ou ecocardiografia, escolha `CARDIOLOGY`. + Para consultas de oncologia médica, oncologia cirúrgica ou oncologia por radiação, escolha `ONCOLOGY`. + Para um médico em consulta a um paciente que teve derrame, seja um ataque isquêmico transitório ou um ataque cerebrovascular, escolha `NEUROLOGY`. + Para uma consulta sobre incontinência urinária, escolha `UROLOGY`. + Para exames anuais ou consultas de atendimento urgente, escolha `PRIMARYCARE`. + Para consultas hospitalares com pacientes internados, escolha `PRIMARYCARE`. + Para consultas sobre fertilidade, laqueadura tubária, inserção de DIU ou aborto, escolha `PRIMARYCARE`. ## Console de gerenciamento da AWS **Como transcrever um streaming de conversa médica (Console de gerenciamento da AWS)** Para usar o Console de gerenciamento da AWS para transcrever um diálogo médico-paciente em uma transmissão em tempo real, escolha a opção de transcrever uma conversa médica, iniciar a transmissão e começar a falar no microfone. 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/). 1. No painel de navegação, em Amazon Transcribe Médico, escolha **Transcrição em tempo real**. 1. Escolha **Conversa**. 1. Em **Especialidade médica**, escolha a especialidade do médico. 1. Selecione **Start streaming** (Iniciar transmissão). 1. Fale pelo microfone. ## Transcrever uma conversa médica em um fluxo HTTP/2 Veja a seguir a sintaxe dos parâmetros de uma solicitação HTTP/2. Para transcrever um fluxo HTTP/2 de uma conversa médica, use a 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) e especifique o seguinte: + `LanguageCode`: o código do idioma. O valor válido é `en-US`. + `MediaEncoding`: a codificação usada para o áudio de entrada. Os valores válidos são `pcm`, `ogg-opus` e `flac`. + `Specialty`: a especialidade do profissional médico. + `Type` – `CONVERSATION` Para melhorar a precisão da transcrição de termos específicos em um fluxo em tempo real, use um vocabulário personalizado. Para habilitar um vocabulário personalizado, defina o valor do parâmetro `VocabularyName` como o nome do vocabulário personalizado que você deseja usar. Para obter mais informações, consulte [Melhorar a precisão da transcrição com vocabulários médicos personalizados](vocabulary-med.md). Para rotular a fala de diferentes locutores, defina o parâmetro `ShowSpeakerLabel` como `true`. Para obter mais informações, consulte [Habilitar a separação de locutores](conversation-diarization-med.md). Para obter mais informações sobre como configurar um fluxo HTTP/2 para transcrever uma conversa médica, consulte [Configurar um fluxo de HTTP/2](streaming-setting-up.md#streaming-http2). ## Transcrevendo uma conversa médica em um stream WebSocket Você pode usar uma WebSocket solicitação para transcrever uma conversa médica. Ao fazer uma WebSocket solicitação, você cria um URI pré-assinado. Esse URI contém as informações necessárias para configurar o fluxo de áudio entre a aplicação e o Amazon Transcribe Medical. Para obter mais informações sobre a criação WebSocket de solicitações, consulte[Configurando um WebSocket stream](streaming-setting-up.md#streaming-websocket). O modelo a seguir pode ser usado para criar seu URI pré-assinado. ``` 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 melhorar a precisão da transcrição de termos específicos em um fluxo em tempo real, use um vocabulário personalizado. Para habilitar um vocabulário personalizado, defina o valor de `vocabulary-name` como o nome do vocabulário personalizado que você deseja usar. Para obter mais informações, consulte [Melhorar a precisão da transcrição com vocabulários médicos personalizados](vocabulary-med.md). Para rotular a fala de diferentes locutores, defina o parâmetro `show-speaker-label` como `true`. Para obter mais informações, consulte [Habilitar a separação de locutores](conversation-diarization-med.md). Para obter mais informações sobre a criação de pré-assinados URIs, consulte[Configurando um WebSocket stream](streaming-setting-up.md#streaming-websocket). # Habilitar a separação de locutores Para habilitar o particionamento de alto-falantes no Amazon Transcribe Medical, use a diarização de *alto-falantes*. Isso permite que você veja o que o paciente disse e o que o médico disse na saída da transcrição. Quando você ativa a diarização do alto-falante, o Amazon Transcribe Medical rotula cada *enunciado* do alto-falante com um identificador exclusivo para cada alto-falante. Um *enunciado* é uma unidade de voz no canal de áudio que normalmente é separada de outras falas por um silêncio. Na transcrição em lote, um enunciado do médico poderia receber um rótulo `spk_0` e um enunciado do paciente poderia receber um rótulo `spk_1`. Se um enunciado de um locutor se sobrepuser a um enunciado de outro locutor, o Amazon Transcribe Medical os ordenará na transcrição com base nas horas de início. As falas que se sobrepõem no áudio de entrada não se sobrepõem na saída da transcrição. Você pode habilitar a diarização de locutores ao transcrever um arquivo de áudio usando o trabalho de transcrição em lote ou em um fluxo em tempo real. **Topics** + [Habilitar a separação de locutores em transcrições em lote](conversation-diarization-batch-med.md) + [Habilitar a separação de locutores em fluxos em tempo real](conversation-diarization-streaming-med.md) # Habilitar a separação de locutores em transcrições em lote Você pode habilitar a separação de locutores em um trabalho de transcrição em lote usando a API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html) ou o Console de gerenciamento da AWS. Isso permite que você divida o texto por locutor em uma conversa entre médico e paciente e determine quem disse o quê na saída da transcrição. ## Console de gerenciamento da AWS Para usar o para habilitar Console de gerenciamento da AWS a diarização do alto-falante em seu trabalho de transcrição, você ativa a identificação de áudio e, em seguida, o particionamento do alto-falante. 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/). 1. No painel de navegação, em Amazon Transcribe Medicina, escolha Trabalhos de **transcrição**. 1. Escolha **Criar trabalho**. 1. Na página **Especificar os detalhes da tarefa**, forneça informações sobre o trabalho de transcrição. 1. Escolha **Próximo**. 1. Ative a **Identificação de áudio**. 1. Em **Tipo de identificação de áudio**, escolha **Separação de oradores**. 1. Em **Número máximo de oradores**, insira o número máximo de locutores que você acha que estão falando no arquivo de áudio. 1. Escolha **Criar**. ## solicitações de **Para habilitar a separação de locutores usando um trabalho de transcrição em lote (API)** + Para a API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), especifique o seguinte. 1. Para `MedicalTranscriptionJobName`, especifique um nome que seja exclusivo em sua Conta da AWS. 1. Em `LanguageCode`, especifique o código do idioma que corresponde ao idioma falado no arquivo de áudio. 1. Para o parâmetro `MediaFileUri` do objeto `Media`, especifique o nome do arquivo de áudio que você deseja transcrever. 1. Em `Specialty`, indique a especialidade médica do médico que está se pronunciando no arquivo de áudio. 1. Em `Type`, especifique `CONVERSATION`. 1. Para`OutputBucketName`, especifique o Amazon S3 bucket para armazenar os resultados da transcrição. 1. Para o objeto `Settings`, especifique o seguinte: 1. `ShowSpeakerLabels` – `true`. 1. `MaxSpeakerLabels`: um número inteiro entre 2 e 10 para indicar o número de locutores que você acha que estão falando no áudio. A solicitação a seguir usa o AWS SDK para Python (Boto3) para iniciar um trabalho de transcrição em lote do diálogo com o paciente de um clínico primário com o particionamento de alto-falantes ativado. ``` 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) ``` O código de exemplo a seguir mostra os resultados de um trabalho de transcrição com a separação de locutores 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 **Como transcrever um arquivo de áudio de uma conversa entre um médico que atua na atenção primária e um paciente (AWS CLI)** + Execute o código a seguir. ``` aws transcribe start-transcription-job \ --region us-west-2 \ --cli-input-json file://example-start-command.json ``` O código a seguir mostra o conteúdo 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 a separação de locutores em fluxos em tempo real Para particionar os alto-falantes e rotular sua fala em um stream em tempo real, use o Console de gerenciamento da AWS ou uma solicitação de streaming. A separação de locutores funciona melhor para dois a cinco locutores em um fluxo. Embora o Amazon Transcribe Medical possa particionar mais de cinco alto-falantes em um stream, a precisão das partições diminui se você exceder esse número. Para iniciar uma solicitação HTTP/2, use a 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). Para iniciar uma WebSocket solicitação, use um URI pré-assinado. O URI contém as informações necessárias para configurar a comunicação bidirecional entre a aplicativo e o Amazon Transcribe Medical. ## Habilitar a separação de locutores no áudio que é transmitido por meio do microfone (Console de gerenciamento da AWS) Você pode usar o Console de gerenciamento da AWS para iniciar uma transmissão em tempo real de uma conversa médico-paciente ou um ditado que é falado em seu microfone em tempo real. 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/). 1. No painel de navegação, para Amazon Transcribe Medicina, escolha **Transcrição em tempo real**. 1. Em **Tipo de entrada de áudio**, escolha o tipo de fala médica que você deseja transcrever. 1. Em **Configurações adicionais**, escolha **Separação de oradores**. 1. Escolha **Iniciar streaming** para começar a transcrever o áudio em tempo real. 1. Fale pelo microfone. ## Habilitar a separação de locutores em um fluxo HTTP/2 Para habilitar a separação de locutores em um fluxo HTTP/2 de uma conversa médica, use a 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) e especifique o seguinte: + Em `LanguageCode`, especifique o código do idioma que corresponde ao idioma no fluxo. O valor válido é `en-US`. + Em `MediaSampleHertz`, especifique a taxa de amostragem do áudio. + Em `Specialty`, especifique a especialidade médica do profissional. + `ShowSpeakerLabel` – `true` Para obter mais informações sobre como configurar um fluxo HTTP/2 para transcrever uma conversa médica, consulte [Configurar um fluxo de HTTP/2](streaming-setting-up.md#streaming-http2). ## Ativando o particionamento de alto-falantes em uma solicitação WebSocket Para particionar alto-falantes em WebSocket streams com a API, use o formato a seguir para criar um URI pré-assinado para iniciar uma WebSocket solicitação e definir como`show-speaker-label`. `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 ``` O código a seguir mostra o exemplo de resposta truncada de uma solicitação 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 O Medical interrompe o fluxo de áudio de entrada com base em segmentos naturais da fala, como uma mudança no alto-falante ou uma pausa no áudio. A transcrição é retornada progressivamente para seu aplicativo, com cada resposta contendo mais fala transcrita até que todo o segmento seja transcrito. O código anterior é um exemplo truncado de um segmento de fala totalmente transcrito. Os rótulos dos locutores só aparecem para segmentos totalmente transcritos. A lista a seguir mostra a organização dos objetos e parâmetros em uma saída de transcrição de streaming. **`Transcript`** Cada segmento de fala tem seu próprio objeto `Transcript`. **`Results`** Cada objeto `Transcript` tem seu próprio objeto `Results`. Esse objeto contém o campo `isPartial`. Quando o valor é `false`, os resultados retornados referem-se a um segmento de fala inteiro. **`Alternatives`** Cada objeto `Results` tem um objeto `Alternatives`. **`Items`** Cada objeto `Alternatives` tem seu próprio objeto `Items`, que contém informações sobre cada palavra e sinal de pontuação na saída da transcrição. Quando você ativa o particionamento do alto-falante, cada palavra tem um `Speaker` rótulo para segmentos de fala totalmente transcritos. Amazon Transcribe O Medical usa esse rótulo para atribuir um número inteiro exclusivo a cada alto-falante no stream. O parâmetro `Type` que o valor `speaker-change` indica que uma pessoa parou de falar e que outra pessoa está prestes a começar. **`Transcript`** Cada objeto Items contém um segmento de fala transcrito como o valor do campo `Transcript`. Para obter mais informações sobre WebSocket solicitações, consulte[Configurando um WebSocket stream](streaming-setting-up.md#streaming-websocket). # Transcrever áudio multicanal Se você tiver um arquivo ou stream de áudio com vários canais, poderá usar a *identificação do canal* para transcrever a fala de cada um desses canais. Amazon Transcribe O médico transcreve o discurso de cada canal separadamente. Ele combina as transcrições separadas de cada canal em uma única saída de transcrição. Use a identificação de canal para distinguir os canais separados no áudio e transcrever a fala de cada um deles. Habilite esse recurso em situações que envolvam chamador e atendente. Use-o também para distinguir um chamador de um atendente em gravações ou fluxos das centrais de atendimento que realizam monitoramento de segurança de medicamentos. Você pode habilitar a identificação de canal para processamento em lote e streaming em tempo real. A lista a seguir descreve como habilitá-lo para cada método. + Transcrição em lote — Console de gerenciamento da AWS e API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html) + Transcrição de streaming — WebSocket streaming e 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) ## Transcrição de arquivos de áudio multicanal Quando você transcreve um arquivo de áudio, o Amazon Transcribe Medical retorna uma lista de *itens* para cada canal. Um item é uma palavra transcrita ou um sinal de pontuação. Cada palavra tem uma hora de início e uma hora de término. Se uma pessoa em um canal falar ao mesmo tempo que uma pessoa em um canal distinto, as horas de início e de término dos itens de cada canal vão se sobrepor enquanto a fala de ambas se sobrepuser. Por padrão, você pode transcrever arquivos de áudio com dois canais. Você pode solicitar um aumento de cota se precisar transcrever arquivos com mais de dois canais. Para obter mais informações sobre como solicitar um aumento de cota, consulte [AWS service (Serviço da AWS) quotas](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html). Para transcrever áudio multicanal em um trabalho de transcrição em lote, use o ou a Console de gerenciamento da AWS API. [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html) ### Console de gerenciamento da AWS Para usar o Console de gerenciamento da AWS para habilitar a identificação de canais em seu trabalho de transcrição em lote, você ativa a identificação de áudio e, em seguida, a identificação de canais. A identificação do canal é um subconjunto da identificação de áudio no Console de gerenciamento da AWS. 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/). 1. No painel de navegação, em Amazon Transcribe Medicina, escolha Trabalhos de **transcrição**. 1. Escolha **Criar trabalho**. 1. Na página **Especificar os detalhes da tarefa**, forneça informações sobre o trabalho de transcrição. 1. Escolha **Próximo**. 1. Ative a **Identificação de áudio**. 1. Em **Tipo de identificação de áudio**, escolha **Identificação de canal**. 1. Escolha **Criar**. ### solicitações de **Como transcrever um arquivo de áudio multicanal (API)** + Para a API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), especifique o seguinte. 1. Em `TranscriptionJobName`, especifique um nome exclusivo para sua Conta da AWS. 1. Em `LanguageCode`, especifique o código do idioma que corresponde ao idioma falado no arquivo de áudio. O valor válido é `en-US`. 1. No parâmetro `MediaFileUri` do objeto `Media`, especifique o nome do arquivo de mídia a ser transcrito. 1. Para o objeto `Settings`, defina `ChannelIdentification` como `true`. Veja a seguir uma solicitação do AWS SDK para Python (Boto3) de exemplo. ``` 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 **Como transcrever um arquivo de áudio multicanal usando um trabalho de transcrição em lote (AWS CLI)** + Execute o código a seguir. ``` aws transcribe start-medical-transcription-job \ --region us-west-2 \ --cli-input-json file://example-start-command.json ``` O código a seguir é do arquivo `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 } } ``` O código a seguir mostra a saída da transcrição de um arquivo de áudio que tem uma conversa em dois canais. ``` { "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" }, ... ] } } ``` ## Transcrever fluxos de áudio multicanal Você pode transcrever áudio de canais separados em HTTP/2 ou WebSocket streams usando a 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) Por padrão, você pode transcrever transmissões com dois canais. Você pode solicitar um aumento de cota se precisar transcrever transmissões que tenham mais de dois canais. Para obter mais informações sobre como solicitar um aumento de cota, consulte [AWS service quotas](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html). ### Transcrever áudio multicanal em um fluxo HTTP/2 Para transcrever áudio multicanal em um stream HTTP/2, use a [StartMedicalStreamTranscription](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html)API e especifique o seguinte: + `LanguageCode`: o código de idioma do áudio a ser selecionado. O valor válido é `en-US`. + `MediaEncoding`: a codificação do áudio. Os valores válidos são `ogg-opus`, `flac` e `pcm`. + `EnableChannelIdentification` – `true` + `NumberOfChannels`: o número de canais no streaming de áudio. Para obter mais informações sobre como configurar um fluxo HTTP/2 para transcrever uma conversa médica, consulte [Configurar um fluxo de HTTP/2](streaming-setting-up.md#streaming-http2). ### Transcrevendo áudio multicanal em um stream WebSocket Para particionar alto-falantes em WebSocket streams, use o formato a seguir para criar um URI pré-assinado e iniciar uma WebSocket solicitação. Especifique `enable-channel-identification` como `true` e o número de canais no fluxo em `number-of-channels`. Um URI pré-assinado contém as informações necessárias para configurar a comunicação bidirecional entre seu aplicativo e o 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 ``` As definições de parâmetros podem ser encontradas na [Referência da API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html); os parâmetros comuns a todas as operações AWS da API estão listados na seção [Parâmetros comuns](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html). Para obter mais informações sobre WebSocket solicitações, consulte[Configurando um WebSocket stream](streaming-setting-up.md#streaming-websocket). ### Saída de streaming multicanal A saída de uma transcrição de streaming é a mesma para HTTP/2 e solicitações. WebSocket Veja a seguir um exemplo de saída. ``` { "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 fala, há um sinalizador `channelId`, que indica a qual canal a fala pertence. # Transcrever um ditado médico Você pode usar o Amazon Transcribe Medical para transcrever anotações médicas ditadas por médicos usando um trabalho de transcrição em lote ou uma transmissão em tempo real. Os trabalhos de transcrição em lote permitem que você transcreva arquivos de áudio. Você especifica a especialidade médica do médico em seu trabalho ou stream de transcrição para garantir que o Amazon Transcribe Medical produza resultados de transcrição com a maior precisão possível. Você pode transcrever um ditado médico nas seguintes especialidades: + Cardiologia: disponível somente em transcrição de streaming. + Neurologia: disponível somente em transcrição de streaming. + Oncologia: disponível somente em transcrição de streaming. + Atenção primária, que inclui os seguintes tipos de prática médica: + Medicina de família + Medicina interna + Obstetrícia e ginecologia (OB-GYN) + Pediatria + Radiologia: disponível somente em transcrição de streaming. + Urologia: disponível apenas em transcrição de streaming. Você pode melhorar a precisão da transcrição usando vocabulários personalizados. Para obter informações sobre como funcionam os vocabulários médicos personalizados, consulte [Melhorar a precisão da transcrição com vocabulários médicos personalizados](vocabulary-med.md). Por padrão, o Amazon Transcribe Medical retorna a transcrição com o maior nível de confiança. Se você quiser configurá-lo para retornar transcrições alternativas, consulte [Gerar transcrições alternativas](alternative-med-transcriptions.md). Para obter informações sobre como os números e as medidas médicas aparecem na saída da transcrição, consulte [Transcrever números](how-numbers-med.md) e [Transcrever medidas e termos médicos](how-measurements-med.md). **Topics** + [Transcrever um arquivo de áudio de um ditado médico](batch-medical-dictation.md) + [Transcrever um ditado médico em um fluxo em tempo real](streaming-medical-dictation.md) # Transcrever um arquivo de áudio de um ditado médico Use um trabalho de transcrição em lote para transcrever arquivos de áudio de conversas médicas. Você pode usar isso para transcrever um diálogo entre médico e paciente. Você pode iniciar um trabalho de transcrição em lote na API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html) ou no Console de gerenciamento da AWS. Ao iniciar um trabalho de transcrição médica com a API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), você especifica `PRIMARYCARE` como o valor do parâmetro `Specialty`. ## Console de gerenciamento da AWS **Transcrever um diálogo entre médico e paciente (Console de gerenciamento da AWS)** ****Para usar o Console de gerenciamento da AWS para transcrever um diálogo médico-paciente, crie um trabalho de transcrição e escolha Conversação como tipo de entrada de áudio.**** 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/). 1. No painel de navegação, em Amazon Transcribe Medicina, escolha Trabalhos de **transcrição**. 1. Escolha **Criar trabalho**. 1. Na página **Especificar os detalhes da tarefa**, em **Configurações de tarefa**, especifique as configurações a seguir. 1. **Nome**: o nome do trabalho de transcrição. 1. **Tipo de entrada de áudio**: **Ditado** 1. Para os campos restantes, especifique a Amazon S3 localização do seu arquivo de áudio e onde você deseja armazenar a saída do seu trabalho de transcrição. 1. Escolha **Próximo**. 1. Escolha **Criar**. ## solicitações de **Como transcrever uma conversa médica usando um trabalho de transcrição em lote (API)** + Para a API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), especifique o seguinte. 1. Para `MedicalTranscriptionJobName`, especifique um nome exclusivo em sua Conta da AWS. 1. Em `LanguageCode`, especifique o código do idioma falado no arquivo de mídia e o idioma do filtro de vocabulário. 1. No parâmetro `MediaFileUri` do objeto `Media`, especifique o nome do arquivo de áudio que você deseja transcrever. 1. Em `Specialty`, indique a especialidade médica do médico que está se pronunciando no arquivo de áudio. 1. Em `Type`, especifique `DICTATION`. 1. Em `OutputBucketName`, especifique o bucket do Amazon S3 para armazenar os resultados da transcrição. A seguir está um exemplo de solicitação que usa o AWS SDK para Python (Boto3) para transcrever um ditado médico de um médico da especialidade. `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) ``` O código de exemplo a seguir mostra os resultados da transcrição de um ditado 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 **Como habilitar a separação de oradores (locutores) em um trabalho de transcrição em lote (AWS CLI)** + Execute o código a seguir. ``` aws transcribe start-medical-transcription-job \ --region us-west-2 \ --cli-input-json file://example-start-command.json ``` O código a seguir mostra o conteúdo 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" } ``` # Transcrever um ditado médico em um fluxo em tempo real Use um WebSocket stream para transcrever um ditado médico como um stream de áudio. Você também pode usar o Console de gerenciamento da AWS para transcrever a fala que você ou outras pessoas falam diretamente em um microfone. Para um HTTP/2 ou um WebSocket stream, você pode transcrever áudio nas seguintes especialidades médicas: + Cardiologia + Oncologia + Neurologia + Atenção primária + Radiologia + Urologia Cada especialidade médica inclui vários tipos de procedimentos e consultas. Portanto, os médicos ditam vários tipos diferentes de notas. Use os exemplos a seguir como orientação para ajudá-lo a especificar o valor do parâmetro `specialty` URI da WebSocket solicitação ou o `Specialty` parâmetro da [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 um ditado após o procedimento de eletrofisiologia ou ecocardiograma, escolha `CARDIOLOGY`. + Para um ditado após um procedimento cirúrgico de oncologia ou oncologia por radiação, escolha `ONCOLOGY`. + Para um médico que está ditando notas referentes a um diagnóstico de encefalite, escolha `NEUROLOGY`. + Para ditar notas de procedimento para quebrar uma pedra na bexiga, escolha `UROLOGY`. + Para um ditado de notas clínicas após uma consulta de medicina interna, escolha `PRIMARYCARE`. + Para um ditado de um médico que está comunicando os resultados de uma tomografia computadorizada, PET, ressonância magnética ou radiografia, escolha `RADIOLOGY`. + Para um ditado de notas médicas após uma consulta de ginecologia, escolha `PRIMARYCARE`. Para melhorar a precisão da transcrição de termos específicos em um fluxo em tempo real, use um vocabulário personalizado. Para habilitar um vocabulário personalizado, defina o valor de `vocabulary-name` como o nome do vocabulário personalizado que você deseja usar. ## Transcrevendo um ditado falado em seu microfone com o Console de gerenciamento da AWS Para usar o Console de gerenciamento da AWS para transcrever o streaming de áudio de um ditado médico, escolha a opção de transcrever um ditado médico, iniciar a transmissão e começar a falar no microfone. **Como transcrever o streaming de áudio de um ditado médico (Console de gerenciamento da AWS)** 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/). 1. No painel de navegação, em Amazon Transcribe Médico, escolha **Transcrição em tempo real**. 1. Escolha **Ditado.** 1. Em **Especialidade médica**, escolha a especialidade médica do médico que está se pronunciando no fluxo. 1. Selecione **Start streaming** (Iniciar transmissão). 1. Fale pelo microfone. ## Transcrever um ditado em um fluxo HTTP/2 Para transcrever um fluxo HTTP/2 de um ditado médico, use a 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) e especifique o seguinte: + `LanguageCode`: o código do idioma. O valor válido é `en-US`. + `MediaEncoding`: a codificação usada para o áudio de entrada. Os valores válidos são `pcm`, `ogg-opus` e `flac`. + `Specialty`: a especialidade do profissional médico. + `Type` – `DICTATION` Para obter mais informações sobre a configuração de um fluxo HTTP/2 para transcrever um ditado médico, consulte [Configurar um fluxo de HTTP/2](streaming-setting-up.md#streaming-http2). ## Usando uma solicitação WebSocket de streaming para transcrever um ditado médico Para transcrever um ditado médico em um stream em tempo real usando uma WebSocket solicitação, você cria um URI pré-assinado. Esse URI contém as informações necessárias para configurar o fluxo de áudio entre seu aplicativo e o Amazon Transcribe Medical. Para obter mais informações sobre a criação WebSocket de solicitações, consulte[Configurando um WebSocket stream](streaming-setting-up.md#streaming-websocket). O modelo a seguir pode ser usado para criar seu URI pré-assinado. ``` 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 obter mais informações sobre a criação de pré-assinados URIs, consulte[Configurando um WebSocket stream](streaming-setting-up.md#streaming-websocket). # Melhorar a precisão da transcrição com vocabulários médicos personalizados Para melhorar a precisão da transcrição em Amazon Transcribe Medicina, crie e use um ou mais vocabulários médicos personalizados. Um *vocabulário personalizado* é um conjunto de palavras ou frases específicas de um domínio. Esta coleção ajuda a melhorar o desempenho da Amazon Transcribe Medicina na transcrição dessas palavras ou frases. Você é responsável pela integridade de seus próprios dados ao usar o Amazon Transcribe Medical. Não insira informações confidenciais, informações de identificação pessoal (PII) ou informações de saúde protegidas (PHI) em um vocabulário personalizado. Para obter melhores resultados, crie pequenos vocabulários personalizados separados para ajudar a transcrever uma gravação de áudio específica. Você obtém melhorias mais significativas na precisão da transcrição do que se tivesse criado um vocabulário personalizado extenso para usar com todas as gravações. Por padrão, você pode ter até 100 vocabulários personalizados em seu Conta da AWS. Um vocabulário personalizado não pode exceder 50 KB de tamanho. Para obter informações sobre como solicitar um aumento no número de vocabulários personalizados que você pode ter em seu Conta da AWS, consulte cotas de [AWS serviço](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html). Os vocabulários personalizados estão disponíveis em inglês dos EUA (en-US). **Topics** + [Criar um arquivo de texto para um vocabulário médico personalizado](create-med-vocab-text.md) + [Usar um arquivo de texto para criar um vocabulário médico personalizado](create-med-custom-vocabulary.md) + [Transcrever um arquivo de áudio usando um vocabulário médico personalizado](start-med-custom-vocab-job.md) + [Transcrever um fluxo em tempo real usando um vocabulário médico personalizado](start-med-vocab-stream.md) + [Conjunto de caracteres para Amazon Transcribe Medicina](charsets-med.md) # Criar um arquivo de texto para um vocabulário médico personalizado Para criar um vocabulário personalizado, você cria um arquivo de texto no formato UTF-8. Nesse arquivo, você cria uma tabela de quatro colunas, cada uma especificando um campo. Cada campo informa ao Amazon Transcribe Medical como os termos específicos do domínio são pronunciados ou como exibi-los em suas transcrições. Você armazena o arquivo de texto contendo esses campos em um bucket do Amazon S3 . ## Como formatar seu arquivo de texto Para criar um vocabulário médico personalizado, você insere os nomes das colunas como uma linha de cabeçalho. Você insere os valores de cada coluna abaixo da linha do cabeçalho. Veja os nomes das quatro colunas da tabela: + `Phrase`: coluna obrigatória, valores obrigatórios + `IPA`: coluna obrigatória, os valores podem ser opcionais. + `SoundsLike`: coluna obrigatória, os valores podem ser opcionais. + `DisplayAs`: coluna obrigatória, os valores podem ser opcionais. Ao criar um vocabulário personalizado, você deve: + Separe cada coluna com um único caractere Tab. Amazon Transcribe lançará uma mensagem de erro se você tentar separar as colunas com espaços ou vários caracteres Tab. + Garantir que não haja espaços à direita ou espaços em branco após cada valor em uma coluna. Garanta que os valores inseridos para cada coluna: + Tenham menos de 256 caracteres, incluindo hifens + Usem somente caracteres do conjunto de caracteres permitido. Consulte [Conjunto de caracteres para Amazon Transcribe Medicina](charsets-med.md). ## Inserir valores para as colunas da tabela As seguintes informações mostram como especificar valores para as quatro colunas da tabela: + `Phrase`: a palavra ou frase que deve ser reconhecida. Você deve inserir valores nesta coluna. Se a entrada for uma frase, separe as palavras com um hífen (-). Por exemplo, insira **cerebral autosomal dominant arteriopathy with subcortical infarcts and leukoencephalopathy** como **cerebral-autosomal-dominant-arteriopathy-with-subcortical-infarcts-and-leukoencephalopathy**. Insira os acrônimos ou outras palavras cujas letras devem ser pronunciadas individualmente como letras únicas seguidas por pontos, como **D.N.A.** ou **S.T.E.M.I.**. Para inserir a forma plural de um acrônimo, como "STEMIs”, separe o “s” do acrônimo com um hífen: "**S.T.E.M.I-s**" Você pode usar letras maiúsculas ou minúsculas para acrônimos. A coluna `Phrase` é obrigatória. Você pode usar qualquer um dos caracteres permitidos para o idioma de entrada. Para caracteres permitidos, consulte [Conjunto de caracteres para Amazon Transcribe Medicina](charsets-med.md). Se você não especificar a `DisplayAs` coluna, o Amazon Transcribe Medical usará o conteúdo da `Phrase` coluna no arquivo de saída. + `IPA` (coluna obrigatória, os valores podem ser opcionais): para especificar a pronúncia de uma palavra ou frase, você pode incluir caracteres do [Alfabeto Fonético Internacional (IPA)](https://en.wikipedia.org/wiki/International_Phonetic_Alphabet) nessa coluna. A coluna `IPA` não pode conter espaços no início nem no final, e você deve usar um único espaço para separar cada fonema na entrada. Por exemplo, em inglês, a expressão **acute-respiratory-distress-syndrome** seria inserida como **ə k j u t ɹ ɛ s p ɪ ɹ ə t ɔ ɹ i d ɪ s t ɹ ɛ s s ɪ n d ɹ oʊ m**. A expressão **A.L.L.** seria inserida como **eɪ ɛ l ɛ l**. Mesmo que não especifique o conteúdo da coluna `IPA`, você deve incluir uma coluna `IPA` em branco. Se você incluir valores na coluna `IPA`, não poderá fornecer valores para a coluna `SoundsLike`. Para obter uma lista de caracteres IPA permitidos para um idioma específico, consulte [Conjunto de caracteres para Amazon Transcribe Medicina](charsets-med.md). O inglês americano é o único idioma disponível em Amazon Transcribe Medicina. + `SoundsLike` (coluna obrigatória, os valores podem ser opcionais): você pode dividir uma palavra ou frase em segmentos menores e fornecer uma pronúncia para cada segmento usando a ortografia padrão do idioma para imitar o som da palavra. Por exemplo, em inglês, você pode fornecer dicas de pronúncia para a expressão **cerebral-autosomal-dominant-arteriopathy-with-subcortical-infarcts-and-leukoencephalopathy** desta forma: **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**. A dica para a expressão **atrioventricular-nodal-reentrant-tachycardia** seria assim: **ay-tree-o-ven-trick-u-lar-node-al-re-entr-ant-tack-ih-card-ia**. Você separa cada parte da dica com um hífen (-). Mesmo que não forneça valores para a coluna `SoundsLike`, você deve incluir uma coluna `SoundsLike` em branco. Se você incluir valores na coluna `SoundsLike`, não poderá fornecer valores para a coluna `IPA`. Você pode usar qualquer um dos caracteres permitidos para o idioma de entrada. Para obter uma lista de caracteres permitidos, consulte [Conjunto de caracteres para Amazon Transcribe Medicina](charsets-med.md). + `DisplayAs` (coluna obrigatória, os valores podem ser opcionais): define a aparência da palavra ou frase na saída. Por exemplo, se a palavra ou expressão for **cerebral-autosomal-dominant-arteriopathy-with-subcortical-infarcts-and-leukoencephalopathy**, você poderá especificar a forma de exibição como `cerebral autosomal dominant arteriopathy with subcortical infarcts and leukoencephalopathy`, para que o hífen não esteja presente. Você também poderá especificar `DisplayAs` como `CADASIL` se desejar mostrar o acrônimo em vez do termo completo na saída. Se você não especificar a `DisplayAs` coluna, o Amazon Transcribe Medical usará a `Phrase` coluna do arquivo de entrada na saída. Você pode usar qualquer caractere UTF-8 na coluna `DisplayAs`. Você pode incluir espaços apenas para os valores nas colunas `IPA` e `DisplayAs`. Para criar o arquivo de texto do vocabulário personalizado, coloque cada palavra ou frase no arquivo de texto em uma linha separada. Separe as colunas com caracteres de tabulação. Inclua espaços somente para valores nas colunas `IPA` e `DisplayAs`. Salve o arquivo com a extensão `.txt` em um Amazon S3 bucket no mesmo Região da AWS local em que você usa o Amazon Transcribe Medical para criar seu vocabulário personalizado. Se você editar o arquivo de texto no Windows, certifique-se de que seu arquivo esteja no formato `LF` e não no formato `CRLF`. Caso contrário, você não poderá criar seu vocabulário personalizado. Alguns editores de texto permitem alterar a formatação com os comandos Find (Localizar) e Replace (Substituir). Os exemplos a seguir mostram o texto que você pode usar para criar vocabulários personalizados. Para criar um vocabulário personalizado a partir destes exemplos, copie um exemplo em um editor de texto, substitua `[TAB]` por um caractere de tabulação e carregue o arquivo de texto salvo no 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] ``` Você pode inserir colunas em qualquer ordem. Os exemplos a seguir mostram outras estruturas válidas para o arquivo de entrada de vocabulário 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 a leitura, as tabelas a seguir mostram os exemplos anteriores mais claramente no formato html. O objetivo é apenas ilustrar os exemplos. | 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 um arquivo de texto para criar um vocabulário médico personalizado Para criar um vocabulário personalizado, você deve ter preparado um arquivo de texto que contenha uma coleção de palavras ou frases. Amazon Transcribe O Medical usa esse arquivo de texto para criar um vocabulário personalizado que você pode usar para melhorar a precisão da transcrição dessas palavras ou frases. Você pode criar um vocabulário personalizado usando a [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html)API ou o console Amazon Transcribe médico. ## Console de gerenciamento da AWS Para usar o Console de gerenciamento da AWS para criar um vocabulário personalizado, você fornece o Amazon S3 URI do arquivo de texto contendo suas palavras ou frases. 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/). 1. No painel de navegação, em Amazon Transcribe Médico, escolha **Vocabulário personalizado**. 1. Em **Nome**, em **Configurações de vocabulário**, escolha um nome para o vocabulário personalizado. 1. Especifique a localização do arquivo de áudio ou arquivo de vídeo no Amazon S3: + Em **Local do arquivo de entrada de vocabulário no S3**, em **Configurações de vocabulário**, especifique o URI do Amazon S3 que identifica o arquivo de texto que você usará para criar o vocabulário personalizado. + Em **Local do arquivo de entrada de vocabulário no S3**, escolha **Procurar no S3** para procurar o arquivo de texto e escolhê-lo. 1. Selecione **Criar vocabulário**. Você pode ver o status de processamento do vocabulário personalizado no Console de gerenciamento da AWS. ## solicitações de **Como criar um vocabulário médico personalizado (API)** + Para a API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html), especifique o seguinte. 1. Em `LanguageCode`, especifique `en-US`. 1. Para`VocabularyFileUri`, especifique a Amazon S3 localização do arquivo de texto que você usa para definir seu vocabulário personalizado. 1. Em `VocabularyName`, especifique um nome para o vocabulário personalizado. O nome que você especificar deve ser exclusivo em seu Conta da AWS. Para ver o status de processamento do vocabulário personalizado, use a API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetMedicalVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetMedicalVocabulary.html). Veja a seguir um exemplo de solicitação usando o AWS SDK para Python (Boto3) para criar um vocabulário 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 **Como habilitar a separação de oradores (locutores) em um trabalho de transcrição em lote (AWS CLI)** + Execute o código a seguir. ``` 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 ``` # Transcrever um arquivo de áudio usando um vocabulário médico personalizado Use o [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html)ou o Console de gerenciamento da AWS para iniciar um trabalho de transcrição que usa um vocabulário personalizado para melhorar a precisão da transcrição. ## Console de gerenciamento da AWS 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/). 1. No painel de navegação, em Amazon Transcribe Medicina, escolha Trabalhos de **transcrição**. 1. Escolha **Criar trabalho**. 1. Na página **Especificar os detalhes da tarefa**, forneça informações sobre o trabalho de transcrição. 1. Escolha **Próximo**. 1. Em **Personalização**, habilite **Vocabulário personalizado**. 1. Em **Seleção de vocabulário**, escolha um vocabulário personalizado. 1. Escolha **Criar**. ## solicitações de **Como habilitar a separação de locutores em um arquivo de áudio usando um trabalho de transcrição em lote (API)** + Para a API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), especifique o seguinte. 1. Para `MedicalTranscriptionJobName`, especifique um nome que seja exclusivo em sua Conta da AWS. 1. Em `LanguageCode`, especifique o código do idioma falado no arquivo de mídia e o idioma do filtro de vocabulário. 1. Para o parâmetro `MediaFileUri` do objeto `Media`, especifique o nome do arquivo de áudio que você deseja transcrever. 1. Em `Specialty`, indique a especialidade médica do médico que está se pronunciando no arquivo de áudio. 1. Em `Type`, especifique se o arquivo de áudio é uma conversa ou um ditado. 1. Em `OutputBucketName`, especifique o bucket do Amazon S3 para armazenar os resultados da transcrição. 1. Para o objeto `Settings`, especifique o seguinte: 1. `VocabularyName`: o nome do vocabulário personalizado. A solicitação a seguir usa o AWS SDK para Python (Boto3) para iniciar um trabalho de transcrição em lote com um vocabulário 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) ``` # Transcrever um fluxo em tempo real usando um vocabulário médico personalizado Para melhorar a precisão da transcrição em um stream em tempo real, você pode usar um vocabulário personalizado usando HTTP/2 ou streams. WebSocket Para iniciar uma solicitação HTTP/2, use a 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). Você pode usar um vocabulário personalizado em tempo real usando a [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalStreamTranscription.html)API ou usando o WebSocket protocolo. Console de gerenciamento da AWS ## Transcrever um ditado proferido por meio do microfone (Console de gerenciamento da AWS) Para usar o Console de gerenciamento da AWS para transcrever o streaming de áudio de um ditado médico, escolha a opção de transcrever um ditado médico, iniciar a transmissão e começar a falar no microfone. **Como transcrever o streaming de áudio de um ditado médico (Console de gerenciamento da AWS)** 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/). 1. No painel de navegação, em Amazon Transcribe Médico, escolha **Transcrição em tempo real**. 1. Em **Especialidade médica**, escolha a especialidade médica do médico que está se pronunciando no fluxo. 1. Em **Tipo de entrada de áudio**, escolha **Conversa** ou **Ditado**. 1. Em **Configurações adicionais**, escolha **Vocabulário personalizado**. 1. Em **Seleção de vocabulário**, escolha o vocabulário personalizado. 1. Selecione **Start streaming** (Iniciar transmissão). 1. Fale pelo microfone. ## Habilitar a separação de locutores em um fluxo HTTP/2 Veja a seguir a sintaxe dos parâmetros de uma solicitação 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 ``` Descrições dos parâmetros: + **host**: atualize o Região da AWS ('us-west-2' no exemplo anterior) com Região da AWS o que você está chamando. Para obter uma lista de pontos finais válidos Regiões da AWS, consulte [Regiões da AWS Endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html#transcribe_region). + **authorization**: esse é um campo gerado. Para saber mais sobre como criar uma assinatura, consulte [Assinando AWS solicitações com o Signature versão 4](https://docs.aws.amazon.com/general/latest/gr/sigv4_signing.html). + **x-amz-target**: não altere esse campo; use o conteúdo mostrado no exemplo anterior. + **x-amz-content-sha256**: Esse é um campo gerado. Para saber mais sobre o cálculo de uma assinatura, consulte [Assinando AWS solicitações com o Signature versão 4](https://docs.aws.amazon.com/general/latest/gr/sigv4_signing.html). + **x-amz-date**: a data e a hora em que a assinatura foi criada. O formato é YYYYMMDDTHHMMSSZ, onde YYYY = ano, mm = mês, DD = dia, HH = hora, MM = minuto, SS = segundos e “T” e “Z” são caracteres fixos. Para obter mais informações, consulte [Handling Dates in Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/sigv4-date-handling.html). + **x-amzn-transcribe-session-id**: o nome da sua sessão de streaming. + **x-amzn-transcribe-language-code**: a codificação usada para o áudio 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) ou [Idiomas oferecidos e recursos específicos do idioma](supported-languages.md) para obter uma lista de valores válidos. + **x-amzn-transcribe-media-encoding**: a codificação usada para o áudio de entrada. Os valores válidos são `pcm`, `ogg-opus` e `flac`. + **x-amzn-transcribe-sample-rate**: A taxa de amostragem do áudio de entrada (em Hertz). Amazon Transcribe suporta uma faixa de 8.000 Hz a 48.000 Hz. O áudio de baixa qualidade, como o áudio telefônico, normalmente gira em torno de 8.000 Hz. Áudio de alta qualidade normalmente varia de 16.000 Hz a 48.000 Hz. Observe que a taxa de amostragem especificada **deve** corresponder à do áudio. + **x-amzn-transcribe-vocabulary-name**: o nome do vocabulário que você deseja usar com sua transcrição. + **x-amzn-transcribe-specialty**: A especialidade médica que está sendo transcrita. + **x-amzn-transcribe-type**: escolha se isso é um ditado ou uma conversa. + **x-amzn-transcribe-show-speaker-label**: para habilitar a diarização, esse valor deve ser. `true` + **content-type**: não altere esse campo; use o conteúdo mostrado no exemplo anterior. ## Ativando o particionamento de alto-falantes em uma solicitação WebSocket Para particionar alto-falantes em WebSocket streams com a API, use o formato a seguir para criar um URI pré-assinado para iniciar uma WebSocket solicitação e `vocabulary-name` definir o nome do vocabulário 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 ``` # Conjunto de caracteres para Amazon Transcribe Medicina Para usar vocabulários personalizados em Amazon Transcribe Medicina, use o seguinte conjunto de caracteres. ## Conjunto de caracteres em inglês Para vocabulários personalizados em inglês, você pode usar os seguintes caracteres nas colunas `Phrase` e `SoundsLike`: + a - z + A - Z + ' (apóstrofo) + - (hífen) + . (ponto final) Você pode usar os caracteres do Alfabeto Fonético Internacional (IPA) a seguir no campo `IPA` do arquivo de entrada de vocabulário: | Caractere | Código | Caractere | 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 | # Identificar informações de saúde pessoais (PHI) em uma transcrição Use a *Identificação de informações pessoais de saúde* para rotular informações de saúde pessoais (PHI) nos resultados da transcrição. Ao revisar os rótulos, você pode encontrar PHI que podem ser usadas para identificar um paciente. Você pode identificar PHI usando um fluxo em tempo real ou um trabalho de transcrição em lote. Você pode usar seu próprio pós-processamento para editar PHIs identificadas na saída da transcrição. Use a Identificação de informações de saúde pessoais para identificar os seguintes tipos de PHI: + PHI pessoal: + Nomes: nome completo ou sobrenome e inicial + Gender + Idade + Números de telefone + Datas (não incluindo o ano) que se relacionam diretamente com o paciente + Endereços de e-mail + PHI geográficas: + Endereço físico + Código postal + Nome do centro médico ou consultório + PHI da conta: + Números de fax + Números de previdência social (SSNs) + Números de beneficiários do plano de saúde + Números de conta + Números de certificados ou licenças + PHI de veículo: + Número de identificação de veículo (VIN) + Número da placa + Outro tipo de PHI: + Localização uniforme de recursos na web (URL) + Números de endereço IP (protocolo de internet) Amazon Transcribe Medical é um serviço elegível para a Lei de Portabilidade e Responsabilidade de Seguros de Saúde de 1996 (HIPAA). Para obter mais informações, consulte [Amazon Transcribe Medical](transcribe-medical.md). Para obter informações sobre como identificar PHI em um arquivo de áudio, consulte [Identificar PHI em um arquivo de áudio](phi-id-batch.md). Para obter informações sobre como identificar PHI em um fluxo, consulte [Identificar PHI em um fluxo em tempo real](phi-id-stream.md). **Topics** + [Identificar PHI em um arquivo de áudio](phi-id-batch.md) + [Identificar PHI em um fluxo em tempo real](phi-id-stream.md) # Identificar PHI em um arquivo de áudio Use um trabalho de transcrição em lote para transcrever arquivos de áudio e identificar as informações de saúde pessoais (PHI) contidas neles. Quando você ativa a Identificação de Informações Pessoais de Saúde (PHI), o Amazon Transcribe Medical rotula a PHI identificada nos resultados da transcrição. Para obter informações sobre a PHI que a Amazon Transcribe Medical pode identificar, consulte[Identificar informações de saúde pessoais (PHI) em uma transcrição](phi-id.md). Você pode iniciar um trabalho de transcrição em lote usando a API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html) ou o Console de gerenciamento da AWS. ## Console de gerenciamento da AWS ****Para usar o Console de gerenciamento da AWS para transcrever um diálogo médico-paciente, crie um trabalho de transcrição e escolha Conversação como tipo de entrada de áudio.**** **Como transcrever um arquivo de áudio e identificar PHI (Console de gerenciamento da AWS)** 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/). 1. No painel de navegação, em Amazon Transcribe Medicina, escolha Trabalhos de **transcrição**. 1. Escolha **Criar trabalho**. 1. Na página **Especificar os detalhes da tarefa**, em **Configurações de tarefa**, especifique as configurações a seguir. 1. **Nome** — O nome do trabalho de transcrição que é exclusivo para você Conta da AWS. 1. **Tipo de entrada de áudio**: **Conversa** ou **Ditado**. 1. Para os campos restantes, especifique a Amazon S3 localização do seu arquivo de áudio e onde você deseja armazenar a saída do seu trabalho de transcrição. 1. Escolha **Próximo**. 1. Em **Configurações de áudio**, escolha **Identificação de PHI**. 1. Escolha **Criar**. ## solicitações de **Como transcrever um arquivo de áudio e identificar PHI usando um trabalho de transcrição em lote (API)** + Para a API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), especifique o seguinte. 1. Para `MedicalTranscriptionJobName`, especifique um nome que seja exclusivo de sua Conta da AWS. 1. Em `LanguageCode`, especifique o código do idioma que corresponde ao idioma falado no arquivo de áudio. 1. Para o parâmetro `MediaFileUri` do objeto `Media`, especifique o nome do arquivo de áudio que você deseja transcrever. 1. Para `Specialty`, especifique a especialidade médica do médico que está se pronunciando no arquivo de áudio como `PRIMARYCARE`. 1. Para o `Type`, especifique `CONVERSATION` ou `DICTATION`. 1. Em `OutputBucketName`, especifique o bucket do Amazon S3 onde você deseja armazenar os resultados da transcrição. A seguir está um exemplo de solicitação que usa o AWS SDK para Python (Boto3) para transcrever um arquivo de áudio e identificar a PHI de um 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) ``` O código de exemplo a seguir mostra os resultados da transcrição com as PHIs do paciente identificadas. ``` { "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 **Como transcrever um arquivo de áudio e identificar PHI usando um trabalho de transcrição em lote (AWS CLI)** + Execute o código a seguir. ``` 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 PHI em um fluxo em tempo real Você pode identificar Informações Pessoais de Saúde (PHI) em HTTP/2 ou em streams. WebSocket Quando você ativa a Identificação PHI, o Amazon Transcribe Medical rotula o PHI que ele identifica nos resultados da transcrição. Para obter informações sobre a PHI que a Amazon Transcribe Medical pode identificar, consulte[Identificar informações de saúde pessoais (PHI) em uma transcrição](phi-id.md). ## Identificar PHI em um ditado que é falado pelo microfone Para usar o Console de gerenciamento da AWS para transcrever a fala captada pelo microfone e identificar qualquer PHI, escolha **Ditado** como o tipo de entrada de áudio, inicie a transmissão e comece a falar no microfone do seu computador. **Para identificar PHI em um ditado usando o Console de gerenciamento da AWS** 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/). 1. No painel de navegação, escolha **Transcrição em tempo real**. 1. Em **Tipo de entrada de áudio**, escolha **Ditado**. 1. Em **Configurações adicionais**, escolha **Identificação de PHI**. 1. Escolha **Iniciar streaming** e fale pelo microfone. 1. Escolha **Interromper streaming** para encerrar o ditado. ## Identificar PHI em um fluxo HTTP/2 Para iniciar um fluxo HTTP/2 com a identificação de PHI ativada, use a 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) e especifique o seguinte: + Em `LanguageCode`, especifique o código de idioma para o idioma falado no fluxo. Para inglês dos EUA, especifique `en-US`. + Em `MediaSampleHertz`, especifique a taxa de amostragem do áudio. + Em `content-identification-type`, especifique `PHI`. ## Identificação de PHI em um stream WebSocket Para iniciar uma WebSocket transmissão com a identificação de PHI ativada, use o formato a seguir para criar uma URL pré-assinada. ``` 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 ``` As definições de parâmetros podem ser encontradas na [Referência da API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html); os parâmetros comuns a todas as operações AWS da API estão listados na seção [Parâmetros comuns](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html). # Gerar transcrições alternativas Ao usar o Amazon Transcribe Medical, você obtém a transcrição que tem o maior nível de confiança. No entanto, você pode configurar o Amazon Transcribe Medical para retornar transcrições adicionais com níveis de confiança mais baixos. Use transcrições alternativas para ver diferentes interpretações do áudio transcrito. Por exemplo, em um aplicativo que permite que uma pessoa revise a transcrição, é possível apresentar as transcrições alternativas para a pessoa a escolher. Você pode gerar transcrições alternativas com a Console de gerenciamento da AWS ou com a [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html)API. ## Console de gerenciamento da AWS Para usar o Console de gerenciamento da AWS para gerar transcrições alternativas, você ativa resultados alternativos ao configurar seu trabalho. 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/). 1. No painel de navegação, em Amazon Transcribe Medicina, escolha Trabalhos de **transcrição**. 1. Escolha **Criar trabalho**. 1. Na página **Especificar os detalhes da tarefa**, forneça informações sobre o trabalho de transcrição. 1. Escolha **Próximo**. 1. Habilitar **Resultados alternativos**. 1. Em **Máximo de alternativas**, insira um valor inteiro entre 2 e 10 para o número máximo de transcrições alternativas que você deseja na saída. 1. Escolha **Criar**. ## solicitações de **Como separar o texto por locutor em um arquivo de áudio usando um trabalho de transcrição em lote (API)** + Para a API [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartMedicalTranscriptionJob.html), especifique o seguinte. 1. Para `MedicalTranscriptionJobName`, especifique um nome que seja exclusivo em sua Conta da AWS. 1. Em `LanguageCode`, especifique o código do idioma falado no arquivo de mídia e o idioma do filtro de vocabulário. 1. No parâmetro `MediaFileUri` do objeto `Media`, especifique o local do arquivo de áudio que você deseja transcrever. 1. Em `Specialty`, indique a especialidade médica do médico que está se pronunciando no arquivo de áudio. 1. Para `Type`, especifique se está transcrevendo uma conversa médica ou um ditado. 1. Em `OutputBucketName`, especifique o bucket do Amazon S3 para armazenar os resultados da transcrição. 1. Para o objeto `Settings`, especifique o seguinte: 1. `ShowAlternatives` – `true`. 1. `MaxAlternatives`: um número inteiro entre 2 e 10 para indicar o número de transcrições alternativas que você deseja na saída de transcrição. A solicitação a seguir usa o AWS SDK para Python (Boto3) para iniciar um trabalho de transcrição que gera até duas transcrições 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 **Como transcrever um arquivo de áudio de uma conversa entre um médico da atenção primária e um paciente em um arquivo de áudio (AWS CLI)** + Execute o código a seguir. ``` aws transcribe start-transcription-job \ --cli-input-json file://filepath/example-start-command.json ``` O código a seguir mostra o conteúdo 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 Endpoints VPC médicos e de interface ()AWS PrivateLink Você pode estabelecer uma conexão privada entre sua VPC e a Amazon Transcribe área médica criando uma interface *VPC* endpoint. Os endpoints de interface são alimentados por [AWS PrivateLink](https://aws.amazon.com/privatelink)uma tecnologia que permite acessar o Amazon Transcribe Medical de forma privada APIs sem um gateway de internet, dispositivo NAT, conexão VPN ou conexão. Direct Connect As instâncias em sua VPC não precisam de endereços IP públicos para se comunicar com Amazon Transcribe o Medical. APIs O tráfego entre sua VPC e o Amazon Transcribe Medical não sai da rede Amazon. Cada endpoint de interface é representado por uma ou mais [Interfaces de Rede Elástica](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html) nas sub-redes. Para obter mais informações, consulte [Interface VPC endpoints (AWS PrivateLink)](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html) no *Guia do usuário do Amazon VPC *. ## Considerações sobre endpoints Amazon Transcribe médicos de VPC *Antes de configurar uma interface VPC endpoint for Amazon Transcribe Medical, certifique-se de revisar as [propriedades e limitações do endpoint da interface](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#vpce-interface-limitations) no Guia do usuário.Amazon VPC * Amazon Transcribe O Medical oferece suporte para fazer chamadas para todas as suas ações de API a partir de sua VPC. ## Criação de uma interface VPC endpoint para medicina Amazon Transcribe Você pode criar um VPC endpoint para o serviço Amazon Transcribe médico usando o ou o. Console de gerenciamento da AWS AWS CLI Para obter mais informações, consulte [Criar um endpoint de interface](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#create-interface-endpoint) no *Guia do usuário da Amazon VPC *. Para transcrição em lote no Amazon Transcribe Medical, crie um VPC endpoint usando o seguinte nome de serviço: + com.amazonaws. *us-west-2*.transcrever Para transcrição de streaming no Amazon Transcribe Medical, crie um VPC endpoint usando o seguinte nome de serviço: + com.amazonaws. *us-west-2*.transcrever streaming Se você habilitar o DNS privado para o endpoint, poderá fazer solicitações de API ao Amazon Transcribe Medical usando seu nome DNS padrão para, por exemplo Região da AWS,. `transcribestreaming.us-east-2.amazonaws.com` Para mais informações, consulte [Accessing a service through an interface endpoint](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#access-service-though-endpoint) no *Guia do usuário do Amazon VPC *. ## Criação de uma política de VPC endpoint para streaming médico Amazon Transcribe Você pode anexar uma política de endpoint ao seu VPC endpoint que controla o acesso ao Medical. Amazon Transcribe Essa política especifica as seguintes informações: + A entidade principal que pode realizar ações. + As ações que podem ser realizadas. + Os recursos aos quais as ações podem ser aplicadas. Para mais informações, consulte [Controlar o acesso a serviços com VPC endpoints](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-endpoints-access.html) no *Guia do usuário da Amazon VPC*. **Exemplo: política de VPC endpoint para ações de transcrição de streaming Amazon Transcribe médico** Veja a seguir um exemplo de uma política de endpoint para transcrição de streaming no Amazon Transcribe Medical. Quando anexada a um endpoint, essa política concede acesso às ações Amazon Transcribe médicas listadas para todos os diretores em todos os recursos. ``` { "Statement":[ { "Principal":"*", "Effect":"Allow", "Action":[ "transcribe:StartMedicalStreamTranscription", ], "Resource":"*" } ] } ``` **Exemplo: política de VPC endpoint para ações Amazon Transcribe médicas de transcrição em lote** Veja a seguir um exemplo de uma política de endpoint para transcrição em lote no Amazon Transcribe Medical. Quando anexada a um endpoint, essa política concede acesso às ações Amazon Transcribe médicas listadas para todos os diretores em todos os recursos. ``` { "Statement":[ { "Principal":"*", "Effect":"Allow", "Action":[ "transcribe:StartMedicalTranscriptionJob" ], "Resource":"*" } ] } ``` ## Sub-redes compartilhadas Não é possível criar, descrever, modificar ou excluir endpoints da VPC em sub-redes compartilhadas com você. No entanto, é possível usar os endpoints da VPC em sub-redes que são compartilhadas com você. Para obter informações sobre o compartilhamento de VPC, consulte [Compartilhar sua VPC com outras contas](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-sharing.html#vpc-sharing-service-behavior) no guia. Amazon Virtual Private Cloud