Entender os dados de sessão baixados do Copilot Studio

Você pode exibir, exportar e baixar sessões de interações do cliente com seu agente no Power Apps e no Copilot Studio.

Ao baixar informações de sessão do Copilot Studio, você obtém um subconjunto das informações disponíveis para download do Power Apps, na forma de um arquivo CSV (valor separado por vírgula). O arquivo CSV inclui a conversa real e algumas métricas e informações sobre a sessão (consulte Trabalhar com transcrições de sessão para obter uma lista de métricas incluídas no arquivo CSV). Para ver todas as atividades, baixe transcrições por meio do Power Apps.

ChatTranscript No campo, há um limite de 512 caracteres para cada resposta de bot. Todas as respostas de bot com mais de 512 caracteres mostram apenas os primeiros 512 caracteres no arquivo CSV. O limite de 512 caracteres é por resposta , não por sessão , e você pode ter várias respostas de bot em uma determinada sessão.

Você pode baixar transcrições de conversa dos últimos 29 dias diretamente do Copilot Studio.

Note

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

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

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

Pré-requisitos

Para visualizar as transcrições, certifique-se de que os seguintes pré-requisitos sejam atendidos:

  • Os dados do seu agente incluem sessões para pelo menos uma conversa. Seus dados não podem ser apenas processos ativados por gatilhos.

  • Você tem a função de segurança Visualizador de Transcrição do Bot. Somente os administradores podem conceder essa função atribuindo o papel de segurança Bot Transcript Viewer durante o compartilhamento de agente.

  • Todas as configurações para configurar a gravação e o download das transcrições estão ativadas.

    Note

    Por padrão, as configurações para configurar a gravação e o download das transcrições são ativadas em novos ambientes.

Baixar transcrições de sessão do agente

  1. Na página de Análises do seu agente, selecione o intervalo de datas que deseja baixar.

  2. Acima do cartão Visão geral, selecione Baixar sessões.

  3. No painel Baixar Sessões, selecione uma linha para baixar as transcrições de sessão para o período especificado.

    Note

    As sessões são divididas em fileiras que representam incrementos de um dia, com até 50.000 sessões cada.

    O download começa imediatamente. O arquivo é salvo no local padrão de download do seu navegador.

Trabalhar com transcrições de sessões

Um arquivo de transcrição de sessão é um arquivo CSV (valores separados por vírgula) que contém as seguintes informações:

  • SessionID: Um identificador único para cada sessão.

  • StartDateTime: Horário em que a sessão começou. As entradas são classificadas por esta coluna em ordem decrescente.

  • SessionOutcome: Resultado da sessão (Resolved, Escalated, Abandoned, Unengaged).

  • OutcomeReason: informações adicionais sobre o motivo do resultado da sessão.

  • IsResolvedImplied: Se for verdade, a sessão é resolvida porque foi concluída sem confirmação do usuário, mas sim com base na lógica do agente. Se falso, a sessão será resolvida porque o tópico End of Conversation é disparado e o usuário confirma que a interação foi um êxito. Este campo ficará vazio se o resultado for qualquer coisa diferente de resolved.

  • Turns: o número total de rodadas na sessão. Um turno, no contexto de transcrições de sessão do Copilot Studio, consiste em uma mensagem do usuário ou uma única resposta do agente.

  • ChatTranscript: transcrição da sessão no seguinte formato: "Usuário diz: <UserInput>; o agente diz: <CopilotResponse>;".

    • Os turnos de diálogo são separados por ponto e vírgula.
    • <CopilotResponse> não inclui as opções apresentadas ao usuário.

    Exemplo: User says: store hours; Bot says: Which store are you asking about?; User says: Bellevue; Bot says: Bellevue store is open from 10am to 7pm every day.;

  • InitialUserMessage: primeira mensagem digitada pelo usuário.

  • TopicName: Nome do último tópico criado que a sessão iniciou.

  • TopicId: Um identificador único do último tópico criado que a sessão desencadeou.

  • ChannelId: O canal onde essa sessão foi executada (por exemplo, directline, msteams, facebook, conversationconductor).

  • CSAT: o valor de satisfação do cliente (CSAT) no nível da sessão.

  • Comments: lista de todos os comentários de usuários para feedback de reações positivas (curtidas) e negativas (não curtidas).