Análises do Copilot Studio Mostram Zero Sessões: Como Corrigir

Você abre a guia Análises no Copilot Studio e vê zero sessões, mesmo com o copiloto publicado e usuários interagindo. Isso geralmente acontece porque o pipeline de telemetria exige um conjunto específico de permissões e regras de roteamento de dados que não estão configuradas por padrão. O painel de Análises depende do Application Insights e dos logs de atividade do Microsoft Graph para contar cada conversa de usuário. Este artigo explica por que o contador de sessões fica em zero e fornece as etapas exatas para habilitar a telemetria e fazer suas análises serem preenchidas corretamente.

Por que as Análises do Copilot Studio Mostram Zero Sessões

As análises do Copilot Studio não são preenchidas por padrão. O sistema exige uma conexão de telemetria ativa entre seu copiloto e um recurso do Azure Application Insights. Quando a telemetria está desabilitada ou mal configurada, a guia Análises não consegue contar nenhuma interação do usuário. A causa raiz é quase sempre uma de três coisas: a telemetria está desligada nas configurações do Copilot Studio, a chave de instrumentação do Application Insights está ausente ou incorreta, ou a taxa de amostragem de dados no Application Insights está abaixo de 100% e está descartando registros de sessão antes que eles cheguem ao pipeline de análises.

Uma causa secundária envolve o filtro de intervalo de datas das Análises. Se o filtro estiver definido para um período anterior à ativação da telemetria, o painel mostrará zero sessões mesmo que a telemetria esteja funcionando agora. O mesmo sintoma pode ocorrer se o copiloto foi publicado, mas nenhum usuário iniciou uma conversa dentro do período de tempo selecionado.

Como Funciona o Pipeline de Telemetria

Cada vez que um usuário envia uma mensagem para seu copiloto, o Copilot Studio envia um evento de telemetria para o recurso Application Insights vinculado. O Application Insights armazena esses eventos e o painel de Análises os consulta para calcular as contagens de sessão. Se o vínculo entre o Copilot Studio e o Application Insights estiver quebrado, nenhum evento é armazenado e o painel retorna zero. O pipeline também depende das permissões corretas da assinatura do Azure e do grupo de recursos. A conta que você usa para configurar a telemetria deve ter pelo menos acesso de Colaborador ao recurso Application Insights.

Etapas para Ativar a Telemetria e Restaurar os Dados de Sessão

Siga estas etapas em ordem. Não pule nenhuma etapa. Após concluir todas as etapas, aguarde até 15 minutos para que os dados de sessão apareçam na guia Análises.

1. Abra seu copiloto no Copilot Studio
   Entre no Copilot Studio em copilotstudio.microsoft.com. Selecione o copiloto que mostra zero sessões. Clique na guia Configurações na barra de navegação superior e depois em Geral.
2. Ative a telemetria
   Na página de configurações Gerais, localize a seção Telemetria. Coloque o botão de alternância em Ligado. Se o botão já estiver Ligado, desligue-o, salve, ligue-o novamente e salve. Isso redefine a conexão de telemetria.
3. Vincule ou verifique o recurso Application Insights
   Abaixo do botão de telemetria, clique em Selecionar recurso Application Insights. Escolha a assinatura do Azure correta e o recurso Application Insights que deve receber os dados de telemetria. Se nenhum recurso aparecer, crie um no portal do Azure primeiro. Clique em Salvar.
4. Defina a amostragem de dados para 100% no Application Insights
   Abra o portal do Azure em portal.azure.com. Navegue até seu recurso Application Insights. Em Configurar, clique em Uso e custos estimados. Clique em Amostragem de dados. Defina a porcentagem de amostragem para 100%. Clique em Salvar. Amostragem abaixo de 100% descarta uma porcentagem dos registros de sessão, o que pode fazer o painel de Análises mostrar zero sessões.
