Agent Builder Agent

Agents built with Agent Builder in Microsoft 365 Copilot (declarative agents), registered in the tenant agent registry. Each package may contain one or more elements.

Part of the Copilot inventory.

Scan settings

Default scanning interval	Allowed scanning intervals	Data removal during incremental scan
Daily	Daily, Weekly, Bi-Weekly, Monthly, Never, Initial	Yes

Properties

Property	Type	Description	Automation placeholder
App id	String	Application identifier the package is associated with.	{{AgentBuilderAgent.AppId}}
Asset id	String	Asset identifier the package is associated with.	{{AgentBuilderAgent.AssetId}}
Available to	String	Audience scope that can find and install the package (allowedForAll, allowedForSome, allowedForNone).	{{AgentBuilderAgent.AvailableTo}}
Copilot Studio agent	Copilot Agent	Resolved relation to the Copilot Studio agent this package was published from. Joined on the backing Entra app id (CustomCopilotEntity.EntryIdApplicationId == this.AppId). Null when the package didn't originate from Copilot Studio or the Copilot Studio agent hasn't been inventoried.	{{AgentBuilderAgent.CopilotStudioAgent}}
Copilot Studio agent name	String	Display name of the linked Copilot Studio agent. Computed during inventory.	{{AgentBuilderAgent.CopilotStudioAgentName}}
Initially Scanned	DateTime	Shows when this object was initially found in a scan.	{{AgentBuilderAgent.CreatedTime}}
Deployed to	String	Audience scope the package is deployed to (acquiredForAll, acquiredForSome, acquiredForNone).	{{AgentBuilderAgent.DeployedTo}}
Display Name	String		{{AgentBuilderAgent.DisplayName}}
Element types	String	Comma-separated list of element types contained in the package (DeclarativeCopilots, CustomEngineCopilots, Bots, OfficeAddIns, ExchangeAddIns, StaticTabs, ConfigurableTabs, ComposeExtensions).	{{AgentBuilderAgent.ElementTypes}}
Has custom engine agent	Boolean	True when the package also contains a custom engine agent element (elementTypes contains CustomEngineCopilots).	{{AgentBuilderAgent.HasCustomEngineAgent}}
Id	String	Microsoft Graph package identifier.	{{AgentBuilderAgent.Id}}
Is blocked	Boolean	True when the agent is blocked from use across the organization.	{{AgentBuilderAgent.IsBlocked}}
Last modified	DateTime	Last time the package metadata changed in the agent registry.	{{AgentBuilderAgent.LastModifiedDateTime}}
Last scan update	DateTime	Shows when this object was last updated in a scan. If an object is found during a scan but no property has been changed this date will not change.	{{AgentBuilderAgent.LastModifiedTime}}
Manifest id	String	Manifest identifier reported by the package.	{{AgentBuilderAgent.ManifestId}}
Manifest version	String	Manifest schema version reported by the package.	{{AgentBuilderAgent.ManifestVersion}}
Platform	String	How the agent was built, as classified by the Microsoft 365 admin center Platform column. Allowed values: Agent Builder in M365 Copilot, Copilot Studio, Other, SharePoint.	{{AgentBuilderAgent.Platform}}
Publisher	String	Publisher of the package.	{{AgentBuilderAgent.Publisher}}
Risk Score	Int32	Stores risk score	{{AgentBuilderAgent.RiskScore}}
Risk Score Update	DateTime	Stores risk score update	{{AgentBuilderAgent.RiskScoreLastUpdate}}
Risk Score Value	String	Stores risk score value like Low_Low	{{AgentBuilderAgent.RiskScoreValue}}
Short description	String	Short description of the agent.	{{AgentBuilderAgent.ShortDescription}}
Supported hosts	String	Comma-separated list of hosts the package can run in (Copilot, Outlook, Teams, M365, Word, Excel, PowerPoint).	{{AgentBuilderAgent.SupportedHosts}}
Type	String	Package source type as reported by Microsoft Graph (firstParty = Microsoft, thirdParty = partner/store, lob = built in-house, shared = shared within the org). Allowed values: firstParty, lob, shared, thirdParty.	{{AgentBuilderAgent.Type}}
Version	String	Version reported by the package manifest.	{{AgentBuilderAgent.Version}}

Relations

Relation	Service	Description
Agent Builder Action	Copilot	Action the agent can perform.
Agent Builder Capability	Copilot	Capability the agent can use.
Agent Builder Element	Copilot	Individual elements (declarative agents, custom engine agents, bots, add-ins) contained within an Agent Builder agent package.
Agent Builder Knowledge Source	Copilot	Knowledge source the agent reads from.
Copilot Agent	Copilot Studio	Agents created inside Copilot Studio.

Segments

Segment	Description
Agent Builder Agents	Lists active agents built with Agent Builder in Microsoft 365 Copilot.

Actions

This object does currently not have any actions.