Referência de pedidos e capacidades para o Microsoft 365 Insights Agent

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:

  1. Listar ou resolver os agentes que o solicitante possui.
  2. 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.
  3. Verifique a propriedade do agente selecionado.
  4. Verifique se o compartilhamento de feedback do agente está ativado para todos os agentes ou inclui o agente selecionado.
  5. 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.