Capturar telemetria com o Application Insights

Este artigo explica como capturar dados de telemetria do seu agente de Copilot Studio para utilização em Aplicação Azure Insights.

Para além das funcionalidades nativas de análise dentro do Copilot Studio, pode enviar dados de telemetria para o Application Insights. A telemetria oferece informações sobre o seu agente ao monitorizar:

• Mensagens registadas e eventos enviados de e para o seu agente
• Tópicos a desencadear durante conversas de utilizadores
• Eventos de telemetria personalizados que pode enviar a partir dos seus tópicos

Important

Application Insights é uma funcionalidade do Azure Monitor, uma ferramenta extensível de Gestão de Desempenho de Aplicações (APM) que pode usar para monitorizar as suas aplicações em tempo real. Requer uma subscrição a Microsoft Azure.

Ligue o seu agente do Copilot Studio ao Application Insights

Para ligar o seu agente ao Application Insights, adicione primeiro a sua chave de instrumentação à configuração do seu agente.

1. Aceda à página Definições do seu agente e selecione Avançadas.

2. Na secção Application Insights , introduza a cadeia de Conexão. Para saber como localizar o seu cadeia de ligação, consulte a documentação Azure Monitor.

3. Opcionalmente, pode escolher ativar uma das seguintes definições.

   • Registar atividades: Se ativado, o sistema regista detalhes das mensagens e eventos recebidos e enviados.

   • Propriedades de atividade sensíveis ao log: Se ativadas, os logs incluem os valores de certas propriedades que podem ser consideradas sensíveis em mensagens e eventos recebidos e saídos. As propriedades consideradas potencialmente sensíveis são userid, name, text, e speak (as propriedades de texto e fala aplicam-se apenas a mensagens).

Analisar telemetria de bots com o Application Insights

Depois de ligar o seu bot ao Application Insights, ele regista dados de telemetria quando os utilizadores interagem com o bot, incluindo durante os testes dentro do Copilot Studio. Para ver os dados de telemetria registados, vá à secção Logs do seu recurso Application Insights na Azure.

A partir daqui, pode usar consultas Kusto para consultar e analisar os seus dados. Veja consultas de exemplo.

Exemplos de consultas

Uma consulta pode ser tão simples como especificar uma única tabela, como customEvents, que mostra todos os eventos de telemetria personalizados registados a partir do Copilot Studio. Mas também pode usar consultas Kusto para restringir ainda mais os seus resultados, incluindo:

• Adicionar um intervalo de tempo
• Expandir os seus resultados usando dimensões personalizadas. Dimensões personalizadas são propriedades personalizadas que registas juntamente com os campos pré-definidos, como data/hora ou o nome do evento
• Adicionar uma cláusula where para limitar os dados devolvidos com base numa condição
• Usar mais funções Kusto incorporadas para determinar o que e como as informações são mostradas

A consulta de exemplo seguinte resulta num gráfico de linhas que mostra quantos utilizadores distintos comunicaram com o seu bot por dia nos últimos 14 dias.

let queryStartDate = ago(14d);
let queryEndDate = now();
let groupByInterval = 1d;
customEvents
| where timestamp > queryStartDate
| where timestamp < queryEndDate
| summarize uc=dcount(user_Id) by bin(timestamp, groupByInterval)
| render timechart

Important

Os dados dentro de alguns campos variam e são mais ou menos aplicáveis, dependendo do canal que está a ser usado. Por exemplo, só obtém uma contagem correta de utilizadores únicos na consulta se os utilizadores estiverem autenticados e os IDs de utilizador forem consistentes entre as conversas. Em cenários anónimos em que um ID de utilizador aleatório é gerado em cada conversa, o campo ID de utilizador é menos útil.

Exclua a telemetria das conversas de teste nas suas consultas

O seu bot regista a telemetria de todas as conversas, incluindo as que ocorrem no Copilot Studio durante os testes. Se quiser excluir a telemetria recolhida durante os testes, estenda a sua consulta usando a designMode dimensão personalizada que todos os eventos capturam, e use uma cláusula where na sua consulta.

O exemplo a seguir mostra todos os eventos personalizados, excluindo os capturados através da tela de teste.

customEvents
| extend isDesignMode = customDimensions['designMode']
| where isDesignMode == "False"

Dimensões Personalizadas

Grande parte dos dados específicos de atividade recebidos do Copilot Studio é armazenada no campo customDimensions. Pode ver um campo de dimensão personalizado a ser usado numa consulta para excluir telemetria de conversas de teste.

Campo	Description	Valores de Amostra
tipo	Tipo de atividade	message, conversationUpdate, event, invoke
channelId	Identificador do canal	emulator, directline, msteams, webchat
fromId	Identificador De	<id>
fromName	Nome de utilizador do cliente	John Bonham, Keith Moon, Steve Smith, Steve Gadd
região	Região de origem do cliente	en-us, zh-cn, en-GB, de-de, zh-CN
recipientId	Identificador do destinatário	<id>
recipientName	Nome do destinatário	John Bonham, Keith Moon, Steve Smith, Steve Gadd
enviar SMS	Texto na mensagem	find a coffee shop
designMode	A conversa aconteceu dentro da tela de teste	True / False

Visualizando resultados de monitorização (Pré-visualização)

Important

Este artigo contém documentação de pré-visualização do Microsoft Copilot Studio e está sujeito a alterações.

As funcionalidades de pré-visualização não se destinam a ser utilizadas em ambiente de produção e podem ter funcionalidades restritas. Esses recursos estão disponíveis antes de um lançamento oficial para que você possa obter acesso antecipado e fornecer feedback.

Se você estiver criando um agente pronto para produção, consulte Visão geral do Microsoft Copilot Studio.

A vista do painel do Copilot Studio utiliza sinais do Azure Monitor Application Insights. Consulta o Application Insights através de Workbooks do Azure e cria visualizações.

Estas vistas reúnem métricas-chave, como o total de conversas, latência, exceções, utilização de ferramentas e análises de temas, numa única vista. A visão única fornece transparência às equipes para que possam acompanhar a integridade e a qualidade operacionais, entender tendências e avaliar continuamente para melhorar sua aplicação.

Para aceder e utilizar a vista de monitorização integrada no Application Insights, siga estes passos:

1. Vá para o recurso do Application Insights.
2. Selecione a guia Monitoramento no painel de navegação esquerdo.
3. No separador Monitorização , selecione Livros de Exercícios. Abra Copilot Studio Dashboard na galeria de cadernos de exercícios.

Personalize e partilhe o seu dashboard

O Application Insights é uma ferramenta poderosa para monitorização do desempenho das aplicações (APM) que fornece informações sobre a saúde e desempenho das suas aplicações.

O painel abre como um livro de trabalho editável onde podes personalizar o livro e guardá-lo conforme as tuas necessidades.

1. Selecione Editar na barra de comandos.

   

2. Modifique os elementos conforme necessário para o seu caso de uso. Selecione os três pontos (...) para um elemento editar, adicionar, mover ou redimensionar, clonar ou remover. Por exemplo, podes adicionar um tile que usa KQL para acompanhar um atributo personalizado que estás a recolher e que a vista incorporada não mostra.

   

3. Seleciona Guardar para guardar as tuas alterações mais recentes e cria diferentes vistas conforme necessário.

   

4. Selecione o ícone de Partilhar na barra de comandos para partilhar com a sua equipa.

   Observação

   Quando partilha este livro de exercícios com os membros da sua equipa, eles devem ter pelo menos o papel de Leitor para o recurso Application Insights ligado para visualizar a informação apresentada.