Surveillez les agents en utilisant l’inventaire des agents dans le kit d’agents Copilot

La fonctionnalité Inventaire des agents offre aux administrateurs une visibilité à l’échelle du locataire sur tous les agents personnalisés et déclaratifs de Copilot Studio dans l’organisation, à travers les environnements. Les données d’inventaire des agents incluent les métadonnées du cycle de vie et de la propriété, les signaux d’adoption de configuration et de capacité, les indicateurs de gouvernance et les indicateurs d’utilisation.

Note

Cet article décrit l’expérience actuelle de l’inventaire des agents. L’expérience précédente est documentée dans le dépôt Copilot Agent Kit sur GitHub dans le fichier AGENT_INVENTORY_V1.md.

Dashboard

Le tableau de bord Inventaire des agents fournit un résumé de l’inventaire à l’échelle du tenant et une navigation détaillée dans l’inventaire. Sélectionnez une tuile, un graphique ou un élément de liste pour ouvrir une vue filtrée dans la grille de l’agent.

Contexte de l’inventaire

La ligne d’état en haut du tableau de bord affiche l’état actuel de l’inventaire :

Que l’inventaire soit en cours, vide, ou qu’une synchronisation soit en cours.
Le pourcentage de documents enrichis par une configuration détaillée.
Le nombre d’agents dont les détails sont limités.
Le nombre d’environnements synchronisés.
La date et l’heure de la dernière synchronisation réussie, si disponible.

Indicateurs de portefeuille

Les tuiles métriques vous aident à accéder directement aux segments importants de l’inventaire :

Nombre d’agents
Alimenté par
Agents autonomes
Agents de recrutement
Agents ayant des connaissances

Sélectionnez une tuile pour ouvrir la grille des agents filtrée sur ce segment. Le Powered by tile regroupe les agents en catégories telles que Standard, GitHub Copilot et Copilot Chat.

Analytique et gouvernance

Le tableau de bord inclut également des graphiques et des listes qui vous aident à repérer les schémas et les risques :

Croissance du portefeuille avec des fourchettes de six mois et douze mois.
Distribution de l’authentification.
Priorités de gouvernance nécessitant un examen par les administrateurs.
Répartition du statut du portefeuille.
Adoption de capacités entre agents enrichis.
Meilleurs environnements classés par nombre d’agents.
Assistants à surveiller pour les dossiers nécessitant une attention.

Les pourcentages dépendent des environnements pour lesquels les identités de connexion configurées peuvent récupérer les données des agents et la configuration détaillée. En savoir plus sur les modes de collecte de données.

Parcourez tous les agents

Sélectionnez Afficher l’inventaire complet depuis le tableau de bord pour ouvrir la grille des agents. Utilisez la grille pour trouver, regrouper et exporter les données d’inventaire.

Vous pouvez filtrer, trier et regrouper par n’importe quelle colonne, ajouter ou supprimer des colonnes pour adapter la grille à vos besoins, et exporter la vue actuelle vers Excel.

Détails de l’agent

Sélectionnez un nom d’agent dans la grille pour ouvrir les détails de l’agent. L’en-tête affiche l’identité de l’agent, le contexte de l’environnement, l’état du cycle de vie, la propriété et les actions disponibles. Une bannière d’information indique si l’enregistrement contient un enrichissement complet Dataverse ou seulement des détails de configuration limités.

Onglet Vue d’ensemble

L’onglet Aperçu affiche le résumé de l’agent et les informations sur l’environnement, la posture de gouvernance et les signaux, ainsi qu’un instantané d’utilisation lorsque l’historique d’utilisation existe. Si les descriptions générées par l’IA sont activées et que l’agent est un agent GitHub assistant Copilot éligible, une description générée par l’IA est également affichée.

Onglet Composants

L’onglet Composants n’apparaît que lorsque les données composants sont disponibles pour l’agent. Utilisez cet onglet pour explorer l’architecture de l’agent dans la vue carte des composants , parcourir le contenu catégorisé dans la vue groupe des composants , étendre un groupe de composants peuplé à la fois, activer le mode Raw pour inspecter le JSON, ou copier le JSON des composants pour l’investigation ou le support.

Onglet Utilisation

L’onglet Utilisation n’apparaît que lorsque des enregistrements d’utilisation existent pour l’agent. Il inclut :

