Iniciar uma transcrição de análise pós-chamada - Amazon Transcribe

Iniciar uma transcrição de análise pós-chamada

Antes de iniciar uma transcrição de análise pós-chamada, você deve criar todas as categorias para as quais deseja que o Amazon Transcribe encontre correspondências no áudio.

nota

As transcrições do Call Analytics não podem ser combinadas retroativamente com novas categorias. Somente as categorias que você cria antes de iniciar uma transcrição do Call Analytics podem ser aplicadas a essa saída de transcrição.

Se você criou uma ou mais categorias e seu áudio corresponde a todas as regras em pelo menos uma de suas categorias, o Amazon Transcribe sinaliza a saída com a categoria correspondente. Se você optar por não usar categorias ou se o áudio não corresponder às regras especificadas nas categorias, sua transcrição não será sinalizada.

Para iniciar uma transcrição de análise pós-chamada, você pode usar o Console de gerenciamento da AWS, a AWS CLI ou os AWS SDKs. Veja os seguintes exemplos:

Siga o procedimento a seguir para iniciar um trabalho de análise pós-chamada. As chamadas que correspondem a todas as características definidas por uma categoria são rotuladas com essa categoria.

  1. No painel de navegação, em Amazon Transcribe Call Analytics, selecione Tarefas de análise de chamadas.

  2. Escolha Criar trabalho.

    Captura de tela do console do Amazon Transcribe: a página “Tarefas de análise de chamadas”.

  3. Na página Especificar os detalhes da tarefa, forneça informações sobre o trabalho de análise de chamadas, incluindo a localização dos dados de entrada.

    Captura de tela do console do Amazon Transcribe: a página “Especificar os detalhes da tarefa”.

    Especifique o local do Amazon S3 desejado para os dados de saída e qual perfil do IAM usar.

    Captura de tela do console do Amazon Transcribe: o painel “Permissões de acesso”.

  4. Escolha Próximo.

  5. Em Configurar tarefa, ative os recursos opcionais que você deseja incluir no trabalho de análise de chamadas. Se você criou categorias anteriormente, elas aparecem no painel Categorias e são aplicadas automaticamente ao trabalho de análise de chamadas.

    Captura de tela do console do Amazon Transcribe: a página “Configurar trabalho” mostrando todas as categorias personalizadas.

  6. Escolha Criar trabalho.

Este exemplo usa o comando start-call-analytics-job e o parâmetro channel-definitions. Para obter mais informações, consulte StartCallAnalyticsJob e ChannelDefinition.

aws transcribe start-call-analytics-job \
--region us-west-2 \
--call-analytics-job-name my-first-call-analytics-job \
--media MediaFileUri=s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac \
--output-location s3://amzn-s3-demo-bucket/my-output-files/ \
--data-access-role-arn arn:aws:iam::111122223333:role/ExampleRole \
--channel-definitions ChannelId=0,ParticipantRole=AGENT ChannelId=1,ParticipantRole=CUSTOMER

Veja está outro exemplo que usa o comando start-call-analytics-job e um corpo de solicitação que habilita o Call Analytics para esse trabalho.

aws transcribe start-call-analytics-job \
--region us-west-2 \
--cli-input-json file://filepath/my-call-analytics-job.json

O arquivo my-call-analytics-job.json contém o corpo da solicitação a seguir.

{
      "CallAnalyticsJobName": "my-first-call-analytics-job",
      "DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole",
      "Media": {
          "MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
      },
      "OutputLocation": "s3://amzn-s3-demo-bucket/my-output-files/",
      "ChannelDefinitions": [
          {
              "ChannelId": 0,
              "ParticipantRole": "AGENT"
          },
          {
              "ChannelId": 1,
              "ParticipantRole": "CUSTOMER"
          }
      ]
}

Este exemplo usa o AWS SDK para Python (Boto3) para iniciar uma tarefa de análise de chamadas usando o método start_call_analytics_job. Para obter mais informações, consulte StartCallAnalyticsJob e ChannelDefinition.

Para ver exemplos adicionais de uso dos SDKs da AWS, bem como exemplos específicos de recursos, cenários e entre serviços, consulte o capítulo Exemplos de código para o Amazon Transcribe usando SDKs da AWS.

from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
job_name = "my-first-call-analytics-job"
job_uri = "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
output_location = "s3://amzn-s3-demo-bucket/my-output-files/"
data_access_role = "arn:aws:iam::111122223333:role/ExampleRole"
transcribe.start_call_analytics_job(
     CallAnalyticsJobName = job_name,
     Media = {
        'MediaFileUri': job_uri
     },
     DataAccessRoleArn = data_access_role,
     OutputLocation = output_location,
     ChannelDefinitions = [
        {
            'ChannelId': 0, 
            'ParticipantRole': 'AGENT'
        },
        {
            'ChannelId': 1, 
            'ParticipantRole': 'CUSTOMER'
        }
     ]
)
    
 while True:
   status = transcribe.get_call_analytics_job(CallAnalyticsJobName = job_name)
   if status['CallAnalyticsJob']['CallAnalyticsJobStatus'] in ['COMPLETED', 'FAILED']:
     break
   print("Not ready yet...")
   time.sleep(5)
 print(status)