Référence d’invite et de fonctionnalités pour l’agent Microsoft 365 Insights

Cet article répertorie les classes de requête que l’agent Microsoft 365 Insights prend en charge, la façon dont il calcule ou récupère chaque réponse et ce qu’il ne répond pas. Utilisez-le lorsque vous créez un runbook, formez des utilisateurs ou validez le comportement du produit.

Classes de requête

Classe Ce que fait l’agent
Utilisation prise en charge Calcule la réponse à partir des données d’activité agrégées et renvoie la valeur avec le nom de l’agent et la fenêtre de temps.
Utilisation et croissance soutenues Calcule un indicateur indirect agrégé défini ou un signal dérivé et inclut la mise en garde d’interprétation requise.
Votre avis et évaluations Résout un agent détenu exactement, vérifie l’éligibilité à la propriété et au partage, et renvoie les évaluations ou commentaires disponibles avec un exemple de contexte.
Commentaires non disponibles Explique quand la propriété est refusée, la propriété ne peut pas être vérifiée, le partage est désactivé ou aucun retour n’est retourné.
Pas encore pris en charge Nommez la fonctionnalité indisponible et ne génère pas de nombre.
Non pris en charge par conception Explique la limite des données individuelles et pointe vers le signal agrégé le plus proche.

Dans chaque exemple, remplacez-le {Agent Name} par un nom d’agent exact. Remplacez {Agent A} et {Agent B} par les deux agents que vous souhaitez comparer.

Invites d’utilisation du noyau prises en charge

Les invites suivantes constituent le cœur validé de la version. L’agent répond à chacune d’entre elles à partir des données d’activité agrégées.

# Exemple d’invite Métrique renvoyée Calcul
1 Comparer DAU et WAU pour {Agent Name} Utilisateurs actifs quotidiens par rapport aux utilisateurs actifs hebdomadaires pour le même agent Deux nombres d’utilisateurs distincts parallèles sur la journée et sur la fenêtre de 7 jours
2 Afficher les statistiques d’utilisation des clés de {Nom de l’agent} Bloc de résumé DAU, WAU et MAU Trois nombres d’utilisateurs distincts (fenêtres de 1 jour, 7 jours et 30 jours)
3 Combien d’utilisateurs uniques {Nom de l’agent} a-t-il eu au fil du temps ? Série chronologique d’utilisateur unique Série de nombres d’utilisateurs distincts sur des fenêtres consécutives
4 Comment l’utilisation quotidienne de {Nom de l’agent} se compare-t-elle à l’utilisation mensuelle ? DAU comparé à MAU Deux nombres d’utilisateurs distincts (fenêtres d’un jour et de 30 jours) affichés côte à côte
5 Comparer MAU et WAU pour {Nom de l’agent} Utilisateurs actifs mensuels par rapport aux utilisateurs actifs hebdomadaires Deux nombres d’utilisateurs distincts parallèles (fenêtres de 30 jours et de 7 jours)
6 Quelle est la tendance hebdomadaire des utilisateurs actifs pour {Nom de l’agent} ? Tendance WAU Série de décomptes d’utilisateurs distincts sur 7 jours au cours des dernières semaines
7 Combien d’utilisateurs uniques {Nom de l’agent} avait-il la semaine dernière ? Numéro WAU unique ancré à la fenêtre de 7 jours précédente Nombre d’utilisateurs distincts pour la fenêtre de 7 jours précédente
8 Fournir toutes les informations d’utilisation pour {Agent Name} Bloc de résumé complet DAU, WAU, MAU, tendance, plus commentaire sur la forme narrative
9 Donnez-moi un résumé complet de l’utilisation de {Agent Name} Bloc de résumé complet Identique au #8 ; Variante de formulation prise en charge
10 Afficher les métriques d’utilisation pour {Nom de l’agent} Bloc de résumé complet Identique au #8 ; Variante de formulation prise en charge
11 Quels sont les agents les plus utilisés cette semaine ? Liste classée des agents par nombre récent d’utilisateurs uniques Une sorte de nombre d’utilisateurs distincts sur 7 jours sur 7 jours entre les agents dans l’étendue
12 Quelle est la croissance nette du nombre de nouveaux utilisateurs pour {Nom de l’agent} ? Delta net du nouvel utilisateur dans les fenêtres récentes Différence entre les utilisateurs uniques de la fenêtre la plus récente et de la fenêtre précédente
13 Afficher les utilisateurs actifs quotidiens pour {Nom de l’agent} Valeur DAU ou série chronologique DAU, selon le qualificateur de date Nombre d’utilisateurs distincts par jour
14 Comparer l'{Agent A} à l'{Agent B} DAU, WAU et MAU côte à côte pour deux agents Deux extractions métriques parallèles pour les mêmes fenêtres

