Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo aborda como você pode capturar dados de telemetria do agente do Copilot Studio a ser usado no Azure Application Insights.
Além dos recursos de análise nativos dentro do Copilot Studio, você pode enviar dados telemétricos para o Application Insights. A telemetria oferece insights sobre seu agente rastreando:
- Mensagens registradas e eventos enviados de e para seu agente
- Tópicos a serem acionados durante as conversas com usuários
- Eventos de telemetria personalizados que podem ser enviados dos seus tópicos
Importante
O Application Insights é um recurso do Azure Monitor, uma ferramenta APM (gerenciamento de desempenho de aplicativos) extensível que permite a você monitorar os aplicativos ativos. Exige uma assinatura para o Microsoft Azure.
Conectar o agente do Copilot Studio ao Application Insights
Para conectar o agente ao Application Insights, você primeiro precisa adicionar a chave de instrumentação à configuração do agente.
Acesse a página Configurações de seu agente e selecione Avançado.
Dentro da seção Application Insights, popule a configuração Cadeia de conexão. Veja a documentação do Azure Monitor para descobrir como localizar sua cadeia de conexão.
Opcionalmente, você pode habilitar uma das seguintes configurações.
Registrar atividades: se habilitado, os detalhes de mensagens e eventos de entrada/saída serão registrados.
Registrar propriedades de atividade confidenciais: se habilitado, os valores de determinadas propriedades que possam ser consideradas confidenciais em mensagens e eventos de entrada/saída serão incluídos nos logs. As propriedades que são consideradas potencialmente confidenciais são userid, name, text e speak (as propriedades text e speak aplicam-se apenas a mensagens).
Analisar telemetria de bot com o Application Insights
Depois de conectar o bot ao Application Insights, os dados de telemetria são registrados quando os usuários interagem com o bot, inclusive durante o teste no Copilot Studio. Para consultar os dados telemétricos registrados, navegue até a seção Logs do recurso do Application Insights no Azure.
Aqui, você pode usar consultas do Kusto para consultar e analisar dados. Veja consultas de exemplo.
Consultas de exemplo
Uma consulta pode ser tão simples quanto especificar uma única tabela, como customEvents, que mostra todos os eventos de telemetria personalizados registrados pelo Copilot Studio. Mas você também pode usar consultas do Kusto para restringir ainda mais seus resultados, incluindo;
- Adicionar um intervalo de tempo
- Estender seus resultados usando dimensões personalizadas As dimensões personalizadas são propriedades personalizadas que são registradas junto com os campos predefinidos, como o carimbo de data/hora ou o nome do evento
- Uma cláusula where para limitar os dados retornados com base em uma condição
- Usar mais funções do Kusto internas para determinar quais e como as informações são mostradas
A consulta de exemplo abaixo resulta em um gráfico de linhas que mostra quantos usuários diferentes se comunicaram com 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
Importante
Os dados dentro de alguns campos variam e são mais ou menos aplicáveis, dependendo do canal que está sendo usado. Por exemplo, você só obterá uma contagem correta de usuários exclusivos na consulta se os usuários forem autenticados e suas IDs de usuário forem consistentes entre conversas. Em cenários anônimos em que uma ID de usuário aleatória é gerada em cada conversa, o campo ID do usuário é menos útil.
Excluir a telemetria de conversas de teste das suas consultas
O bot registra a telemetria de todas as conversas, inclusive aquelas que acontecem durante os testes do Copilot Studio. Se quiser excluir a telemetria coletada durante o teste, você poderá estender sua consulta com a dimensão personalizada designMode que é capturada em todos os eventos e usar uma cláusula where na sua consulta.
O exemplo a seguir mostra todos os eventos personalizados, excluindo aqueles capturados por meio da tela de teste.
customEvents
| extend isDesignMode = customDimensions['designMode']
| where isDesignMode == "False"
Dimensões Personalizadas
Grande parte dos dados de atividade específicos recebidos do Copilot Studio são armazenados no campo customDimensions. Você pode ver um campo de dimensão personalizada sendo usado em uma consulta para excluir a telemetria das conversas de teste.
| Campo | Descrição | Valores de exemplo |
|---|---|---|
| tipo | Tipo de atividade |
message, conversationUpdate, , eventinvoke |
| channelId | Identificador do canal |
emulator, directline, , msteamswebchat |
| fromId | Identificador De | <id> |
| fromName | Nome de usuário do cliente |
John Bonham, Keith Moon, , Steve SmithSteve Gadd |
| localidade | Localidade de origem do cliente |
en-us, zh-cn, en-GB, , de-dezh-CN |
| recipientId | Identificador do destinatário | <id> |
| recipientName | Nome do destinatário |
John Bonham, Keith Moon, , Steve SmithSteve Gadd |
| enviar SMS | Texto na mensagem | find a coffee shop |
| designMode | A conversa aconteceu dentro da tela de teste | True / False |
Exibindo resultados de monitoramento (versão prévia)
Importante
Este artigo contém a documentação de versão prévia do Microsoft Copilot Studio e está sujeito a alterações.
Os recursos de visualização não são destinados ao uso de produção e podem ter funcionalidade restrita. Esses recursos estão disponíveis antes de um lançamento oficial para que você possa obter acesso antecipado e fornecer comentários.
Se você estiver criando um agente pronto para produção, confira a visão geral do Microsoft Copilot Studio.
A exibição de painel do Copilot Studio usa sinais do Azure Monitor Application Insights, consultando-o por meio de Pastas de Trabalho do Azure e criando visualizações.
Essas exibições são projetadas para trazer métricas importantes, como total de conversas, latência, exceções, uso de ferramentas e análise de tópicos em uma única exibição. A exibição única fornece às equipes transparência para que elas possam acompanhar a integridade e a qualidade operacionais, entender tendências e avaliar continuamente para melhorar a aplicação.
Siga estas etapas para acessar e utilizar o modo de exibição de monitoramento interno no Application Insights:
- Navegue até o Application Insights.
- Selecione a guia Monitoramento no painel de navegação esquerdo.
- Na guia Monitoramento , selecione Pastas de Trabalho e abra o Copilot Studio Dashboard na galeria de pastas de trabalho.
Personalizar e compartilhar seu painel
O Application Insights é uma ferramenta poderosa para o APM (monitoramento de desempenho de aplicativos) que fornece insights sobre a integridade e o desempenho de seus aplicativos.
O painel é aberto como uma pasta de trabalho editável em que você pode personalizar a pasta de trabalho e salvar de acordo com suas necessidades.
Selecione Editar na barra de comandos.
Modifique os elementos conforme necessário para seu caso de uso. Selecione os três pontos (...) para que um elemento possa editar, adicionar, mover ou redimensionar, clonar ou removê-lo. Por exemplo, você pode adicionar um bloco usando KQL para acompanhar um atributo personalizado que está coletando e que nossa visualização embutida não mostra.
Salve as alterações mais recentes e crie modos de exibição diferentes conforme necessário selecionando Salvar.
Compartilhe com sua equipe selecionando o ícone Compartilhar na barra de comandos.
Observação
Quando você compartilha a pasta de trabalho com os membros da equipe, eles devem ter, pelo menos, a função Leitor para o recurso do Application Insights conectado a fim de exibir as informações.