Du début du mois à aujourd’hui, les deux mois calendaires précédents, les trois derniers mois et les six derniers mois. Les six derniers mois sont sélectionnés par défaut.
Total des crédits Copilot et la moyenne des crédits par semaine active.
Utilisateurs signalés et fonctionnalité d’utilisation principale.
Tendances hebdomadaires du crédit.
Points forts de l’utilisation, crédits par fonctionnalité et par canal, ainsi que données d’utilisation récentes.
Une exportation Excel spécifique à chaque agent.

onglet Métadonnées

L’onglet Métadonnées est toujours disponible. Utilisez-le pour inspecter des valeurs techniques telles que l’identifiant de l’agent et le nom du schéma, l’identifiant et l’URL de l’environnement, les identifiants de localisation et de source, ainsi que les champs d’inventaire bruts utilisés pour le diagnostic et l’intégration.

Synchroniser ou rafraîchir les données d’inventaire

Agent Inventory dissocie la synchronisation du rafraîchissement du tableau de bord.

Agents de synchronisation

Sélectionnez Synchroniser les agents lorsque vous devez récupérer à nouveau l’inventaire locataire. La synchronisation suit les filtres, les groupes d’environnement, le mode de collecte de données, les paramètres d’utilisation et le planning enregistrés dans Configurer l’inventaire des agents.

Pendant qu’une synchronisation est en cours :

Le statut de l’inventaire passe à Synchronisation en cours.
Les agents de synchronisation sont désactivés pour empêcher les opérations en double.
Les paramètres pouvant modifier la configuration active sync ne sont pas disponibles.
Le tableau de bord recharge les détails de l’agent, l’historique d’utilisation, le statut de la synchronisation et les informations de dernière synchronisation après la fin de la synchronisation.

Actualiser les données du tableau de bord

Sélectionnez Rafraîchir les données du tableau de bord pour recharger les données déjà stockées dans les tableaux des Détails de l’Agent et de l’Historique d’Utilisation des Agents . Le rafraîchissement ne lance pas de synchronisation d’agent et ne redécouvre pas les environnements ou les agents. Utilisez-le après une synchronisation terminée, ou lorsque le tableau de bord affiche des données en cache obsolètes.

Important

La synchronisation des agents n'utilise pas les crédits Copilot. Les crédits ne sont utilisés que lorsque les descriptions générées par l’IA sont activées et qu’une page de détails éligible de l’agent assistant Copilot sur GitHub est visitée.

Actions de gouvernance

L’Inventaire des agents prend en charge les actions de réaffectation, de quarantaine et de désintégration . Les actions n’apparaissent que lorsque chaque agent sélectionné est éligible.

Disponibilité de l’action

La colonne Statut dans la grille est remplie lors de la dernière synchronisation d’inventaire et reflète la valeur provenant du centre d’administration Power Platform (données One Inventaire). Les actions affichées dépendent du nombre d’enregistrements que vous sélectionnez et de leur statut.

Action	Règle de sélection	Caché quand
Réaffecter	Un ou plusieurs enregistrements (jusqu’à un maximum de 50) peuvent être sélectionnés.	Aucun agent sélectionné n’est éligible à une réaffectation.
Quarantaine	Un ou plusieurs enregistrements ayant le statut Brouillon ou Disponible (dans la limite de 50) peuvent être sélectionnés.	Tout agent sélectionné est bloqué ou n’est pas éligible à la quarantaine.
Sortir de quarantaine	Un ou plusieurs enregistrements en statut Bloqué (jusqu’à un maximum de 50) peuvent être sélectionnés.	Tous les agents sélectionnés sont Draft, Available ou ne sont pas éligibles à une sortie de quarantaine.

Si un enregistrement sélectionné est incompatible avec une opération, cette opération est cachée dans la barre de commandes. Les enregistrements dont le contexte du centre d’administration Power Platform ne correspond pas à l’environnement d’inventaire ne se voient pas proposer d’actions de gouvernance non prises en charge.

Sur la page des détails de l’agent , la disponibilité en quarantaine et en déquarantaine est basée sur le statut en ligne de l’agent, plutôt que sur le statut synchronisé affiché dans la grille.

Réaffecter

