Partilhar via

Compreender as transcrições de conversas transferidas a partir das Power Apps

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

Importante

Os criadores com a função de criador de ambiente não têm acesso automático às transcrições.

Este artigo aborda o download de transcrições de conversas no Power Apps e o uso delas para criar relatórios no Power BI. Para baixar transcrições diretamente no Copilot Studio, consulte Baixar transcrições de conversas no Copilot Studio.

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

Observação

As respostas do agente que usam o SharePoint como fonte de conhecimento não são incluídas nas transcrições da conversa.

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

  • Microsoft Dataverse para ambientes do Teams
  • Ambientes de desenvolvedor Dataverse
  • Agentes do Microsoft 365 Copilot

Pré-requisito

Ver e exportar transcrições de conversações a partir do portal Power Apps

  1. Inicie sessão no Power Apps.

  2. No painel lateral, selecione Tabelas e, em seguida, selecione Tudo.

    Captura de ecrã que mostra Tudo selecionado no nó Tabelas.

  3. Digite "conversa" na caixa Pesquisar .

  4. Selecione a tabela ConversationTranscript .

    Abre-se uma página para a tabela ConversationTranscript.

  5. Na barra de menu superior, selecione Exportar>dados de exportação.

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

    Captura de ecrã a mostrar o menu Exportar com a opção Exportar dados.

  6. Aguarde alguns minutos para que as Power Apps preparem os dados para exportação e, em seguida, selecione Transferir dados exportados.

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

Compreender as 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 nas transcrições da conversa.

Observação

  • Se uma conversa tiver 30 minutos de inatividade, ela 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 registo de transcrição de uma conversa for maior que 1 MB, a transcrição será dividida em vários registos, cada um não maior que 1 MB, e cada um com os mesmos valores Name e ConversationStartTime.
Campo Descrição Exemplo
Content A transcrição completa em formato JSON Ver campo Conteúdo
ConversationStartTime A hora em que a conversa começou (não a hora em que o registro de transcrição foi gravado no armazenamento de dados) 2021-04-19T20:39:09Z
ConversationTranscript O identificador exclusivo da linha na tabela Dataverse 28eccb77-xxxx-4a63-985f-ffaaadd6f391
Metadata JSON que inclui o ID do agente, o 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 seguida de BotId. 8YYe8iif49ZKkycZLe7HUO_198eca5f-1145-4ae6-8c08-835d884a8688
Bot_ConversationTranscript O ID do agente aaaabbbb-0000-cccc-1111-dddd2222eeee
Created on A data e a hora em que o registro de transcrição foi criado 2021-04-20T02:40:13Z

Campo de conteúdo

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

  • As atividades de mensagens 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 do evento comunicam informações programáticas de um cliente ou canal para o agente.

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

A tabela a seguir descreve alguns dos campos-chave no conteúdo JSON:

Key Descrição
ID O GUID exclusivo do objeto de atividade
valueType O tipo de valor armazenado na atividade; dita quais informações a atividade está fornecendo (Tipos de valor de atividade comuns)
timestamp A data/hora de quando a atividade foi gerada, em 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 campos id e role:
  • id - o ID do invocador
  • role - comporta 0 ou 1
    • 0 - a atividade é proveniente do agente
    • 1 - a atividade é proveniente do usuário interagindo com o agente
Notas:
o id pode ser usado para calcular o número de utilizadores ativos que estão a interagir com o agente se a tela estiver a transmitir um ID exclusivo do utilizador. Se a tela não indicar um ID, é indicado um ID exclusivo por conversação.
Por razões de segurança e privacidade, o ID é colocado em hash antes de ser gravado na transcrição.
channelId O ID do canal de onde vem a atividade; por exemplo, directline, msteams, ou facebook
textFormat O formato do texto; por exemplo, plain ou markdown
attachments Dados dinâmicos ricos associados à atividade; por exemplo, AdaptiveCards, HeroCards, ou Carousel data
text O texto para message atividades
value Campos específicos para a atividade com base no tipo de valor; é neste campo que existe a maior parte da informação útil
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 valor de atividade comuns