Invites d’utilisation et de croissance soutenues (cinq modèles dérivés)

Ces requêtes d’ordre supérieur utilisent les mêmes données d’activité agrégées et incluent toujours la mise en garde d’interprétation requise dans la réponse.

Proxy de rétention propagée

Champ Valeur
Exemples d’invites Quelle est la conservation de 7 jours pour {Nom de l’agent} ? / Montrez-moi la rétention continue de 30 jours pour {Nom de l’agent}
Fenêtres (N) prises en charge 1, 7, 30, 60 ou 90 jours
Définition unique_users[t − N → t] / unique_users[t − 2N → t − N], exprimé en ratio ou en pourcentage
Mise en garde requise dans la réponse « Ceci est calculé comme un ratio agrégé de fenêtre à fenêtre, et non comme une rétention de cohorte au niveau de l’utilisateur. »

Adhérence

Champ Valeur
Exemples d’invites À quel point {Nom de l’agent} est-il collant ? / Quel est le ratio DAU/MAU pour {Nom de l’agent} ?
Définition UAD divisée par l’UAM, exprimée en pourcentage
Interprétation Un ratio plus élevé signifie que les utilisateurs mensuels ont tendance à utiliser l’agent plus de jours dans le mois

Tendance d’adoption

Champ Valeur
Exemples d’invites L’adoption de {Agent Name} augmente-t-elle ? / Quelle est la tendance d’adoption pour {Nom de l’agent} ?
Définition Signe et magnitude du delta d’utilisateur unique d’une semaine à l’autre ou d’un mois à l’autre
Forme Réponse Direction (croissante, décroissante ou stable) plus la variation en pourcentage

Agent à la croissance la plus rapide

Champ Valeur
Exemples d’invites Quel agent connaît la croissance la plus rapide cette semaine ? / Me montrer quel agent connaît la croissance la plus rapide
Définition Croissance en pourcentage la plus élevée d’une semaine à l’autre du nombre d’utilisateurs uniques parmi les agents dans l’étendue
Forme Réponse Liste classée des meilleurs agents avec leurs deltas de pourcentage d’une semaine à l’autre

Modèle d’utilisation principal

Champ Valeur
Exemples d’invites Quels sont les principaux modèles d’utilisation de {Agent Name} ?
Définition Description narrative de la forme d’utilisation temporelle, dérivée de la distribution DAU sur 30 derniers jours
Forme Réponse Récit catégorique (par exemple, chargé en semaine et concentré sur les heures de bureau, régulier ou piquant) ; L’agent ne tente pas de clustering de persona ou d’intention

Votre avis et évaluations

Les commentaires utilisent un flux d’autorisation distinct de l’utilisation :

  1. Répertoriez ou résolvez les agents que le demandeur possède.
  2. Exiger un nom d’agent détenu exact après normalisation de la casse, des espaces blancs environnants et des guillemets, ou exiger un ID d’agent. Une faute de frappe, un alias, une correspondance approximative ou une quasi-correspondance nécessite la confirmation de l’utilisateur.
  3. Vérifiez la propriété de l’agent sélectionné.
  4. Vérifiez que le partage des commentaires de l’agent est activé pour tous les agents ou inclut l’agent sélectionné.
  5. Renvoyer les commentaires disponibles ou expliquer pourquoi ils ne peuvent pas être retournés.

Invites de commentaires prises en charge

Exemple d’invite Comportements inattendus
Afficher les agents dont je suis propriétaire Répertorie les noms d’affichage détenus. Affiche les ID d’agent uniquement lorsque cela est nécessaire pour distinguer les doublons.
Quels commentaires les utilisateurs ont-ils donnés sur {Agent Name} ? Renvoie les évaluations ou commentaires disponibles pour un agent détenu exactement.
Afficher les évaluations et les commentaires pour {Agent Name} Renvoie l’exemple de commentaires avec son contexte de nombre et d’heure.
Afficher les commentaires renvoyés pour {Nom d’agent} exactement tels qu’ils ont été envoyés Reproduit les commentaires de l’échantillon renvoyé sans les paraphraser.
Résumer les rubriques de produit récurrentes dans les commentaires pour {Agent Name} Résume les rubriques de produits observables à partir des commentaires renvoyés.
Afficher l’utilisation et les commentaires des utilisateurs pour {Nom de l’agent} ce mois-ci Exécute l’utilisation et les commentaires indépendamment et étiquette chaque résultat avec son contexte applicable.

