Microsoft Copilot Studio Agent inventory

The Copilot Studio agent inventory provides IT and security admins with a centralized view of all agents created using Copilot Studio or Agent Builder in the tenant. The inventory covers both unpublished (draft) and published agents. For each agent, the inventory displays key metadata, such as who created the agent, when it was last published, what channels it's deployed to, how it authenticates users, its capabilities, and more. Inventory data is refreshed automatically, and changes to an agent typically appear within 20 minutes.

Administrators can consume the inventory data through multiple methods, including the Power Platform admin center, the Power Platform API, and Azure Resource Graph. For the full list of access methods and required roles, see Power Platform inventory.

This article describes the fields specific to Copilot Studio agents (microsoft.copilotstudio/agents) in the Power Platform inventory. For shared fields available on all resource types, see Power Platform inventory schema reference.

Note

The inventory doesn't include agents created with V1 of Copilot Studio (also known as Classic bots or Power Virtual Agents). However, you can still go to the Power Platform admin center and select Manage > Copilot Studio > Classic chatbots to see those agents.

Important

This article contains Microsoft Copilot Studio preview documentation and is subject to change.

Preview features aren't meant for production use and may have restricted functionality. These features are available before an official release so that you can get early access and provide feedback.

If you're building a production-ready agent, see Microsoft Copilot Studio Overview.

Agent properties

The inventory provides the following properties for each agent.

Note

  • The inventory reflects the structure of the published version of each agent. If an agent has unpublished changes (a newer draft), the inventory doesn't show those changes until the agent is published.

  • An agent's configuration affects which fields are populated. Some properties might be null depending on how the agent is set up. For example, isManaged is null for agents created in Agent Builder.

Core properties

API field path Data type Description Example Status
properties.displayName string The agent's display name. Customer support agent Generally available
properties.name GUID The agent's ID in the specific Dataverse environment (CDS bot ID). aaaa0000-bb11-2222-33cc-444444dddddd Generally available
properties.createdAt datetime Date and time the agent was created. 2024-12-13T04:00:00Z Generally available
properties.createdBy GUID Entra ID of the user who created the agent. aaaa0000-bb11-2222-33cc-444444dddddd Generally available
properties.ownerId string The object ID (Entra ID) of the agent's current owner. aaaa0000-bb11-2222-33cc-444444dddddd Generally available
properties.environmentId string The identifier of the Power Platform environment that contains the resource. aaaa0000-bb11-2222-33cc-444444dddddd Generally available
properties.lastPublishedAt datetime The date and time the agent was last published. Empty/null if the agent is still in draft. 2026-01-15T10:30:00Z Generally available
properties.createdIn string The authoring tool where the agent was created: Copilot Studio or Microsoft 365 Copilot Agent Builder. Copilot Studio Generally available
properties.schemaName string The Dataverse schema name. Available for Copilot Studio agents and Microsoft 365 Copilot Agent Builder agents. cr5e3_agentName Generally available
properties.isQuarantined boolean Whether the agent is currently quarantined. false Preview
properties.quarantinedAt datetime The date and time the agent was last quarantined. 2026-02-01T08:00:00Z Preview
properties.isManaged boolean Whether the agent is part of a managed Dataverse solution. Null for agents created in Agent Builder. false Preview

Entra identity properties

API field path Data type Description Example Status
properties.botId string The CDS bot ID in the environment. aaaa0000-bb11-2222-33cc-444444dddddd Generally available
properties.entraAppId string Entra App Registration ID associated with the agent, when exists. aaaa0000-bb11-2222-33cc-444444dddddd Generally available
properties.entraAgentId string Entra Agent Identity ID, when exists. aaaa0000-bb11-2222-33cc-444444dddddd Generally available
properties.entraAgentBlueprintId string Entra Agent Blueprint ID, when exists. aaaa0000-bb11-2222-33cc-444444dddddd Generally available

Note

Not all identity properties are available for all agent types: entraAppId is a legacy identifier, newer agents use entraAgentId and entraAgentBlueprintId. These fields are populated only when applicable to the specific agent. None of these identity properties apply to Microsoft 365 Copilot Agent Builder agents.

