Importação de transcrições de conversas - Guia do desenvolvedor

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

Importação de transcrições de conversas

Importar transcrições de conversas é um processo de três etapas:

  1. Prepare as transcrições para importação convertendo-as para o formato correto. Se você estiver usando o Contact Lens para o Amazon Connect, as transcrições já estão no formato correto.

  2. Faça upload do arquivo para um bucket do Amazon S3. Se você estiver usando o Contact Lens, suas transcrições já estão em um bucket S3.

  3. Analise as transcrições usando o console do Amazon Lex V2 ou operações de API. O tempo necessário para concluir o treinamento depende do volume de transcrições e da complexidade da conversa. Normalmente, 500 linhas de transcrições são analisadas a cada minuto.

Cada uma dessas etapas é descrito nas seções a seguir.

Importação de transcrições do Contact Lens para o Amazon Connect

O designer de chatbot automatizado Amazon Lex V2 é compatível com arquivos de transcrição do Contact Lens. Para usar os arquivos de transcrição do Contact Lens, você deve ativar o Contact Lens e anotar a localização dos arquivos de saída.

Para exportar transcrições do Contact Lens
  1. Ative a lente de contato na sua instância do Amazon Connect. Para obter instruções, consulte Habilitar o Contact Lens para o Amazon Connect no guia do administrador do Amazon Connect.

  2. Observe a localização do bucket S3 que o Amazon Connect está usando para sua instância. Para ver a localização, abra a página Armazenamento de dados no console do Amazon Connect. Para obter instruções, consulte Atualizar configurações da instância no guia do administrador do Amazon Connect.

Depois de ativar o Contact Lens e anotar a localização dos arquivos de transcrição, acesse Analise suas transcrições usando o console do Amazon Lex V2 para obter instruções sobre como importar e analisar suas transcrições.

Preparar transcrições

Prepare suas transcrições criando arquivos de transcrição.

  • Crie um arquivo de transcrição por conversa listando a interação entre as partes. Cada interação na conversa pode abranger várias linhas. Você pode fornecer versões editadas e não editadas da conversa.

  • O arquivo deve estar no formato JSON especificado em Formato da transcrição de entrada.

  • Você deve fornecer pelo menos 1.000 turnos de conversação. Para melhorar a descoberta de suas intenções e tipos de slots, você deve fornecer cerca de 10.000 ou mais turnos de conversação. O designer automatizado do chatbot processará apenas os primeiros 700.000 turnos.

  • Não há limite para o número de arquivos de transcrição que você pode carregar, nem há uma restrição de tamanho de arquivo.

Se você planeja filtrar as transcrições importadas por data, os arquivos devem estar na seguinte estrutura de diretórios:

<path or bucket root> --> yyyy --> mm --> dd --> transcript files

O arquivo de transcrição deve conter a data no formato “aaaa-mm-dd” em algum lugar do nome do arquivo.

Para exportar transcrições de outros aplicativos do contact center
  1. Use as ferramentas do seu aplicativo do contact center para exportar conversas. A conversa deve conter pelo menos as informações especificadas em Formato da transcrição de entrada.

  2. Transforme as transcrições produzidas pelo seu aplicativo de contact center no formato descrito em Formato da transcrição de entrada. Você é responsável por realizar a transformação.

Fornecemos três scripts para preparar as transcrições. Eles são:

  • Um script para combinar as transcrições do Contact Lens com os logs de conversas do Amazon Lex V2. As transcrições do Contact Lens não incluem partes das conversas do Amazon Connect que interagem com os bots do Amazon Lex V2. O script exige que os registros de conversação sejam ativados para o Amazon Lex V2 e as permissões apropriadas para consultar o log de conversas nos buckets CloudWatch Logs e Contact Lens S3.

  • Um script para transformar Amazon Transcribe Call Analytics no formato de entrada do Amazon Lex V2.

  • Um script para transformar a as transcrições de conversa do Amazon Connect no formato de entrada do Amazon Lex V2.

Você pode baixar os scripts deste repositório do GitHub: https://github.com/aws-samples/amazon-lex-bot-recommendation-integration.

Faça upload do arquivo para um bucket S3

Se você estiver usando o Contact Lens, suas transcrições já estão em um bucket S3. Para saber a localização e os nomes dos arquivos de transcrição, consulte Exemplos de arquivos de saída de lentes de contato no guia do administrador do Amazon Connect.

Se estiver usando outro aplicativo de contact center e não tiver configurado um bucket S3 para seus arquivos de transcrição, siga este procedimento. Caso contrário, se já tiver um bucket do S3, depois de fazer login no console do Amazon S3, siga este procedimento a partir da etapa 5.

Para fazer upload de arquivos em um bucket do S3
  1. Faça login no AWS Management Console e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

  2. Escolha Criar bucket.

  3. Dê um nome ao bucket e escolha uma região. A região deve ser a mesma que você usa para o Amazon Lex V2. Configure as outras opções conforme necessário para seu caso de uso.

  4. Escolha Criar bucket.

  5. Na lista de buckets, escolha um bucket existente ou um que você acabou de criar

  6. Escolha Carregar.

  7. Adicione os arquivos de transcrição que você deseja carregar.

  8. Escolha Carregar.

Analise suas transcrições usando o console do Amazon Lex V2

Você só pode usar o design automatizado de bots em um idioma vazio. Você pode adicionar um novo idioma a um bot existente ou criar um novo bot.

Para criar um novo idioma em um novo bot
  1. Faça login no AWS Management Console e abra o console do Amazon Lex em https://console.aws.amazon.com/lex/.

  2. Escolha Criar bot

  3. Escolha Começar com o Automated Chatbot Designer. Preencha as informações para criar seu novo bot.

  4. Escolha Avançar

  5. Em Adicionar idioma ao bot, preencha as informações do idioma.

  6. Na seção Localização do arquivo de transcrição no S3, escolha o bucket do S3 que contém seus arquivos de transcrição e o caminho local para os arquivos, se necessário.

  7. Você pode escolher a seguinte opção:

    • Uma chave AWS KMS para criptografar os dados da transcrição durante o processamento. Se você não selecionar uma chave, uma chave AWS KMS de serviço será usada.

    • Para filtrar as transcrições para um intervalo de datas específico. Se você optar por filtrar as transcrições, elas deverão estar na estrutura de pastas correta. Para mais informações, consulte Preparar transcrições.

  8. Escolha Concluído.

Aguarde até que o Amazon Lex V2 processe a transcrição. Você verá uma mensagem de conclusão quando a análise for concluída.

Como parar de analisar sua transcrição

Caso precise interromper a análise das transcrições enviadas, você pode interromper um trabalho BotRecommendation em execução, que tem o status BotRecommendationStatus de processamento. Você pode clicar no botão Interromper processamento presente no banner depois de enviar um trabalho do console ou usando o CLI SDK para a API StopBotRecommendation. Para obter mais informações, consulte StopBotRecommendation

Depois de chamar StopBotRecommendation, o BotRecommendationStatus interno é configurado para Stopping e você não é cobrado. Para garantir que o trabalho tenha sido interrompido, você pode chamar a API DescribeBotRecommendation e verificar se BotRecommendationStatus está Stopped. Isso geralmente leva de 3 a 4 minutos.

Você não será cobrado pelo processamento após a chamada da API StopBotRecommendation.