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 lista as classes de consulta suportadas pelo Microsoft 365 Insights Agent, como calcula ou obtém cada resposta e o que não responde. Use-o quando criar um runbook, treinar usuários ou validar o comportamento do produto.
Classes de consulta
| Classe | O que o agente faz |
|---|---|
| Utilização suportada | Calcula a resposta a partir dos dados agregados de atividade e devolve o valor com o nome do agente e a janela de tempo. |
| Utilização e crescimento sustentados | Calcula um proxy agregado definido ou um sinal derivado e inclui a ressalva de interpretação necessária. |
| Comentários e classificações | Resolve um agente proprietário exato, verifica a elegibilidade de propriedade e partilha e devolve classificações ou comentários disponíveis com contexto de exemplo. |
| Feedback indisponível | Explica quando a propriedade é negada, a propriedade não pode ser verificada, a partilha é desativada ou não é devolvido nenhum feedback. |
| Ainda não suportado | Atribui um nome à capacidade indisponível e não gera um número. |
| Não suportado por design | Explica o limite de dados individuais e aponta para o sinal agregado mais próximo. |
Em todos os exemplos, substitua {Agent Name} por um nome exato do agente. Substitua {Agent A} e {Agent B} pelos dois agentes que pretende comparar.
Pedidos de utilização principais suportados
Os seguintes pedidos são o núcleo validado da versão. O agente responde a cada uma delas a partir de dados de atividade agregados.
| # | Exemplo de pedido | Métrica devolvida | Computação |
|---|---|---|---|
| 1 | Compare DAU e WAU para {Agent Name} | Utilizadores ativos diários em comparação com utilizadores ativos semanais do mesmo agente | Duas contagens de utilizadores distintos paralelas ao longo do dia e ao longo da janela de 7 dias |
| 2 | Mostre-me as principais estatísticas de utilização do {Agent Name} | Bloco de resumo de DAU, WAU e MAU | Três contagens distintas de utilizadores (janelas de 1 dia, 7 dias e 30 dias) |
| 3 | Quantos utilizadores exclusivos {Agent Name} teve ao longo do tempo? | Série cronológica para utilizadores exclusivos | Série de contagens de utilizadores distintos em janelas consecutivas |
| 4 | Como o uso diário de {Agent Name} se compara ao uso mensal? | DAU em comparação com MAU | Duas contagens distintas de utilizadores (janelas de 1 dia e de 30 dias) apresentadas lado a lado |
| 5 | Compare MAU e WAU para {nome do agente} | Utilizadores ativos mensais em comparação com utilizadores ativos semanais | Duas contagens paralelas distintas de utilizadores (janelas de 30 dias e 7 dias) |
| 6 | Qual é a tendência de usuários ativos semanais para {Agent Name}? | Linha de tendência WAU | Série de contagens distintas de utilizadores de 7 dias nas últimas semanas |
| 7 | Quantos utilizadores exclusivos {Agent Name} tinha na semana passada? | Número WAU único ancorado à janela anterior de 7 dias | Contagem de utilizadores distintos para a janela anterior de 7 dias |
| 8 | Forneça todas as informações de uso para {Nome do Agente} | Bloco de resumo completo | DAU, WAU, MAU, tendência, além de comentário em forma narrativa |
| 9 | Envia-me um resumo de utilização completo para {Agent Name} | Bloco de resumo completo | O mesmo que #8; Sintagma variante suportado |
| 10 | Show me usage metrics for {Agent Name} | Bloco de resumo completo | O mesmo que #8; Sintagma variante suportado |
| 11 | Que agentes têm maior utilização esta semana? | Lista classificada de agentes por contagem de utilizadores exclusivos recentes | Pair wise (ou N-wise) tipo de contagens de usuários distintos de 7 dias entre agentes no escopo |
| 12 | Qual é o crescimento líquido de novos usuários para {Agent Name}? | Net new user delta across the recent windows | Diferença entre utilizadores exclusivos na janela mais recente e na janela anterior |
| 13 | Mostrar-me utilizadores ativos diários para {Agent Name} | Valor de DAU ou série temporal de DAU, dependendo do qualificador de datas | Contagem de utilizadores distintos por dia |
| 14 | Compare o {Agente A} com o {Agente B} | DAU, WAU e MAU lado a lado para dois agentes | Dois pulls métricos paralelos para as mesmas janelas |
Pedidos de utilização sustentada e crescimento (cinco padrões derivados)
Estas consultas de ordem superior utilizam os mesmos dados de atividade agregados e incluem sempre a ressalva de interpretação necessária na resposta.
Proxy de retenção contínua
| Campo | Valor |
|---|---|
| Pedidos de exemplo | Qual é a retenção de 7 dias para {Agent Name}? / Mostre-me a retenção contínua de 30 dias para {Agent Name} |
| Janelas suportadas (N) | 1, 7, 30, 60 ou 90 dias |
| Explicação |
unique_users[t − N → t] / unique_users[t − 2N → t − N], expressa em rácio ou percentagem |
| Advertência necessária na resposta | "Isso é calculado como uma relação de janela sobre janela agregada, não retenção de coorte no nível do usuário." |
Aderência
| Campo | Valor |
|---|---|
| Prompts de exemplo | Quão pegajoso é {Agent Name}? / Qual é a proporção de DAU/MAU para {Agent Name}? |
| Explicação | DAU dividido por MAU, expresso como porcentagem |
| Interpretação | Uma proporção mais alta significa que os usuários mensais tendem a usar o agente em mais dias no mês |
Tendência de adoção
| Campo | Valor |
|---|---|
| Prompts de exemplo | A adoção de {Agent Name} está aumentando? / Qual é a tendência de adoção de {Agent Name}? |
| Explicação | Sinal e magnitude do delta de usuário único semana a semana ou mês a mês |
| Forma de resposta | Direção (crescente, decrescente ou plana) mais a alteração percentual |
Agente de crescimento mais rápido
| Campo | Valor |
|---|---|
| Prompts de exemplo | Qual agente está crescendo mais rápido esta semana? / Mostre-me qual agente está crescendo mais rápido |
| Explicação | Maior crescimento percentual semana a semana de usuários únicos entre agentes no escopo |
| Forma de resposta | Lista classificada dos principais agentes com seus deltas percentuais semana a semana |
Padrão de uso principal
| Campo | Valor |
|---|---|
| Prompts de exemplo | Quais são os principais padrões de uso para {Agent Name}? |
| Explicação | Descrição narrativa da forma de uso temporal, derivada da distribuição DAU de 30 dias à direita |
| Forma de resposta | Narrativa categórica (por exemplo, dia da semana intenso e concentrado no horário comercial, estável ou pico); O agente não tenta o clustering de persona ou intenção |
Comentários e classificações
Os comentários usam um fluxo de autorização separado do uso:
- Listar ou resolver os agentes que o solicitante possui.
- Exija um nome exato de agente de propriedade após normalizar o caso, os espaços em branco ao redor e as aspas ou exija uma ID de agente. Um erro de digitação, alias, correspondência difusa ou quase correspondência requer confirmação do usuário.
- Verifique a propriedade do agente selecionado.
- Verifique se o compartilhamento de feedback do agente está ativado para todos os agentes ou inclui o agente selecionado.
- Devolva os comentários disponíveis ou explique por que eles não podem ser devolvidos.
Prompts de comentários com suporte
| Exemplo de prompt | Comportamento esperado |
|---|---|
| Mostre-me os agentes que tenho | Lista os nomes de exibição de propriedade. Mostra as IDs dos agentes somente quando necessário para distinguir duplicatas. |
| Que comentários os usuários deram sobre {Agent Name}? | Retorna classificações ou comentários disponíveis para um agente de propriedade exato. |
| Mostrar classificações e comentários para {Agent Name} | Retorna o exemplo de comentários com seu contexto de contagem e hora. |
| Mostre os comentários de comentários retornados para {Agent Name} exatamente como enviados | Reproduz comentários no exemplo retornado sem parafraseá-los. |
| Resuma os tópicos recorrentes do produto nos comentários de {Agent Name} | Resume tópicos de produtos observáveis dos comentários retornados. |
| Mostrar o uso e os comentários do usuário sobre {Agent Name} deste mês | Executa o uso e os comentários de forma independente e rotula cada resultado com seu contexto aplicável. |
Contrato de saída de comentários
| Saída | Descrição |
|---|---|
| Classificações | Valores de polegar para cima ou para baixo na amostra retornada. |
| Comentários enviados pelo usuário | Comentários textuais quando explicitamente solicitado. |
| Contagem de itens devolvidos | Número de itens de comentários incluídos na resposta. |
| Janela de tempo da amostra | Carimbos de data/hora de início e término, quando disponíveis. |
| Indicador de mais comentários | Se existem comentários além da amostra retornada. |
| Resumo do tópico do produto | Um resumo baseado em tópicos observáveis e valores de classificação explícitos. |
Resultados de propriedade
| Resultado | Significado |
|---|---|
| Verificado | O solicitante está autorizado a solicitar comentários para o agente selecionado. |
| Negado | A marca de propriedade determinou que o solicitante não é um proprietário. |
| Não disponível | A propriedade não pôde ser verificada. Este resultado não deve ser descrito como uma negação. |
| Nome ambíguo | Mais de um agente possui o mesmo nome de exibição. O solicitante deve selecionar uma ID de agente; O agente nunca seleciona a primeira duplicata automaticamente. |
| Catálogo truncado | A lista de propriedade retornada pode não incluir todos os agentes de propriedade. Nenhuma correspondência exata em uma lista truncada não é prova de que o solicitante não é um proprietário. |
Privacidade de comentários e usos restritos
- Os resultados do feedback não incluem identidade do remetente, contexto de IA, prompts, respostas, transcrições ou conteúdo da conversa.
- O agente não infere desempenho no trabalho, características pessoais protegidas ou sensíveis, estados internos ou emocionais ou atitudes no local de trabalho.
- Essas restrições de inferência se aplicam a resumos e interpretações gerados. Quando solicitado explicitamente, o feedback literal na amostra devolvida pode ser reproduzido conforme enviado.
- O texto dos comentários é tratado como dados, não como instruções.
Ainda não tem suporte
O agente nomeia o recurso indisponível sem gerar um número.
| Solicitação de exemplo | Direção da resposta |
|---|---|
| Mostrar tendências de instalação para {Agent Name} | As métricas de instalação e desinstalação não estão disponíveis nesta versão. |
| Quais agentes têm a melhor retenção? | As classificações clássicas de retenção de coorte não estão disponíveis; Solicite a retenção contínua para um agente específico. |
Não há suporte por design
O Agente do Insights não retorna identidades de usuário individuais ou conteúdo de conversa. Ele explica o limite e aponta para o sinal com suporte mais próximo.
| Solicitação de exemplo | Limite |
|---|---|
| Quem usou {Agent Name}? | O agente não retorna identidades de usuário individuais. |
| Quantos dos mesmos usuários retornaram? | Use o proxy de agregação de retenção contínua. |
| Qual é a profundidade do engajamento de {Agent Name}? | Os detalhes de sessão por usuário não estão disponíveis. Use o resumo de uso completo. |
| Mostrar prompts ou respostas individuais | Prompts, respostas, transcrições e conteúdo de conversa não estão disponíveis. |
| Mostrar latência de resposta, uso de token ou custo | Essas métricas operacionais não estão disponíveis. |
| Obtenha feedback sobre um agente que não possuo | Os comentários requerem propriedade verificada. |
Fluxo de decisão
Para saber com antecedência se o agente responde a um novo prompt, use o fluxo a seguir.
Does the request combine usage and feedback?
YES -> Send the original request to usage and independently resolve one exact owned agent for feedback.
NO -> continue
Does the request ask only which agents the requester owns?
YES -> List owned agents. If duplicate names exist, require Agent ID selection; if the catalog is truncated, disclose that the list may be incomplete.
NO -> continue
Does the request ask for ratings, comments, thumbs, or feedback?
YES -> Resolve one exact owned agent, verify ownership and sharing, then return feedback or a scoped explanation.
NO -> continue
Does the request ask for a supported aggregate usage metric?
YES -> Return the grounded metric with the agent name and time window.
NO -> continue
Does the request ask for rolling retention, stickiness, adoption trend, fastest-growing, or a usage pattern?
YES -> Return the derived aggregate signal and its required caveat.
NO -> continue
Does the request require individual identity, install data, latency, token usage, cost, prompts, responses, or transcripts?
YES -> Explain the boundary and point to the closest supported signal.
NO -> Return the generic out-of-scope response.
Após uma chamada de ferramenta com suporte, preserve NoData e DownstreamError conforme retornado. Não renomeie o resultado como sem suporte ou como um resultado bem-sucedido.