5. Verifique a chave de instrumentação
   No portal do Azure, vá para seu recurso Application Insights. Em Configurar, clique em Propriedades. Copie a Chave de Instrumentação. No Copilot Studio, vá em Configurações > Geral > Telemetria e confirme se a chave corresponde. Se não corresponder, cole a chave correta e salve.
6. Ajuste o intervalo de datas das Análises
   No Copilot Studio, clique na guia Análises. Defina o filtro de intervalo de datas para Últimos 7 dias ou um intervalo personalizado que inclua hoje. Se o filtro estiver definido para uma data passada em que a telemetria estava desligada, o painel ainda mostrará zero sessões.
7. Publique e teste o copiloto
   Clique no botão Publicar na barra de navegação superior. Após publicar, abra o copiloto em um ambiente de teste ou no site de demonstração. Envie pelo menos três mensagens para gerar uma sessão. Aguarde 15 minutos e atualize a guia Análises. As sessões devem aparecer agora.

Se o Copilot Studio Ainda Mostrar Zero Sessões Após a Correção Principal

Análises do Copilot Studio mostram zero sessões, mas a telemetria está Ligada

Se a telemetria estiver Ligada e a chave de instrumentação estiver correta, verifique as permissões da assinatura do Azure. A conta que configurou o vínculo do Application Insights deve ter acesso de Colaborador ao recurso Application Insights. Se a conta tiver apenas acesso de Leitor, a conexão de telemetria falhará silenciosamente. Peça ao administrador do Azure para atribuir a função de Colaborador à sua conta ou à entidade de serviço do Copilot Studio. Após a atribuição da função, repita as etapas de configuração da telemetria desde o início.

Análises do Copilot Studio mostram dados, mas as sessões estão ausentes para certos canais

Os dados de telemetria fluem apenas de canais configurados para enviar eventos ao Application Insights. Canais personalizados criados com o Bot Framework SDK exigem middleware de telemetria explícito. Se você estiver usando um canal personalizado, adicione o middleware de telemetria do Application Insights ao código do seu bot. Para o Microsoft Teams, a telemetria integrada deve funcionar automaticamente após a configuração principal estar completa.

Análises do Copilot Studio mostram zero sessões após uma migração do Azure

Se você moveu recentemente seu recurso Application Insights para uma assinatura ou grupo de recursos diferente do Azure, a chave de instrumentação muda. Você deve atualizar a chave no Copilot Studio. Vá em Configurações > Geral > Telemetria, remova o recurso antigo e selecione o novo. Salve e publique o copiloto novamente.

Opções de Telemetria do Copilot Studio: Integrada vs. Application Insights Personalizado

Item	Telemetria Integrada	Application Insights Personalizado
Local de configuração	Copilot Studio > Configurações > Geral > Telemetria	Portal do Azure > Recurso Application Insights > Chave de Instrumentação
Controle de amostragem de dados	Não disponível — usa o padrão do Application Insights	Configurável em Uso e custos estimados > Amostragem de dados
Rastreamento de sessões	Automático após telemetria Ligada	Requer código personalizado para segmentação avançada de sessões
Período de retenção	90 dias	Configurável de 30 a 730 dias
Custo	Incluso na licença do Copilot Studio	Cobranças adicionais de consumo do Azure se aplicam

Use a telemetria integrada para análises de sessão padrão. Mude para um recurso Application Insights personalizado apenas se precisar de retenção de dados mais longa ou rastreamento de eventos personalizados.

Agora você pode verificar se o pipeline de telemetria está configurado corretamente e se a guia Análises mostra contagens de sessão. Para confirmar a conectividade de ponta a ponta, envie uma mensagem de teste do site de demonstração e verifique a guia Live Metrics no Application Insights em até 60 segundos. Para monitoramento contínuo, configure um alerta do Azure Monitor na contagem de falhas do Application Insights para detectar interrupções de telemetria antes que elas afetem seus relatórios de análise.