Telemetria ao nível do agente com Application Insights

Note

As funcionalidades deste artigo são suportadas pela estrutura padrão, que utiliza as opções de faturação descritas em Licenciamento para agentes suportados pela estrutura padrão. Aprenda a aceder a funcionalidades padrão nos agentes e fluxos de agentes padrão do Access.

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

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.

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

    • Detalhes da conversa de registo: Inclui ID de utilizador, nome de utilizador e texto da mensagem (para atividades de Mensagem). Quando o rastreamento OpenTelemetry está ativado, esta configuração também controla os argumentos de entrada da ferramenta e os resultados de saída da ferramenta capturados em spans.

    • Propriedades de atividade sensíveis aos logs: Se ativadas, os logs incluem os valores de certas propriedades que podem ser consideradas sensíveis em mensagens e eventos recebidos e saídos.

    • Eventos de execução de nó: Registar um evento cada vez que um nó dentro de um tópico é executado.

Analisar telemetria de bots com o Application Insights

Depois de ligar o seu agente ao Application Insights, ele regista os dados de telemetria quando os utilizadores interagem com o agente, incluindo durante os testes dentro do Copilot Studio. Para visualizar os dados de telemetria registados, aceda à secção Logs do seu recurso Application Insights no Azure. Aqui, pode usar consultas Kusto para consultar e analisar os seus dados. Saiba mais em exemplos de consultas.

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.

Field Description Valores de exemplo
tipo Tipo de atividade message, conversationUpdate, event, invoke
channelId Identificador do canal emulator, directline, msteams, webchat
fromId Do Identificador <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

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

Captura de tela da galeria de pastas de trabalho do Application Insights.

Captura de tela da pasta de trabalho do Copilot Studio.

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.

    Captura de ecrã da edição do workbook Application Insights.

  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.

    Captura de ecrã da modificação de um elemento no livro de exercícios Application Insights.

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

    Captura de ecrã de guardar o relatório do Application Insights.

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

    Note

    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.

    Captura de ecrã da partilha de livro de exercícios do Application Insights.

Desativar a telemetria Application Insights ao nível do agente

Para evitar que os criadores ativem a telemetria do Application Insights de nível de agente, bloqueie o conector Application Insights no Copilot Studio através de uma política de dados no centro de administração do Power Platform.

Antes de começar, certifique-se de que tem:

  • Função de administrador do Power Platform ou de administrador do Dynamics 365 ao nível do tenant no Microsoft Entra ID.
  • Acesso ao ambiente alvo onde os agentes do Copilot Studio são implantados.

Para desativar a telemetria Application Insights ao nível do agente, siga estes passos:

  1. No centro de administração do Power Platform, selecione Segurança no painel esquerdo, selecione Dados e privacidade, e depois selecione Política de dados.
  2. Crie uma nova política de dados ou edite uma política existente.
  3. Selecione os ambientes a que a política deve ser aplicada e selecione Adicionar à política.
  4. No passo Conectores (nova política) ou Conectores Pré-construídos (política existente), pesquise por Application Insights no Copilot Studio e selecione-o.
  5. Selecione Bloco para mover Application Insights no Copilot Studio para o grupo de conectores Bloqueados.
  6. Complete os restantes passos de configuração da política e publique a política.

Note

O conector poderá aparecer na lista de conectores incorporados da Microsoft como Application Insights in Copilot Studio.

Quando a política de dados é aplicada, o conector Application Insights no Copilot Studio fica bloqueado para os ambientes visados. Utilizadores e criadores não podem usar este conector em ambientes regidos pela política.

  • Last updated on