Schéma d’inventaire des agents Copilot Studio

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. Pour obtenir une vue d’ensemble de la fonctionnalité d’inventaire, consultez l’inventaire Power Platform.

Propriétés clés

Chemin du champ API Type de données Description Exemple État
properties.ownerId ficelle ID d’objet du propriétaire de la ressource. aaaa0000-bb11-2222-33cc-444444dddddd Généralement disponible
properties.environmentId ficelle Identificateur de l’environnement 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 si l’agent est toujours en brouillon. 2026-01-15T10:30:00Z Généralement disponible
properties.createdIn ficelle 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 ficelle 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 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 managée. false Aperçu

Propriétés d’identité

Chemin du champ API Type de données Description Exemple État Disponible pour
properties.botId ficelle ID du bot CDS dans l’environnement. aaaa0000-bb11-2222-33cc-444444dddddd Généralement disponible Agents de Copilot Studio, agents du Microsoft 365 Copilot Agent Builder
properties.entraAppId ficelle ID d’inscription de l’application Entra. aaaa0000-bb11-2222-33cc-444444dddddd Généralement disponible Agents de Copilot Studio
properties.entraAgentId ficelle ID d’identité de l’agent Entra. aaaa0000-bb11-2222-33cc-444444dddddd Généralement disponible Agents de Copilot Studio
properties.entraAgentBlueprintId ficelle ID de blueprint de l’agent Entra. aaaa0000-bb11-2222-33cc-444444dddddd Généralement disponible Agents de Copilot Studio

Note

Le entraAppId champ est un identificateur hérité. Les agents plus récents utilisent entraAgentId et entraAgentBlueprintId à la place. Aucune de ces propriétés d’identité ne s’applique aux agents Microsoft 365 Copilot Agent Builder.

Propriétés de configuration

Chemin du champ API Type de données Description Exemple État
properties.orchestration ficelle Mode d’orchestration de l’agent (voir modes d’orchestration). Generative Aperçu
properties.model ficelle Modèle IA utilisé par l’agent. gpt-4o Aperçu
properties.authentication ficelle Mode d’authentification configuré pour l’agent (voir 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

Modes d’orchestration

Les valeurs suivantes sont possibles pour le properties.orchestration champ.

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

Modes d’authentification

Les valeurs suivantes sont possibles pour le properties.authentication champ.

Valeur 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.

Limitations connues

  • Les agents V1 ne sont pas suivis. Les agents créés avec le runtime Power Virtual Agents V1 d’origine ne sont pas inclus dans l’inventaire. Seuls les agents V2 (Copilot Studio) sont suivis.
  • Les propriétés d’identité peuvent ne pas être disponibles pour tous les agents. Les champs entraAgentId et entraAgentBlueprintId sont renseignés uniquement pour les agents qui ont été configurés avec le nouvelle modèle d'identité d'agent Entra. Les anciens agents peuvent uniquement avoir entraAppId, et les agents Microsoft 365 Copilot Agent Builder n’ont aucune de ces propriétés d’identité.

Contenu connexe

  • Last updated on