Compartilhar via

Entender as transcrições de conversa baixadas do Power Apps

Você pode exibir, exportar e baixar as transcrições de interações do cliente com o agente no Power Apps e no Copilot Studio. As informações que cada aplicativo exporta são um pouco diferentes.

Importante

Os criadores com a função de Criador de ambiente não têm acesso automaticamente às transcrições.

Este artigo aborda o download das transcrições de conversa no Power Apps e como usá-las para criar relatórios no Power BI. Para baixar transcrições diretamente no Copilot Studio, consulte Baixar transcrições de conversa no Copilot Studio.

Por padrão, o Power Apps baixa as transcrições de conversa dos últimos 30 dias. Você pode alterar o período de retenção.

Observação

As respostas de agente que usem o SharePoint como fonte de conhecimento não são incluídas em transcrições de conversa.

As transcrições de conversas não são escritas para:

  • Ambientes do Microsoft Dataverse for Teams
  • Ambientes de desenvolvedor do Dataverse
  • Agentes do Microsoft 365 Copilot

Pré-requisito

Exibir e exportar transcrições de conversa do portal do Power Apps

  1. Entre no Power Apps.

  2. No painel lateral, selecione Tabelas e selecione Todas.

    Captura de tela mostrando a opção Todos selecionados no nó Tabelas.

  3. Insira "conversa" na caixa Pesquisar.

  4. Selecione a tabela ConversationTranscript.

    Uma página da tabela ConversationTranscript será aberta.

  5. Na barra de menus superior, selecione Exportar>Exportar dados.

    Leva alguns minutos para que os dados sejam compilados para exportação.

    Captura de tela mostrando o menu Exportar com a opção Exportar dados.

  6. Aguarde alguns minutos até o Power Apps preparar os dados para exportação e selecione Baixar dados exportados.

    O arquivo é salvo como um arquivo ZIP no local padrão de download do seu navegador.

Entender transcrições de conversas

A transcrição da conversa é um arquivo CSV (valores separados por vírgula). A tabela a seguir descreve os campos mais importantes que você encontrará nas transcrições das suas conversas.

Observação

  • Se uma conversa tiver 30 minutos de inatividade, a conversa será salva em um registro de transcrição. Se a conversa continuar após a inatividade, ela será salva em um novo registro de transcrição com o mesmo Name.
  • Se um registro de transcrição de uma conversa for maior que 1 MB, a transcrição será dividida em vários registros, cada não maior que 1 MB e com os mesmos valores Name e ConversationStartTime.
