Entender os dados de sessão baixados do Copilot Studio

Note

Este artigo se aplica a múltiplos chicotes. O arcabouço que você usa afeta o faturamento, as funcionalidades e as capacidades daquilo que você desenvolve.

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

Importante

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

  • Microsoft Dataverse para ambientes do Teams
  • agentes Microsoft 365 Copilot

Quando você baixa informações de sessão do Copilot Studio, recebe um subconjunto das informações dos últimos 28 dias, 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 ou alterar o período padrão de retenção do Dataverse, você pode baixar as transcrições pelo 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.

Note

Os dados de transcrição são mantidos no armazenamento do Copilot Studio por até 28 dias para suportar a funcionalidade adequada do agente e são automaticamente excluídos após esse período.

Se um administrador desativou a capacidade dos criadores de visualizar ou baixar transcrições, e você precisar exportar ou obter uma cópia desses dados, crie um novo chamado de suporte.

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

Note

As respostas do agente que usam SharePoint como fonte de conhecimento não estão incluídas nas transcrições de conversa. Quando SharePoint é usado como uma fonte de conhecimento, as transcrições de conversa incluem a pergunta e o conteúdo dos documentos de origem usados para gerar a resposta (o search_results campo). No entanto, a resposta não está incluída, e é marcada como REDACTED.

  1. Na página do Monitor 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 linhas que representam intervalos de um dia, com até 50.000 sessões em cada uma.

    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 essa 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).

  • Last updated on