Inventaire d’assistant Microsoft Copilot Studio

L’inventaire des assistants Copilot Studio offre aux administrateurs IT et sécurité une vue centralisée de tous les assistants créés via Copilot Studio ou Agent Builder dans le locataire. L’inventaire couvre à la fois les assistants non publiés (brouillon) et les assistants publiés. Pour chaque assistant, l’inventaire affiche des métadonnées clés, telles que qui a créé l’assistant, la date de sa dernière publication, les canaux sur lesquels il est déployé, la façon dont il authentifie les utilisateurs, ses capacités, et plus encore. Les données de l’inventaire sont actualisées automatiquement, et les modifications effectuées sur un assistant apparaissent généralement dans un délai d’environ 20 minutes.

Les administrateurs peuvent accéder aux données d’inventaire par plusieurs méthodes, notamment le centre d’administration Power Platform, l’API Power Platform et Azure Resource Graph. Pour la liste complète des méthodes d’accès et des rôles requis, voir Inventaire Power Platform.

Cet article décrit les champs spécifiques aux assistants de Copilot Studio (microsoft.copilotstudio/agents) dans l’inventaire Power Platform. Pour les champs partagés disponibles pour tous les types de ressources, voir Référence du schéma d’inventaire Power Platform.

Note

L’inventaire n’inclut pas les assistants créés avec la V1 de Copilot Studio (également appelés assistants classiques ou Power Virtual Agents). Cependant, vous pouvez toujours aller dans le centre d’administration Power Platform et sélectionner Gérer>Copilot Studio>Chatbots classiques pour afficher ces assistants.

Important

Cet article contient la documentation sur Microsoft Copilot Studio en version préliminaire et peut faire l’objet de modifications.

Les fonctionnalités d’évaluation 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’assistant

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

Note

L’inventaire reflète la structure de la version publiée de chaque assistant. Si un assistant comporte des modifications non publiées (un brouillon plus récent), l’inventaire ne montre pas ces modifications tant que l’assistant n’est pas publié.
La configuration d’un assistant affecte les champs qui sont renseignés. Certaines propriétés peuvent être null selon la configuration de l’assistant. Par exemple, isManaged est null pour les assistants créés dans Agent Builder.

Propriétés clés

Chemin d’accès du champ de l’API	Type de données	Description	Exemple	Statut
`properties.displayName`	chaine	Le nom d’affichage de l’assistant.	`Customer support agent`	Disponibilité générale
`properties.name`	GUID	L’ID de l’assistant dans l’environnement Dataverse spécifique (ID agent CDS).	`aaaa0000-bb11-2222-33cc-444444dddddd`	Disponibilité générale
`properties.createdAt`	DateHeure	Date et heure de création de l’assistant.	`2024-12-13T04:00:00Z`	Disponibilité générale
`properties.createdBy`	GUID	Identificateur Entra de l’utilisateur qui a créé l’assistant.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Disponibilité générale
`properties.ownerId`	chaine	L’ID d’objet (Entra ID) du propriétaire actuel de l’assistant.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Disponibilité générale
`properties.environmentId`	chaine	L’identifiant de l’environnement Power Platform qui contient la ressource.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Disponibilité générale
`properties.lastPublishedAt`	DateHeure	Date et heure de la dernière publication de l’assistant. Vide/nul si l’assistant est toujours à l’état de brouillon.	`2026-01-15T10:30:00Z`	Disponibilité générale
`properties.createdIn`	chaine	L’outil de création dans lequel l’assistant a été créé : Copilot Studio ou Microsoft 365 Copilot Assistant Builder.	`Copilot Studio`	Disponibilité générale
`properties.schemaName`	chaine	Nom du schéma Dataverse. Disponible pour les assistants Copilot Studio et les assistants Microsoft 365 Copilot Agent Builder.	`cr5e3_agentName`	Disponibilité générale
`properties.isQuarantined`	Booléen	Indique si l’assistant est actuellement en quarantaine.	`false`	Version préliminaire
`properties.quarantinedAt`	DateHeure	Date et heure de la dernière mise en quarantaine de l’assistant.	`2026-02-01T08:00:00Z`	Version préliminaire
`properties.isManaged`	Booléen	Indique si l’assistant fait partie d’une solution Dataverse gérée. Nul pour les assistants créés dans Agent Builder.	`false`	Version préliminaire

