Partilhar via

Compreenda transcrições de conversas descarregadas do Power Apps

Pode visualizar, exportar e descarregar transcrições das interações dos clientes com o seu agente tanto no Power Apps como 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 a sua utilização para criar relatórios no Power BI. Para descarregar as transcrições diretamente no Copilot Studio, consulte Descarregar transcrições das conversas no Copilot Studio.

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

Observação

Respostas de agentes que utilizam SharePoint como fonte de conhecimento e documentos que incluem dados sensíveis não são incluídas na transcrição da conversa.

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

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

Pré-requisito

Veja e exporte transcrições de conversas do portal Power Apps

  1. Inicia sessão no Power Apps.

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

    Captura de ecrã do nó Tabelas com Todos selecionado.

  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.

    Demora alguns minutos a compilar os dados para exportação.

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

  6. Espere alguns minutos para Power Apps preparar os dados para exportação e depois selecione Download exported data.

    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 existe como uma tabela Dataverse que pode descarregar como ficheiro CSV (valores separados por vírgulas). A lógica que determina quando e como o sistema regista informação para transcrições de conversas é:

  • O sistema guarda uma conversa num registo de transcrição após 30 minutos de inatividade. Se a conversa retomar após o tempo de inatividade, o sistema guarda as novas atividades num novo registo com o mesmo Name valor, mas com um valor novo ConversationStartTime .
  • Para agentes publicados no canal de telecomunicações, as conversas são encerradas automaticamente três minutos após um evento de Fim de Conversa.
  • Cada registo tem um limite de 1 MB para a transcrição (Content coluna). Quando uma transcrição é maior do que esse limite, o sistema divide a transcrição em múltiplos registos, todos com os mesmos Name valores e ConversationStartTime , mas com valores diferentes Metadata.BatchId .
  • Para fundir transcrições, pegue todos os registos com os mesmos Name valores e ConversationStartTime depois ordene esses registos por BatchId.

A tabela a seguir descreve os campos mais importantes nas transcrições da conversa.

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, ID do inquilino, nome do agente e ID do lote {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot", "BatchId":2}
Name O nome da linha personalizada criada de ConversationId seguido 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.
Para segurança e privacidade, o sistema faz o hash do ID antes de o registar 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 vem do painel de testes do Copilot Studio (isDesignMode) e da localização 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), o resultado (Escalated, Resolved, Abandon), a hora de início e fim 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

Pode configurar agentes para gerar transcrições melhoradas que incluam 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 depois ative Incluir detalhes ao nível do 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 ativas as transcrições melhoradas, a transcrição inclui um nodeTraceData tipo de atividade para cada nó que um tema invoca. 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. Para construir soluções de análise personalizadas, os clientes podem integrar as transcrições brutas nos seus pipelines de dados ou usar um complemento, como o Copilot Studio Kit.

A solução Conversation KPIs no Copilot Studio Kit analisa automaticamente as transcrições e preenche os dados agregados nas 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 dos agentes que têm 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. No Power Apps, selecione Settings>Definições avançadas.

    O portal Dynamics 365 abre numa nova aba.

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

  2. Selecione o caret ao lado de Definições. Em System, selecione Data Management.

    Captura de ecrã do menu de Definições, com Data Management destacado.

  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. Selecione Novo para iniciar o Assistente de Eliminação em Massa. No assistente, selecione Avançar.

  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, mantenha equals e insira "powervirtualagents".

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

  3. Selecione Avançar.

  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.

Porque é que não consigo ver as transcrições das minhas conversas na tabela ConversationTranscript Power Apps?

Os administradores podem impedir o salvamento de transcrições no Dataverse. Para mais informações sobre como as transcrições são guardadas e como gerir o acesso, consulte Controlar o acesso às transcrições.

Importante

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

Dicas para aproveitar ao máximo as transcrições da conversa

Use variáveis para armazenar dados relevantes para o conteúdo do seu agente ou para o utilizador do agente. Ao analisar a variável e o seu valor a partir da transcrição da conversa, pode filtrar ou segmentar 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