Résoudre les problèmes liés à l’agent Microsoft 365 Insights

Utilisez cet article pour résoudre les problèmes courants d’Insights Agent, y compris une installation obsolète, une erreur d’installation ou d’ouverture d’un agent introuvable , des données d’utilisation manquantes, des commentaires indisponibles, la vérification de la propriété et des résultats de métriques inattendus.

L’agent Insights n’affiche pas les fonctionnalités de commentaires

Vous pouvez ouvrir l’agent Insights, mais ses démarrages de conversation ou ses réponses n’incluent pas de commentaires ni d’évaluations.

Cause

Votre copie installée n’a pas été actualisée dans le package Insights Agent actuel.

Résolution

  1. Supprimez l’agent Insights de votre liste d’agents Microsoft 365 Copilot.
  2. Recherchez l’agent Insights.
  3. Ajoutez à nouveau l’agent Insights.
  4. Ouvrez-le et essayez « Montre-moi les agents dont je suis propriétaire » ou « Quels commentaires les utilisateurs ont-ils donnés sur {Nom de l’agent} ? »

La suppression et l’ajout de l’agent Insights actualisent votre installation personnelle. Il ne supprime ni ne modifie les agents que vous analysez.

L’agent Insights peut faire l’objet d’une recherche, mais son ouverture ou son installation affiche un Agent introuvable

L’agent Insights apparaît dans la recherche, mais sa sélection produit une erreur « Agent introuvable » au lieu de l’ouvrir ou de l’installer.

Cause

L’affectation de disponibilité de l’agent Insights peut être obsolète même lorsque le Centre d’administration Microsoft 365 affiche que l’agent est disponible pour tous les utilisateurs.

Résolution

Contactez votre administrateur Microsoft 365 et demandez-lui de réinitialiser l’attribution de disponibilité de l’agent Insights :

  1. Ouvrez le contrôle de disponibilité ou d’attribution des utilisateurs d’Insights Agent dans le Centre d’administration Microsoft 365.
  2. Définissez l’agent Insights sur Aucun utilisateur, puis enregistrez.
  3. Configurez l’agent Insights sur Tous les utilisateurs, puis enregistrez à nouveau.
  4. Attendez que la modification se propage, puis réessayez d’ouvrir ou d’installer l’agent Insights.

Important

Cette réinitialisation s’applique à l’attribution de disponibilité de l’agent Insights. Ne modifiez pas le partage des commentaires de l’agent dans le cadre de cette récupération.

Aucune donnée d’utilisation pour l’agent concerné

Vous posez une invite d’utilisation prise en charge, telle que « Fournir toutes les informations d’utilisation pour {Nom de l’agent} », et la réponse indique qu’il n’y a pas de données.

Causes les plus probables

  • Le nom de l’agent ne correspond pas exactement au nom visible dans votre client.
  • L’activité de l’agent est insuffisante pour la fenêtre demandée. Les nouveaux agents peuvent n’avoir aucune activité pour le moment, et les mesures fenêtrées ont besoin d’une activité suffisante dans la période en cours et la période de comparaison.
  • Vous n’avez pas de visibilité sur l’agent.

Résolution

Vérifiez le nom exact, confirmez que l’agent a suffisamment d’activité pour la fenêtre demandée, puis réessayez. Si un agent actif et visible ne renvoie toujours pas de données, contactez le support technique avec l’invite et la réponse exactes via un canal approuvé.

L’utilisation fonctionne, mais les commentaires ne sont pas disponibles

Causes les plus probables

  • Vous ne possédez pas l’agent sélectionné.
  • La propriété n’a pas pu être vérifiée.
  • Votre administrateur client a sélectionné Aucun agent pour le partage des commentaires de l’agent.
  • Votre administrateur client a sélectionné Agents sélectionnés et n’a pas inclus l’agent demandé.

Résolution

  1. Demandez : « Montre-moi les agents que je possède. »
  2. Sélectionnez un nom d’agent exact dans le résultat de propriété.
  3. Demandez à votre administrateur client de vérifier la case activéeParamètres> des agents>Partage des commentaires des agents.
  4. Si l’option Agents sélectionnés est configurée, confirmez que l’agent sélectionné est inclus.
  5. Relancez la demande de commentaires une fois le paramètre propagé.

La visibilité de l’utilisation n’accorde pas l’accès aux commentaires. L’activation du partage de commentaires rend les commentaires éligibles pour les propriétaires, mais elle ne donne pas accès aux administrateurs, sauf s’ils satisfont également au case activée de propriété. Pour obtenir des instructions sur la configuration, consultez Partage des commentaires de l’agent.

La demande de commentaires réussit mais ne renvoie aucun élément