Propriétés d’identité Entra

Chemin d’accès du champ de l’API	Type de données	Description	Exemple	Statut
`properties.botId`	chaine	Identifiant du bot CDS dans l’environnement.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Disponibilité générale
`properties.entraAppId`	chaine	ID d’inscription d’application Entra associé à l’assistant, lorsqu’il existe.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Disponibilité générale
`properties.entraAgentId`	chaine	ID d’identité Entra assistant, lorsqu’il existe.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Disponibilité générale
`properties.entraAgentBlueprintId`	chaine	ID d’identité du Blueprint de l’assistant Entra, lorsqu’il existe.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Disponibilité générale

Note

Toutes les propriétés d’identité ne sont pas disponibles pour tous les types d’assistants : entraAppId est un identifiant hérité, les assistants plus récents utilisent entraAgentId et entraAgentBlueprintId. Ces champs ne sont renseignés que lorsqu’ils sont applicables à l’assistant concerné. Aucune de ces propriétés d’identité ne s’applique aux assistants Microsoft 365 Copilot Agent Builder.

Pour en savoir plus sur les concepts d’identité d’Entra, consultez Enregistrement d’applications, identités des assistants et authentification pour Copilot Studio.

Propriétés de configuration

Chemin d’accès du champ de l’API	Type de données	Description	Exemple	Statut
`properties.orchestration`	chaine	Le mode d’orchestration de l’assistant (en savoir plus dans modes d’orchestration).	`Generative`	Version préliminaire
`properties.model`	chaine	Le modèle IA utilisé par l’assistant.	`gpt-4o`	Version préliminaire
`properties.authentication`	chaine	Le mode d’authentification configuré pour l’assistant (en savoir plus dans Modes d’authentification).	`Microsoft Entra`	Version préliminaire
`properties.channels`	tableau	Les noms d’affichage des canaux sur lesquels l’assistant est publié.	`["Teams","SharePoint"]`	Version préliminaire
`properties.sharedWithViewers`	object	Nombre d’utilisateurs lecteurs (`userCount`) et de groupes de lecteurs (`groupCount`) avec lesquels l’assistant est partagé. Si un créateur a partagé l’assistant 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`	Version préliminaire
`properties.sharedWithEditors`	object	Nombre d’utilisateurs éditeurs (`userCount`) et de groupes d’éditeurs (`groupCount`) avec lesquels l’assistant est partagé.	`"groupCount": 0, "userCount": 0`	Version préliminaire
`properties.capabilitiesCounts`	object	Nombre total distinct de chaque type de capacités configurées	`"distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0`	Version préliminaire

Modes d’orchestration

Le champ properties.orchestration accepte les valeurs suivantes :

active	Description
Classique	L’assistant utilise une orchestration classique basée sur des rubriques avec des arbres de dialogue créés.
Générative	L’assistant utilise l’orchestration générative, où un modèle IA sélectionne dynamiquement les rubriques et les actions.

Modes d’authentification

Le champ properties.authentication accepte les valeurs suivantes :

active	Description
Aucune	Aucune authentification requise.
Microsoft Entra	Authentification avec Microsoft Entra ID.
Generic OAuth 2.0	Authentification via un fournisseur OAuth 2.0 générique.

Capacités de l’agent

Cette section énumère les capacités (outils et connaissances) de l’assistant. Actuellement, il n’affiche que des données détaillées sur les connecteurs utilisés par l’assistant et une configuration de connaissances, comme détaillé dans les sections suivantes.

L’inventaire a une limite maximale de 200 ressources de chaque type par assistant. Pour en savoir plus, accédez à Limitations connues.

L’inventaire supprime automatiquement les ressources en double, comme un connecteur Power Platform que vous avez configuré deux fois dans un assistant 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 assistant. Chaque connecteur est identifié par son connectorId (chaîne contenant l’identifiant de ressource du connecteur ; par exemple, shared_excelonlinebusiness). Pour chaque connecteur configuré, il existe une liste de paramètres configurés operations. La liste comprend les propriétés suivantes :