Certaines organisations exigent que les agents aient des propriétaires pour des raisons de conformité. Le propriétaire peut modifier l’agent, publier des mises à jour, le supprimer ou le partager avec ses coéquipiers selon leurs autorisations.

Sélectionnez Réassigner et sélectionnez un utilisateur qui possède une licence Microsoft 365 Copilot. Pour la réaffectation en masse, la boîte de dialogue affiche les environnements sélectionnés, les agents, les propriétaires actuels et le statut des opérations. Après la fin de la réaffectation, le statut de réaffectation est affiché comme terminé pour chaque agent traité avec succès.

Mise en quarantaine et sortie de quarantaine

La quarantaine bloque un agent éligible. Annuler la mise en quarantaine restaure un assistant bloqué admissible. La boîte de dialogue de confirmation identifie les agents, environnements et statuts affectés avant qu’une opération ne soit soumise.

Les actions en bloc supportent jusqu’à 50 agents par opération et ne sont disponibles que lorsque chaque enregistrement sélectionné est éligible.

Configurer l’inventaire de l’agent

Sélectionnez Paramètres dans l’en-tête du tableau de bord pour ouvrir la configuration de synchronisation de l’agent. Utilisez-le pour contrôler quels environnements et types d’agents sont collectés, ajuster les options d’inventaire, et définir le calendrier de synchronisation et le mode de collecte.

Note

Ces paramètres intégrés supposent que les références de connexion nécessaires à la solution sont déjà configurées. En savoir plus sur le câblage des références de connexion dans Configure l’inventaire des agents.

Types d’environnement

Choisissez les types d’environnements à scanner :

Developer
Default
Bac à sable
Production
Essai
Teams

Si vous ne sélectionnez pas un type d’environnement, le système inclut tous les types d’environnements.

Types d’agents

Choisissez si l’inventaire comprend :

Agents personnalisés
Agents déclaratifs

Si vous ne sélectionnez pas un type d’agent, l’inventaire inclut tous les types d’agents.

Groupes environnementaux

Les groupes d’environnement fournissent des scopes de synchronisation réutilisables. En tant qu’administrateur, vous pouvez :

Créez et modifiez un groupe.
Sélectionnez les environnements membres en utilisant des filtres de type d’environnement et de région.
Activez ou désactivez le groupe.
Supprimez un groupe dont vous n’avez plus besoin.

Si vous n’activez pas un groupe, tous les environnements autorisés par les autres paramètres sont inclus.

Options d’inventaire

Définissez les options suivantes pour contrôler ce que le système collecte lors de la synchronisation :

Exclure les agents système : Ignore les agents système fournis par Microsoft lors de la synchronisation.
Activer la description générée par IA pour les agents GitHub Copilot : Permet la génération de descriptions lorsqu’une page de détails d’agent éligible est visitée.
Inclure les métriques d’utilisation : Collecte la fenêtre d’utilisation conservée de 180 jours lors de la synchronisation.

Synchronisation du planning et mode de collecte

Choisissez comment la synchronisation s’exécute et quel mode de collecte de données utiliser :

One Inventory (centre d’administration Power Platform) : Combine l’inventaire du centre d’administration avec les données d’environnement pour une découverte plus large et des métadonnées plus riches.
Standard (environnements uniquement) : Récupère l’inventaire directement depuis les environnements accessibles.
Activez la synchronisation automatique quotidienne : Exécute l’inventaire de l’agent selon le planning quotidien configuré.

Sélectionnez Enregistrer pour appliquer les modifications. La sauvegarde est désactivée lorsqu’aucun paramètre n’a changé, lorsqu’une sauvegarde est en cours, ou lorsque les paramètres ne sont pas disponibles pendant une synchronisation active.

Tip

Utilisez Actualiser les données du tableau de bord une fois la synchronisation terminée lorsque le tableau de bord doit recharger les données existantes du tableau. Utilisez les agents Sync uniquement lorsque la collecte d’inventaire doit recommencer. Conservez des filtres d’environnement et d’assistant aussi restrictifs que possible dans les très grands environnements, et désactivez la collecte des données d’utilisation lorsque les analyses d’utilisation sur 180 jours ne sont pas nécessaires.

Modes de collecte de données

Le paramètre de mode collecte de données détermine comment le système découvre et collecte les dossiers d’agent.

Mode Inventaire unique (recommandé)

