View a markdown version of this page

AWS HealthScribe streaming - Amazon Transcribe
Diretrizes e requisitosResourceAccessRoleArn permissões de função

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

AWS HealthScribe streaming

Com o AWS HealthScribe streaming, você pode transcrever conversas médicas em tempo real. AWS HealthScribe streaming é um serviço bidirecional HTTP2 baseado em tempo real que aceita streaming de áudio em um canal e vende uma transcrição de áudio no outro canal. Após a conclusão do streaming, AWS HealthScribe analisa o conteúdo do stream e produz um arquivo JSON de transcrição e um arquivo JSON de nota clínica.

Para iniciar o streaming, use a operação StartMedicalScribeStreamda API. Essa API inicia um canal bidirecional HTTP2 baseado que você usa para transmitir eventos de áudio.

Ao iniciar um fluxo, primeiro especifique a configuração do fluxo em um MedicalScribeConfigurationEvent. Esse evento inclui definições de canal, configurações de criptografia e configurações de análise pós-fluxo, como a configuração de saída para geração agregada de transcrições e notas clínicas.

Após iniciar o streaming de áudio, você gerencia o fluxo da seguinte forma:

  • Quando terminar, para começar a processar os resultados com a análise pós-stream, envie um MedicalScribeSessionControlEvent com um Type de END_OF_SESSION e AWS HealthScribe inicie a análise.

  • Para pausar o streaming, complete o fluxo de entrada sem enviar o MedicalScribeSessionControlEvent.

  • Para retomar um fluxo pausado, use a operação de API StartMedicalScribeStream e especifique o mesmo SessionId. Esse é o SessionId que você usou quando iniciou o fluxo originalmente.

Tópicos

Diretrizes e requisitos

A seguir estão as diretrizes e os requisitos para AWS HealthScribe streaming:

  • Antes de enviar eventos de áudio, você deve primeiro especificar a configuração do fluxo em um MedicalScribeConfigurationEvent.

  • Para executar análises pós-fluxo, o ResourceAccessRoleArn em seu MedicalScribeConfigurationEvent deve ter as permissões corretas. Para obter mais informações, consulte ResourceAccessRoleArn permissões de função.

  • Você pode retomar uma sessão quantas vezes quiser dentro de um período de 5 horas a partir da criação do fluxo inicial.

  • Você pode transmitir no máximo 2 horas de áudio por sessão, considerando todas as solicitações de streaming.

  • Por padrão, AWS HealthScribe fornece criptografia em repouso para proteger dados confidenciais do cliente usando chaves Amazon S3 gerenciadas. Ao iniciar um stream, você pode especificar uma AWS KMS chave para uma segunda camada de criptografia. Você ResourceAccessRoleArn deve ter permissão para usar sua AWS KMS chave. Para obter mais informações, consulte Criptografia de dados em repouso para AWS HealthScribe.

  • Você pode usar o AWS HealthScribe streaming com o AWS SDKs, exceto o SDK para Python (Boto3) e o SDK para PHP.

  • Se ocorrer uma exceção LimitExceededException após o encerramento de um fluxo, você pode reiniciar a sessão e ainda gerar análises pós-fluxo. Para reiniciar o stream, use a StartMedicalScribeStreamAPI e use a mesmaSessionID. Em seguida, envie um MedicalScribeSessionControlEvent com um Type de END_OF_SESSION e AWS HealthScribe inicie a análise.

ResourceAccessRoleArn permissões de função

Para executar análises pós-stream, o usuário ResourceAccessRoleArn MedicalScribeConfigurationEvent deve ser capaz de acessar seu bucket de saída do Amazon S3 e, se você o fornecer, AWS KMS sua chave. Além disso, a política de confiança da função deve conceder permissão ao serviço transcribe.streaming.amazonaws.com para assumir a função.

Veja a seguir um exemplo de política do IAM que concede permissões de bucket e permissões de AWS KMS chave do Amazon S3. Para obter mais informações, consulte Criptografia de dados em repouso para AWS HealthScribe.

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Action": [
                "s3:PutObject"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket",
                "arn:aws:s3:::amzn-s3-demo-bucket/*"
            ],
            "Effect": "Allow"
        },
        {
            "Action": [
                "kms:DescribeKey",
                "kms:Decrypt",
                "kms:Encrypt",
                "kms:GenerateDataKey*"
            ],
            "Resource": "arn:aws:kms:us-west-2:123456789012:key/1234abcd-12ab-34cd-56ef-123456SAMPLE",
            "Effect": "Allow"
        }
    ]
}

Veja a seguir um exemplo de política de confiança.

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "transcribe.streaming.amazonaws.com"
                ]
            },
            "Action": "sts:AssumeRole"
        }
    ]
}