Propriété	Type de données	Description	Statut
`OperationId`	chaine	L’identifiant de l’opération spécifique à l’intérieur du connecteur ; par exemple, `AddRowV2`	Version préliminaire
`createdBy`	GUID	L’utilisateur qui a configuré l’opération	Version préliminaire
`isEnabled`	Booléen	Indique si l’opération du connecteur est actuellement activée	Version préliminaire
`usedAs`	chaine	Comment l’opération est utilisée : `Tool` s’il est configuré comme un outil général `Topic Tool` si elle est configurée comme un outil dans une rubrique spécifique `Knowledge` si le connecteur est configuré comme source de connaissances	Version préliminaire
`requiresEndUserConsent`	Booléen	Si les utilisateurs finaux doivent consentir avant que l’assistant puisse utiliser l’opération	Version préliminaire
`whenCanBeUsed`	chaine	Lorsque l’opération peut être appelée : `Anytime` si l’outil est disponible pour l’assistant sans aucune limitation `ViaDirectReferenceOnly` si l’assistant n’utilise l’outil que lorsque le créateur l’a explicitement configuré dans des rubriques spécifiques `Conditional` si l’assistant peut utiliser l’outil selon une logique prédéfinie par le créateur	Version préliminaire
`connectionProvider`	chaine	Qui fournit la connexion pour l’opération : `User` si l’utilisateur final fournit des informations d’identification en temps d’exécution `Maker` si le concepteur définit la connexion lors de la création	Version préliminaire
`connectionIdSharedByMaker`	GUID	ID de connexion, rempli uniquement lorsque `connectionProvider = Maker`	Version préliminaire

Exemple

{
  "type": "microsoft.copilotstudio/agents",
  "properties": {
    "displayName": "Customer Support Agent",
    "createdIn": "Copilot Studio",
    "powerPlatformConnectors": [
      {
        "connectorId": "shared_excelonlinebusiness",
        "operations": [
          {
            "operationId": "RunScriptProd",
            "usedAs": "Tool",
            "isEnabled": true,
            "requiresEndUserConsent": false,
            "whenCanBeUsed": "ViaDirectReferenceOnly",
            "connectionProvider": "Maker",
            "connectionIdSharedByMaker": "11112222-3333-4444-5555-666677778888",
            "createdBy": "52bff06b-5db5-42cd-9919-28f95e3c07af"
          }
        ]
      }
    ],
    "capabilitiesCounts": {
      "distinctPowerPlatformConnectors": 2,
      "distinctPowerPlatformConnectorsOperations": 3
    }
  }
}

Propriétés de la connaissance

L’inventaire inclut la propriété suivante pour la base de connaissances :

Propriété	Type de données	Description	Status
`IsWebSearchEnabledForKnowledge`	Booléen	Vrai si l’assistant peut utiliser la recherche web comme source de connaissances	Version préliminaire

Limitations connues

Les assistants V1 ne sont pas suivis - L’inventaire n’inclut pas les assistants créés avec le moteur d’exécution Power Virtual Agents V1 d’origine. Il ne suit que les assistants V2 (Copilot Studio).
Les propriétés d’identité peuvent ne pas être disponibles pour tous les assistants - Les champs entraAgentId et entraAgentBlueprintId sont renseignés uniquement pour les assistants approvisionnés avec le nouveau modèle d’identité Entra. Les anciens assistants peuvent n’avoir que entraAppId, et les assistants Microsoft 365 Copilot Agent Builder ne disposent d’aucune de ces propriétés d’identité.
Nombre de capacités - L’inventaire a une limite de 200 ressources maximum par type et par assistant. Si un assistant a configuré plus de 200 ressources d’un même type (par exemple, des connecteurs Power Platform), l’inventaire en affiche 200 sélectionnées au hasard. Les administrateurs peuvent utiliser le champ capabilitiesCounts afin de connaître le nombre de ressources configurées par type dans un assistant.

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-07-30

Inventaire d’assistant Microsoft Copilot Studio

Propriétés de l’assistant

Propriétés clés

Propriétés d’identité Entra

Propriétés de configuration

Modes d’orchestration

Modes d’authentification

Capacités de l’agent

Propriétés du connecteur

Exemple

Propriétés de la connaissance

Limitations connues

Contenu associé

Commentaires

Ressources supplémentaires