Campo Descrição Exemplo
Content Toda a transcrição em formato JSON Consulte Campo do conteúdo
ConversationStartTime A hora de início da conversa (não a hora em que o registro da transcrição foi gravado no armazenamento de dados) 2021-04-19T20:39:09Z
ConversationTranscript O identificador exclusivo da linha na tabela do Dataverse 28eccb77-xxxx-4a63-985f-ffaaadd6f391
Metadata JSON que inclui a ID do agente, a ID do locatário e o nome do agente {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot"}
Name O nome da linha personalizada criada a partir de ConversationId e em seguida BotId. 8YYe8iif49ZKkycZLe7HUO_198eca5f-1145-4ae6-8c08-835d884a8688
Bot_ConversationTranscript A ID do agente aaaabbbb-0000-cccc-1111-dddd2222eeee
Created on A data e hora de criação do registro de transcrição 2021-04-20T02:40:13Z

Campo do conteúdo

O campo Content é um registro bruto de todas as atividades que os usuários tinham com o agente. Os tipos de atividades comuns incluem mensagem e evento:

  • As atividades de mensagem representam o conteúdo mostrado em uma conversa. As atividades de Mensagem podem conter texto, fala, cartões interativos e anexos binários ou desconhecidos.
  • As atividades de Evento comunicam informações programáticas de um cliente ou canal para o agente.

Para obter mais informações sobre tipos de atividade, consulte o Esquema de atividade do Bot Framework.

A tabela a seguir descreve alguns dos campos principais no JSON de conteúdo:

Key Descrição
ID O GUID exclusivo do objeto de atividade
valueType O tipo de valor armazenado na atividade; determina quais informações a atividade está fornecendo (Tipos de valores de atividade comuns)
timestamp O carimbo de data/hora de quando a atividade foi gerada no formato Epoch (o número de segundos desde a meia-noite UTC de 1º de janeiro de 1970)
type O tipo de atividade, por exemplo, message, event ou trace
replyToId O ID da atividade à qual a atividade atual está respondendo
from Contém os campos id e role:
  • id – a ID do invocador
  • role – contém 0 ou 1
    • 0 – a atividade vem do agente
    • 1 - a atividade vem do usuário que interage com o agente
Observações:
a id pode ser usada para calcular o número de usuários ativos que estão interagindo com o agente se a tela estiver passando uma ID única do usuário. Se a tela não transmitir uma ID, uma ID exclusiva por conversa é transmitida.
Por questões de segurança e privacidade, o hash é aplicado à ID antes de ser gravada na transcrição.
channelId A ID do canal na qual a atividade se origina, por exemplo, directline, msteams ou facebook
textFormat O formato do texto, por exemplo, plain ou markdown
attachments Dados avançados e dinâmicos associados à atividade, por exemplo, AdaptiveCards, HeroCards ou Carousel data
text O texto para atividades de message
value Campos específicos para a atividade com base no tipo de valor; este campo é onde se encontram a maioria das informações úteis
channeldata Contém dados do canal:
  • para mensagens:
    • DialogTraceDetail
    • DialogErrorDetail
    • VariableDetail (contém o valor atribuído a uma variável)
    • CurrentMessageDetail
  • para eventos:
    • cci_trace_id
    • traceHistory
    • enableDiagnostics
    • clientTimestamp
    • clientActivityId
name O nome da atividade do evento, por exemplo, SetPVAContext

Tipos de valores de atividade comuns

Tipo de valor de atividade Descrição
ConversationInfo Se a conversa é do painel de teste do Copilot Studio (isDesignMode) e o local da conversa
CSATSurveyRequest O usuário recebe uma pesquisa de satisfação do cliente (CSAT)
CSATSurveyResponse O usuário responde a uma pesquisa de CSAT
DialogRedirect O usuário é redirecionado para outro tópico
ImpliedSuccess O usuário atingiu um nó de pergunta no tópico, em que uma das condições aponta para o tópico do sistema CSAT Sucesso Confirmado (bots clássicos somente) ou chama o tópico Fim da Conversa
IntentRecognition O usuário disparou um tópico
PRRSurveyRequest O usuário foi questionado se o tópico respondeu à sua pergunta no tópico Fim da Conversa
PRRSurveyResponse A resposta do usuário para saber se o tópico respondeu à sua pergunta no tópico Fim da Conversa
SessionInfo O tipo (unengaged ou engaged), o resultado (Escalated, Resolved, Abandon), e a hora de início e término da sessão (startTimeUtc, endTimeUtc), bem como a quantidade de turnos da sessão.
VariableAssignment Um valor foi atribuído a uma variável

Transcrições aprimoradas

Os agentes podem ser configurados para gerar transcrições aprimoradas que incluem dados no nível do nó. Esses dados ajudam a controlar o fluxo de uma conversa dentro de um tópico. Por exemplo, em um tópico gerenciar ordens, os usuários podem escolher entre enviar uma nova ordem ou recuperar uma existente. Os dados em nível de nó permitem a análise do comportamento do usuário nessas opções.

Ativar transcrições aprimoradas

  1. Abra seu agente.

  2. Vá até Configurações>Avançadas.

  3. Selecione Aprimorar transcrições e ative Incluir detalhes no nível do nó nas transcrições.

Captura de tela mostrando a página de configurações de Transcrições Aprimoradas.

Dados no nível do nó

Quando as transcrições aprimoradas estão ativadas, um tipo de atividade do nodeTraceData aparece na transcrição para cada nó que foi invocado por um tópico. A tabela a seguir descrever os campos chave no valor da atividade nodeTraceData.

Key Descrição
nodeID O identificador do nó
nodeType O tipo de nó, por exemplo, SendActivity ou SearchAndSummarizeContent
startTime O carimbo de data/hora quando o nó foi invocado
endTime O carimbo de data/hora quando o nó terminou de executar
topicDisplayName O tópico que está invocando o nó

Análise personalizada

Alguns cenários, como filtrar conversas com base em uma variável personalizada, exigem uma abordagem personalizada para análises. Os clientes que criam soluções de análise personalizadas podem ingerir as transcrições brutas nos pipelines de dados ou usar um complemento, como o Kit do Copilot Studio

A solução KPI de Conversa no Kit do Copilot Studio analisa automaticamente as transcrições e popula dados agregados em tabelas do Dataverse.

Alterar o período de retenção padrão

Um trabalho de exclusão em massa do Power Apps remove automaticamente transcrições do agente com mais de 30 dias. Para manter as transcrições por mais tempo, cancele o trabalho existente e crie um novo que seja executado em um agendamento diferente.

Cancelar o trabalho de exclusão em massa existente

  1. No Power Apps, selecione Configurações>Configurações avançadas.

    Captura de tela do menu Configurações do Power Apps com Configurações avançadas realçadas.

    O portal do Dynamics 365 é aberto em uma nova guia.

  2. Selecione o sinal de interpolação próximo a Configurações e, sob Sistema, selecione Gerenciamento de Dados.

    Captura de tela do menu Configurações com o Gerenciamento de Dados destacado.

  3. Selecione Exclusão em Massa de Registros.

  4. Na lista Visualização, selecione Trabalhos Recorrentes de Exclusão em Massa do Sistema.

    Captura de tela lista de trabalhos recorrentes de exclusão em massa.

  5. Selecione o trabalho Excluir em Massa Registros de Transcrição da Conversa com Mais de 1 Mês.

    Captura de tela de uma lista de trabalhos de exclusão em massa, com o primeiro realçado.

  6. Na lista Mais ações, selecione Cancelar.

    Captura de tela da lista Mais ações, com Cancelar realçado.

Criar novo trabalho de exclusão em massa

  1. Para iniciar o Assistente para Exclusão em Massa, selecione Novo e, no assistente, selecione Avançar.

  2. Defina os critérios de pesquisa a seguir:

    • Na lista Procurar, selecione ConversationTranscripts.
    • Selecione ConversationStartTime, escolha Older Than X Months e digite "12".
      Estas configurações manterão as transcrições por 12 meses. Escolha comparações e valores diferentes, se desejar.
    • Selecione SchemaType, deixe igual e digite "powervirtualagents".

    Captura de tela da exclusão de critérios de pesquisa de trabalhos em massa e configurações de execução.

  3. Selecione Avançar

  4. Insira um nome para o trabalho, selecione Executar este trabalho após cada e insira 1. Escolha um agendamento diferente se não quiser que o trabalho seja executado todos os dias.

    Captura de tela da exclusão de nomes de trabalhos em massa e configurações de execução.

  5. Selecione Avançar e depois Enviar.

Por que não consigo ver minhas transcrições de conversa na tabela ConversationTranscript do Power Apps?

Os administradores podem impedir a gravação de transcrições no Dataverse. Para obter mais detalhes sobre como as transcrições são salvas e como gerenciar o acesso, consulte Controlar o acesso à transcrição.

Importante

As transcrições não são armazenadas para agentes implantados em ambientes de desenvolvedor.

Dicas para obter o máximo das transcrições de conversas

As variáveis podem ser usadas para armazenar dados relevantes para o conteúdo do agente ou o usuário do agente. Analisar a variável e seu valor da transcrição da conversa permite que você filtre ou divida os dados pela variável.

As transcrições de conversas referem-se somente ao conteúdo por sua ID. Por exemplo, em um nó de Redirecionamento, o tópico de destino é referenciado apenas por sua ID. Para obter o nome deste tópico, procure sua ID no conteúdo do agente.

  • Last updated on