Lorsque vous réglez le mode collection sur One Inventory, Agent Inventory utilise les données One Inventory :

Il récupère les données des agents depuis One Inventory via le centre d’administration Power Platform.
Il liste les environnements en utilisant la référence de connexion Copilot Agent Kit - Power Platform for Admins V2.
Il combine les données de l’agent One Inventory avec la liste des environnements pour construire les détails de l’environnement.
Pour chaque environnement, il charge les détails des agents dans l’Agent Inventory en fusionnant les agents récupérés depuis l’environnement avec les données One Inventory correspondantes.

Utilisez ce mode lorsque vous avez besoin d’une découverte plus large des locataires et de métadonnées plus riches du centre d’administration Power Platform. Les agents découverts via le centre administratif mais inaccessibles dans leur environnement sont toujours ajoutés avec peu de détails.

Mode standard

Lorsque vous réglez le mode de collecte sur Standard, l’Inventaire des agents utilise l’approche standard de collecte de données :

Il liste tous les environnements en utilisant la référence de connexion Copilot Agent Kit - Power Platform for Admins (V1).
Il récupère des agents pour chaque environnement.
Il charge les données des agents dans l’Inventaire des agents.

Utilisez ce mode lorsque vous voulez que la collecte ne dépende que d’environnements accessibles.

Dans les deux modes, Agent Inventory utilise la référence de connexion Copilot Agent Kit - Dataverse pour se connecter à chaque environnement et recueillir des informations détaillées sur les agents, y compris les métadonnées, l’utilisation des fonctionnalités et la configuration. Le système ne récupère des informations détaillées que pour les environnements où le compte configuré dispose d’un accès administrateur système.

Découvrez la liste complète des connecteurs utilisés dans le kit dans les exigences des connecteurs.

Métriques d'utilisation

L’inventaire des agents peut conserver et afficher jusqu’à 180 jours de données d’utilisation des agents. Pour permettre l’analyse d’utilisation :

Assurez-vous que les connexions nécessaires à la solution sont configurées et autorisées par les politiques de données.
Ouvrez la configuration de synchronisation de l’agent.
Activez Inclure les indicateurs d’utilisation.
Cliquez sur Enregistrer.
Sélectionnez Agents de synchronisation, ou attendez la synchronisation automatique quotidienne.

Les données d’utilisation sont stockées dans les tableaux des Détails de l’Agent et de l’Historique d’Utilisation de l’Agent . L’onglet Utilisation d’un agent n’apparaît que lorsque des historiques d’utilisation correspondants sont disponibles.

Configurez l’HTTP avec la connexion Microsoft Entra ID

Les indicateurs d’utilisation reposent sur le HTTP avec le connecteur Microsoft Entra ID (préautorisé). Les valeurs de connexion dépendent du cloud dans lequel votre locataire fonctionne. Utilisez l’URL de la ressource de base et l’URI de ressource Microsoft Entra ID qui correspondent à votre cloud lors de la création de la connexion.

Cloud	URL de ressource de base	Microsoft Entra ID Resource URI
Commercial	`https://licensing.powerplatform.microsoft.com/`	`https://licensing.powerplatform.microsoft.com/`
GCC	`https://gov.licensing.powerplatform.microsoft.us/`	`https://gov.licensing.powerplatform.microsoft.us/`
GCC High	`https://high.licensing.powerplatform.microsoft.us/`	`https://high.licensing.powerplatform.microsoft.us/`

Autorisations et exigences relatives aux connecteurs

Les références de connexion dans la solution limitent et contrôlent la visibilité pour les agents. Pour une visibilité complète à l’échelle du locataire, configurez les références de connexion avec un compte disposant du rôle d’administrateur Power Platform. Pour récupérer tous les détails au niveau des fonctionnalités, ce compte a également besoin d’un administrateur système d’accès aux environnements concernés. Vous pouvez utiliser d’autres comptes, mais la visibilité de l’inventaire de l’agent est limitée aux environnements où l’utilisateur dispose d’un accès administrateur système.

L’Agent Inventory repose sur les connecteurs suivants, que les politiques de données appliquées à l’environnement doivent permettre :

Microsoft Dataverse
Power Platform pour les administrateurs
Power Platform pour les administrateurs V2
HTTP avec Microsoft Entra ID (pré-autorisé)