Inventaire de l’agent Microsoft Copilot Studio

L’inventaire de l’agent Copilot Studio fournit aux administrateurs informatiques et de sécurité une vue centralisée de tous les agents créés à l’aide de Copilot Studio ou du Générateur d’agents dans le locataire. L’inventaire couvre les agents non publiés (brouillon) et publiés. Pour chaque agent, l’inventaire affiche les métadonnées clés, telles que la personne qui a créé l’agent, lors de sa dernière publication, les canaux déployés, la façon dont il authentifie les utilisateurs, ses fonctionnalités et bien plus encore. Les données d’inventaire sont actualisées automatiquement et les modifications apportées à un agent apparaissent généralement dans les 20 minutes.

Les administrateurs peuvent utiliser les données d’inventaire via plusieurs méthodes, notamment le Centre d’administration Power Platform, l’API Power Platform et Azure Resource Graph. Pour obtenir la liste complète des méthodes d’accès et des rôles requis, consultez l’inventaire Power Platform.

Cet article décrit les champs spécifiques aux agents Copilot Studio (microsoft.copilotstudio/agents) dans l’inventaire Power Platform. Pour connaître les champs partagés disponibles sur tous les types de ressources, consultez la référence du schéma d’inventaire Power Platform.

Note

L'inventaire n'inclut pas les agents créés avec V1 de Copilot Studio (également appelés bots classiques ou Power Virtual Agents). Toutefois, vous pouvez toujours accéder au Centre d’administration Power Platform et sélectionner Manage>Copilot Studio>Classic chatbots pour voir ces agents.

Important

Cet article contient la documentation en préversion de Microsoft Copilot Studio et est susceptible d'être modifié.

Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que vous puissiez y accéder en avant-première et fournir des commentaires.

Si vous créez un assistant prêt pour la production, consultez Vue d’ensemble de Microsoft Copilot Studio.

Propriétés de l’agent

L’inventaire fournit les propriétés suivantes pour chaque agent.

Note

  • L’inventaire reflète la structure de la version publiée de chaque agent. Si un agent a des modifications non publiées (un brouillon plus récent), l’inventaire n’affiche pas ces modifications tant que l’agent n’est pas publié.

  • La configuration d’un agent affecte les champs renseignés. Certaines propriétés peuvent dépendre null de la configuration de l’agent. Par exemple, isManaged correspond à null pour les agents créés dans Agent Builder.

Propriétés clés

Chemin du champ API Type de données Description Exemple Statut
properties.displayName string Nom complet de l’agent. Customer support agent Généralement disponible
properties.name GUID ID de l’agent dans l’environnement Dataverse spécifique (ID de bot CDS). aaaa0000-bb11-2222-33cc-444444dddddd Généralement disponible
properties.createdAt datetime Date et heure de création de l’agent. 2024-12-13T04:00:00Z Généralement disponible
properties.createdBy GUID Entra ID de l’utilisateur qui a créé l’agent. aaaa0000-bb11-2222-33cc-444444dddddd Généralement disponible
properties.ownerId string L’ID d’objet (Entra ID) du propriétaire actuel de l’agent. aaaa0000-bb11-2222-33cc-444444dddddd Généralement disponible
properties.environmentId string Identificateur de l’environnement Power Platform qui contient la ressource. aaaa0000-bb11-2222-33cc-444444dddddd Généralement disponible
properties.lastPublishedAt datetime Date et heure de la dernière publication de l’agent. Vide ou nul si l’agent est encore à l’état de brouillon. 2026-01-15T10:30:00Z Généralement disponible
properties.createdIn string Outil de création où l’agent a été créé : Copilot Studio ou Microsoft 365 Copilot Agent Builder. Copilot Studio Généralement disponible
properties.schemaName string Nom du schéma Dataverse. Disponible pour les agents Copilot Studio et les agents Microsoft 365 Copilot Agent Builder. cr5e3_agentName Généralement disponible
properties.isQuarantined booléen Indique si l’agent est actuellement mis en quarantaine. false Aperçu
properties.quarantinedAt datetime Date et heure de la dernière mise en quarantaine de l’agent. 2026-02-01T08:00:00Z Aperçu
properties.isManaged booléen Indique si l’agent fait partie d’une solution Dataverse managée. Null pour les agents créés dans Le Générateur d’agents. false Aperçu

Propriétés d’identité Entra

Chemin du champ API Type de données Description Exemple Statut
properties.botId string ID du bot CDS dans l’environnement. aaaa0000-bb11-2222-33cc-444444dddddd Généralement disponible
properties.entraAppId string Entra App Registration ID associé à l’agent, lorsqu’il existe. aaaa0000-bb11-2222-33cc-444444dddddd Généralement disponible
properties.entraAgentId string Id d’identité de l’agent Entra, lorsqu’il existe. aaaa0000-bb11-2222-33cc-444444dddddd Généralement disponible
properties.entraAgentBlueprintId string Id de blueprint de l’agent Entra, lorsqu’il existe. aaaa0000-bb11-2222-33cc-444444dddddd Généralement disponible

Note

Toutes les propriétés d’identité ne sont pas disponibles pour tous les types d’agents : entraAppId est un identificateur hérité, des agents plus récents utilisent entraAgentId et entraAgentBlueprintId. Ces champs sont renseignés uniquement s’ils s’appliquent à l’agent spécifique. Aucune de ces propriétés d’identité ne s’applique aux agents Microsoft 365 Copilot Agent Builder.

Pour en savoir plus sur les concepts d’identité d’Entra, consultez App registration, les identités d’agent et l’authentification pour Copilot Studio.

Propriétés de configuration