To learn more about Entra identity concepts, see App registration, agent identities, and authentication for Copilot Studio.

Configuration properties

API field path Data type Description Example Status
properties.orchestration string The orchestration mode of the agent (learn more in Orchestration modes). Generative Preview
properties.model string The AI model used by the agent. gpt-4o Preview
properties.authentication string The authentication mode configured for the agent (learn more in Authentication modes). Microsoft Entra Preview
properties.channels array The display names of the channels the agent is published to. ["Teams","SharePoint"] Preview
properties.sharedWithViewers object Count of individual viewer users (userCount) and viewer groups (groupCount) the agent is shared with. If a maker shared the agent with the entire tenant, entireTenant is set to true, even if an admin didn't approve the sharing. "groupCount": 0, "userCount": 0, "entireTenant": false Preview
properties.sharedWithEditors object Count of individual editor users (userCount) and editor groups (groupCount) the agent is shared with. "groupCount": 0, "userCount": 0 Preview
properties.capabilitiesCounts object Total distinct count of each type of configured capabilities "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Preview

Orchestration modes

The properties.orchestration field accepts the following values:

Value Description
Classic The agent uses classic topic-based orchestration with authored dialog trees.
Generative The agent uses generative orchestration, where an AI model dynamically selects topics and actions.

Authentication modes

The properties.authentication field accepts the following values:

Value Description
None No authentication required.
Microsoft Entra Authentication via Microsoft Entra ID.
Generic OAuth 2.0 Authentication via a generic OAuth 2.0 provider.

Agent capabilities

This section lists the capabilities (tools and knowledge) of the agent. Currently, it only displays detailed data on connectors used by the agent and a knowledge configuration as detailed in the following sections.

The inventory has a limitation of maximum 200 resources of each type per agent. Learn more in Known limitations.

The inventory automatically removes duplicate resources, such as a Power Platform connector that you configured twice in an agent with the same configuration.

Connector properties

The inventory includes an array called powerPlatformConnectors, which contains the Power Platform connectors configured in an agent. Each connector is identified by its connectorId (a string containing the connector's resource ID; for example, shared_excelonlinebusiness). For each configured connector, there's a list of configured operations. The list includes the following properties:

Property Data type Description Status
OperationId string The ID of the specific operation within the connector; for example, AddRowV2 Preview
createdBy GUID The user who configured the operation Preview
isEnabled boolean Whether the connector operation is currently enabled Preview
usedAs string How the operation is used:
  • Tool if configured as a general tool
  • Topic Tool if configured as a tool in a specific topic
  • Knowledge if the connector is configured as a knowledge source
 Preview
requiresEndUserConsent boolean Whether end users must consent before the agent can use the operation Preview
whenCanBeUsed string When the operation can be invoked:
  • Anytime if the tool is available to the agent with no limitations
  • ViaDirectReferenceOnly if the agent uses the tool only when maker explicitly configured it in specific topics
  • Conditional if the agent can use the tool according to a predefined logic by the maker
 Preview
connectionProvider string Who provides the connection for the operation:
  • User if the end user provides credentials in runtime
  • Maker if the maker sets the connection at authoring time
 Preview
connectionIdSharedByMaker GUID Connection ID, populated only when connectionProvider = Maker Preview

Knowledge properties

The inventory includes the following property for knowledge:

Property Data type Description Status
IsWebSearchEnabledForKnowledge boolean True if the agent can use web search as a knowledge source Preview

Known limitations

  • V1 agents aren't tracked - The inventory doesn't include agents created with the original Power Virtual Agents V1 runtime. It only tracks V2 (Copilot Studio) agents.
  • Identity properties might not be available for all agents - The entraAgentId and entraAgentBlueprintId fields are populated only for agents that are provisioned with the newer Entra agent identity model. Older agents might only have entraAppId, and Microsoft 365 Copilot Agent Builder agents don't have any of these identity properties.
  • Capabilities count - The inventory has a limitation of maximum 200 resources of each type per agent. If an agent has more than 200 configured resources from a specific type (for example, Power Platform connectors), the inventory displays random 200. Admins can use the capabilitiesCounts field to understand how many resources are configured in an agent per type.

Related content

  • Last updated on