Tipo de valor da atividade Descrição
ConversationInfo Se a conversa é do painel de teste do Copilot Studio (isDesignMode) e a localidade da conversa
CSATSurveyRequest O usuário é apresentado a uma pesquisa de satisfação do cliente (CSAT)
CSATSurveyResponse O usuário responde a uma pesquisa CSAT
DialogRedirect O usuário é redirecionado para outro tópico
ImpliedSuccess O utilizador chegou a um nó de pergunta no tópico, onde uma das condições aponta para o tópico de sistema CSAT Sucesso Confirmado (bots clássicos apenas) ou chama o tópico de sistema Fim de Conversa.
IntentRecognition O usuário acionou um tópico
PRRSurveyRequest Foi perguntado ao usuário se o tópico respondia à sua pergunta do tópico Fim da Conversa
PRRSurveyResponse A resposta do usuário para saber se o tópico respondeu à pergunta do tópico Fim da conversa
SessionInfo O tipo (unengaged ou engaged), resultado (Escalated, Resolved, Abandon), Hora de início e término da sessão (startTimeUtc, endTimeUtc), e a contagem de turnos da sessão
VariableAssignment Um valor é atribuído a uma variável

Transcrições melhoradas

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

Ativar transcrições melhoradas

  1. Abra o seu agente.

  2. Vá para Configurações>avançadas.

  3. Selecione Melhorar Transcrições e ative Incluir detalhes ao nível de nó nas transcrições.

Captura de ecrã a mostrar a página de definições de Transcrições Avançadas.

Dados ao nível do nó

Quando as transcrições melhoradas estão ativadas, é apresentado um tipo de atividade nodeTraceData na transcrição para cada nó que foi invocado por um tópico. A tabela a seguir descreve 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 ser executado
topicDisplayName O tópico que invoca o nó

Análise personalizada

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

A solução de KPI de conversação dentro do Copilot Studio Kit analisa automaticamente transcrições e preenche dados agregados em tabelas Dataverse.

Alterar o período de retenção predefinido

Uma tarefa de eliminação em massa do Power Apps remove automaticamente as 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 cronograma diferente.

Cancelar o trabalho de exclusão em massa existente

  1. Em Power Apps, selecione Configurações>Avançadas.

    Captura de ecrã do menu Definições do Power Apps com as Definições avançadas realçadas.

    O portal do Dynamics 365 é aberto num novo separador.

  2. Selecione o cursor ao lado de Configurações e, em Sistema, selecione Gerenciamento de Dados.

    Captura de ecrã do menu Definições, com a Gestão de Dados realçada.

  3. Selecione Eliminação de Registos em Massa.

  4. Na lista Vista, selecione Tarefas de Sistema de Eliminação em Massa Periódicas.

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

  5. Selecione a tarefa Eliminação em Massa dos Registos de Transcrição de Conversação 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 ecrã da lista Mais ações, com Cancelar realçado.

Criar um novo trabalho de eliminação em massa

  1. Para iniciar o Assistente de Eliminação em Massa, selecione Novo e, em seguida, no assistente, selecione Seguinte.

  2. Defina os seguintes critérios de pesquisa:

    • Na lista Procurar, selecione ConversationTranscripts.
    • Selecione ConversationStartTime, selecione Older Than X Months e digite "12".
      Essa configuração mantém as transcrições por 12 meses. Escolha uma comparação e um valor diferentes, se quiser.
    • Selecione SchemaType, deixe igual a e escreva "powervirtualagents".

    Captura de ecrã das definições de critérios de pesquisa de tarefa de eliminação em massa.

  3. Selecione Seguinte.

  4. Insira um nome para o trabalho, selecione Executar este trabalho após cada execução e digite 1. Escolha um horário diferente se não quiser que o trabalho seja executado todos os dias.

    Captura de tela do nome do trabalho de exclusão em massa e das configurações de execução.

  5. Selecione Seguinte e, em seguida, selecione Submeter.

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

Os administradores podem impedir o salvamento 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 aproveitar ao máximo as transcrições da conversa

As variáveis podem ser usadas para armazenar dados relevantes para o conteúdo do agente ou para o usuário do agente. A análise da variável e seu valor a partir da transcrição da conversa permite filtrar ou dividir os dados pela variável.

As transcrições da conversação podem referir-se ao conteúdo apenas pelo ID. Por exemplo, num nó Redirecionar, o tópico de destino é mencionado apenas pelo respetivo ID. Para obter o nome deste tópico, procure o respetivo ID no conteúdo do agente.

  • Last updated on