Chemin du champ API Type de données Description Exemple Statut
properties.orchestration string Mode d’orchestration de l’agent (en savoir plus dans les modes d’orchestration). Generative Aperçu
properties.model string Modèle IA utilisé par l’agent. gpt-4o Aperçu
properties.authentication string Mode d’authentification configuré pour l’agent (en savoir plus dans les modes d’authentification). Microsoft Entra Aperçu
properties.channels tableau Les noms d'affichage des canaux sur lesquels l'agent est publié. ["Teams","SharePoint"] Aperçu
properties.sharedWithViewers Objet Nombre d’utilisateurs visualiseurs (userCount) et de groupes de visualiseurs (groupCount) avec lesquels l’agent est partagé. Si un créateur a partagé l’agent avec l’ensemble du locataire, entireTenant est défini sur true, même si un administrateur n’a pas approuvé le partage. "groupCount": 0, "userCount": 0, "entireTenant": false Aperçu
properties.sharedWithEditors Objet Nombre d’utilisateurs éditeurs individuels (userCount) et de groupes d’éditeurs (groupCount) avec lesquels l’agent est partagé. "groupCount": 0, "userCount": 0 Aperçu
properties.capabilitiesCounts Objet Nombre total distinct de chaque type de fonctionnalités configurées "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Aperçu

Modes d’orchestration

Le properties.orchestration champ accepte les valeurs suivantes :

Value Description
Classic L'agent utilise l'orchestration basée sur des sujets classiques avec des arborescences de dialogues conçues.
Génératif L’agent utilise l’orchestration générative, où un modèle IA sélectionne dynamiquement des rubriques et des actions.

Modes d’authentification

Le properties.authentication champ accepte les valeurs suivantes :

Value Description
None Aucune authentification requise.
Microsoft Entra Authentification via l’ID Microsoft Entra.
Generic OAuth 2.0 Authentification via un fournisseur OAuth 2.0 générique.

Fonctionnalités de l’agent

Cette section répertorie les fonctionnalités (outils et connaissances) de l’agent. Actuellement, il affiche uniquement des données détaillées sur les connecteurs utilisés par l’agent et une configuration des connaissances, comme indiqué dans les sections suivantes.

L’inventaire a une limitation de 200 ressources maximales de chaque type par agent. En savoir plus sur les limitations connues.

L’inventaire supprime automatiquement les ressources en double, telles qu’un connecteur Power Platform que vous avez configuré deux fois dans un agent avec la même configuration.

Propriétés du connecteur

L’inventaire comprend un tableau appelé powerPlatformConnectors, qui contient les connecteurs Power Platform configurés dans un agent. Chaque connecteur est identifié par sa connectorId (chaîne contenant l’ID de ressource du connecteur, par exemple). shared_excelonlinebusiness Pour chaque connecteur configuré, il existe une liste de paramètres configurés operations. La liste inclut les propriétés suivantes :

Propriété Type de données Description Statut
OperationId string ID de l’opération spécifique dans le connecteur ; par exemple, AddRowV2 Aperçu
createdBy GUID Utilisateur qui a configuré l’opération Aperçu
isEnabled booléen Indique si l’opération de connecteur est actuellement activée Aperçu
usedAs string Utilisation de l’opération :
  • Tool s’il est configuré en tant qu’outil général
  • Topic Tool si configuré en tant qu’outil dans une rubrique spécifique
  • Knowledge si le connecteur est configuré en tant que source de connaissances
 Aperçu
requiresEndUserConsent booléen Indique si les utilisateurs finaux doivent donner leur consentement avant que l’agent puisse utiliser l’opération Aperçu
whenCanBeUsed string Lorsque l’opération peut être appelée :
  • Anytime si l’outil est disponible pour l’agent sans limitations
  • ViaDirectReferenceOnly si l’agent utilise l’outil uniquement lorsque le créateur l’a configuré explicitement dans des rubriques spécifiques
  • Conditional si l’agent peut utiliser l’outil en fonction d’une logique prédéfinie par le créateur
 Aperçu
connectionProvider string Qui fournit la connexion pour l’opération :
  • User si l’utilisateur final fournit des informations d’identification au moment de l’exécution
  • Maker si le créateur définit la connexion au moment de la création
 Aperçu
connectionIdSharedByMaker GUID ID de connexion, renseigné uniquement lorsque connectionProvider = Maker Aperçu

Propriétés des connaissances

L’inventaire comprend la propriété suivante pour les connaissances :

Propriété Type de données Description Statut
IsWebSearchEnabledForKnowledge booléen True si l’agent peut utiliser la recherche web comme source de connaissances Aperçu

Limitations connues

  • Les agents V1 ne sont pas suivis : l’inventaire n’inclut pas les agents créés avec le runtime Power Virtual Agents V1 d’origine. Il effectue uniquement le suivi des agents V2 (Copilot Studio).
  • Les propriétés d’identité ne sont pas forcément disponibles pour tous les agents - Les champs entraAgentId et entraAgentBlueprintId sont renseignés uniquement pour les agents provisionnés avec le nouveau modèle d’identité d’agent Entra. Les anciens agents peuvent n’avoir que entraAppId, et les agents de Microsoft 365 Copilot Agent Builder n’ont aucune de ces propriétés d’identité.
  • Nombre de fonctionnalités : l’inventaire a une limitation de 200 ressources maximales de chaque type par agent. Si un agent a plus de 200 ressources configurées à partir d’un type spécifique (par exemple, connecteurs Power Platform), l’inventaire affiche 200 aléatoires. Les administrateurs peuvent utiliser le capabilitiesCounts champ pour comprendre le nombre de ressources configurées dans un agent par type.

Contenu connexe

  • Last updated on