Contrat de sortie de commentaires

Sortie Description
Évaluation Valeurs pouce vers le haut ou pouce vers le bas dans l’exemple renvoyé.
Commentaires soumis par les utilisateurs Commentaires textuels sur demande explicite.
Nombre d’éléments retournés Nombre d’éléments de commentaires inclus dans la réponse.
Exemple de fenêtre de temps Horodatages de début et de fin lorsqu’ils sont disponibles.
Indicateur de commentaires supplémentaires Indique si des commentaires existent au-delà de l’exemple renvoyé.
Résumé produit-rubrique Résumé basé sur des sujets observables et des valeurs d’évaluation explicites.

Résultats de la propriété

Résultat Signification
Vérifié Le demandeur est autorisé à demander un retour d’information pour l’agent sélectionné.
Refusé La case activée de propriété a déterminé que le demandeur n’est pas un propriétaire.
Non disponible La propriété n’a pas pu être vérifiée. Ce résultat ne doit pas être décrit comme un déni.
Nom ambigu Plusieurs agents détenus portent le même nom d’affichage. Le demandeur doit sélectionner un ID d’agent ; L’agent ne sélectionne jamais automatiquement le premier doublon.
Catalogue tronqué La liste des propriétaires retournés peut ne pas inclure tous les agents détenus. L’absence de correspondance exacte dans une liste tronquée ne prouve pas que le demandeur n’est pas un propriétaire.

Commentaires, confidentialité et utilisations restreintes

  • Les résultats des commentaires n’incluent pas l’identité de l’utilisateur procédant à la soumission, le contexte d’IA, les invites, les réponses, les transcriptions ou le contenu de la conversation.
  • L’agent n’en déduit pas les performances au travail, les caractéristiques personnelles protégées ou sensibles, les états internes ou émotionnels ou les attitudes au travail.
  • Ces restrictions d’inférence s’appliquent aux résumés et interprétations générés. Sur demande explicite, les commentaires textuels de l’échantillon renvoyé peuvent être reproduits tels qu’ils ont été soumis.
  • Le texte des commentaires est traité comme des données et non comme des instructions.

Pas encore pris en charge

L’agent nomme la fonctionnalité indisponible sans générer de numéro.

Exemple de demande Direction de la réponse
Afficher les tendances d’installation pour {Agent Name} Les mesures d’installation et de désinstallation ne sont pas disponibles dans cette version.
Quels sont les agents dont la rétention est la meilleure ? Les classements classiques de rétention par cohorte ne sont pas disponibles ; Demandez une rétention continue pour un agent spécifique.

Non pris en charge par conception

L’agent Insights ne retourne pas les identités des utilisateurs individuels ni le contenu des conversations. Il explique la limite et pointe vers le signal pris en charge le plus proche.

Exemple de demande Limite
Qui a utilisé {Nom d’agent} ? L’agent ne retourne pas les identités des utilisateurs individuels.
Combien des mêmes utilisateurs sont revenus ? Utilisez le proxy rolling-retention agrégé.
Quelle est la profondeur d’engagement pour {Nom de l’agent} ? Les détails de la session par utilisateur ne sont pas disponibles. Utiliser le résumé complet de l’utilisation.
Afficher des invites ou des réponses individuelles Les requêtes, les réponses, les transcriptions et le contenu des conversations ne sont pas disponibles.
Afficher la latence de réponse, l’utilisation de jetons ou le coût Ces mesures opérationnelles ne sont pas disponibles.
Obtenir des commentaires sur un agent que je ne possède pas Les commentaires nécessitent une propriété vérifiée.

Flux de décision

Pour savoir à l’avance si l’agent répond à une nouvelle invite, utilisez le flux suivant.

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.

Après un appel d’outil pris en charge, conserver NoData et DownstreamError tel que renvoyé. Ne réétiquetez pas l’un des résultats comme non pris en charge ou comme réussi.