Aucun commentaire n’est actuellement disponible pour l’agent sélectionné. Il s’agit d’un résultat valide qui n’indique pas de problème d’appropriation ou de partage de commentaires. Aucune modification d’autorisation n’est requise.

Une demande combinée d’utilisation et de commentaires renvoie un seul résultat

L’utilisation et les commentaires utilisent des chemins de récupération et d’autorisation distincts. Si l’utilisation réussit mais que les commentaires échouent, suivez les étapes de propriété des commentaires et de partage. Si les commentaires réussissent mais que l’utilisation échoue, vérifiez le nom de l’agent, la visibilité et la fenêtre d’utilisation demandée. N’interprétez pas un résultat réussi comme une preuve que l’autre voie devrait également réussir.

La propriété est refusée ou n’est pas disponible

État Signification Procédure à suivre
Refusé La case activée de propriété a permis de déterminer que vous n’êtes pas propriétaire. Choisissez un agent que vous possédez ou demandez à un propriétaire de consulter ses commentaires.
Non disponible Le service n’a pas pu vérifier la propriété. Réessayez ultérieurement. Si le problème persiste, contactez le support. Ne considérez pas cela comme une preuve que vous n’êtes pas propriétaire.
Nom ambigu Plusieurs agents détenus portent le même nom d’affichage. Sélectionnez l’ID d’agent exact affiché par l’agent Insights.

La réponse de rétention comprend une mise en garde

Une réponse de rétention inclut une instruction telle que « Ceci est calculé comme un ratio global de fenêtre sur fenêtre, et non comme une rétention de cohorte au niveau de l’utilisateur ».

Cause

La mise en garde est nécessaire, car l’agent Insights signale un proxy d’utilisation soutenue agrégée. La rétention de cohorte classique nécessite le suivi des mêmes utilisateurs dans le temps, ce que l’agent Insights ne renvoie pas.

Résolution

Interprétez la valeur comme si le pool d’utilisateurs actifs augmente, se maintient ou diminue sur des fenêtres consécutives de longueur égale.

Le nombre d’installations ou de désinstallations n’est pas disponible

Les signaux d’installation et de désinstallation ne sont pas connectés à la couche de données d’Insights Agent. Utilisez DAU, WAU, MAU et les tendances d’utilisateur unique comme signaux d’adoption.

Une requête de tendance renvoie un nombre étonnamment petit ou une erreur

Cause la plus probable

La fenêtre de temps demandée peut ne pas avoir assez d’activité, ou un package installé antérieurement peut ne pas analyser correctement l’expression d’heure.

Résolution

  • Supprimez l’agent Insights, puis ajoutez-le à nouveau pour actualiser votre installation.
  • Réessayez en utilisant le nom exact de l’agent et une invite prise en charge dans les exemples d’invites.
  • Si le problème persiste, contactez le support via un canal approuvé. Fournissez l’invite et la réponse d’origine.

Une comparaison ne correspond pas à un autre tableau de bord

Causes probables

  • Les deux surfaces utilisent des ancres temporelles différentes.
  • L’autre tableau de bord compte les sessions, les requêtes ou les comptes au lieu d’utilisateurs distincts.
  • Quelqu’un a renommé ou republié l’agent, et les deux surfaces attribuent l’activité à des versions différentes.

Résolution

Utilisez la même ancre de date et confirmez que les deux surfaces comptent des utilisateurs distincts. Si l’écart persiste, contactez le support via un canal approuvé. Fournissez les preuves de l’invite et du tableau de bord.

Le résultat à la croissance la plus rapide est inattendu

Cause

Le classement à la croissance la plus rapide classe les agents en fonction de la variation en pourcentage d’utilisateurs uniques d’une semaine à l’autre. Une petite population de départ peut produire un pourcentage important de changement.

Résolution

Avant d’interpréter le classement, examinez ensemble le nombre d’utilisateurs uniques sous-jacents et la variation en pourcentage.

Avant de contacter le support

  • Enregistrez l’invite exacte et la réponse complète.
  • Enregistrez la date, l’heure et le locataire.
  • Indiquez si l’utilisation fonctionne et si seul le retour échoue.
  • Indiquez si vous avez supprimé et ajouté à nouveau l’agent Insights.
  • Pour les problèmes de commentaires, indiquez si la réponse ne signalait aucun commentaire, partage désactivé, propriété refusée, propriété indisponible ou nom d’agent ambigu. Enregistrez également si le partage des commentaires des agents est défini sur Aucun agent, Tous les agents ou Agents sélectionnés.
  • N’incluez pas les commentaires, les invites, les réponses ou tout autre contenu privé des utilisateurs, sauf si le support le demande via un canal approuvé.