Skip to content

title: AI Agent Resources url: https://documentation.sailpoint.com/connectors/microsoft/entra_id/saas/help/datasets/ai_agent_resources.html tags: - Microsoft Foundry Resources - Microsoft Agent 365 Catalog Resources - Microsoft Copilot Studio Resources

AI Agent Resources

Microsoft Foundry Resources

The Microsoft Foundry dataset includes the following resources, which are collected together during dataset aggregation.

Resource name Resource type Resource ID
Microsoft Foundry Agent Agent azure:foundry-agent
Microsoft Foundry Tool Capability azure:foundry-tool
Microsoft Foundry Agent Has Tool Access azure:agent-has-tool
Microsoft Foundry Agent Has Connected Sub-Agent Access azure:agent-has-connected-agent

Microsoft Foundry Agent

Field Value
Resource ID azure:foundry-agent
Resource type std:agent
Identity attribute id
Display attribute name

The following table lists schema attributes for the Microsoft Foundry Agent resource:

Attribute Description Type Entitlement Multi-valued
agentName The agent name or lineage identifier (for example, teams-agent). string No No
atomic_unit The stable GUID shared across all versions of the same agent lineage. string No No
agentLaunchId The Azure Resource Manager (ARM) resource path for the Foundry project. The connector uses this value during provisioning to construct deployment operations. string No No
blueprintClientId The client ID portion of the agent blueprint managed identity. Empty for legacy agents. string No No
blueprintId The stable, human-readable blueprint identifier (for example, teams-agent-safe). Empty for legacy agents. string No No
blueprintPrincipalId The Microsoft Entra object ID of the agent blueprint service principal (managed identity). Empty for legacy agents. string No No
blueprintType The blueprint type (for example, ManagedIdentityBaseBlueprint). Empty for legacy agents. string No No
createdAt The ISO-8601 timestamp when the agent version was created. string No No
createdBy The identity that created the parent Foundry project resource through ARM provisioning, stored in systemData.createdBy. This is not the RBAC owner. string No No
deploymentNames The ARM deployment names that reference this agent version. string No No
description The description of the agent version. string No No
id The primary key for the agent. For classic Foundry agents, the value follows the ProjectName/versionId format. string No No
instanceClientId The client ID of the agent instance service principal. When present, this value matches the Microsoft Graph agent identity. string No No
instancePrincipalId The Microsoft Entra object ID of the agent instance service principal. Empty for legacy agents. string No No
instructions The system prompt or instructions for this agent version. string No No
kind The agent kind. Possible values include prompt, toolset, workflow, and container_app. string No No
lastModifiedBy The identity that last modified the parent Foundry project resource through ARM provisioning, stored in systemData.lastModifiedBy. This is not the RBAC owner. string No No
model The AI model assigned to the agent (for example, gpt-4o or gpt-4). string No No
modifiedAt The ISO-8601 timestamp when the agent version was last modified, sourced from metadata:modifiedAt. string No No
name The display name of the agent or assistant. string No No
operationalDate The ARM deployment state for published versions. Possible values are Running and Stopped. string No No
primary_deploymentName The ARM deployment name the connector uses for step or start operations. string No No
projectName The name of the Foundry project that contains the agent (for example, TestProject). string No No
published Indicates whether the agent version is published (true when at least one ARM deployment exists for the version). boolean No No
response_format The response format setting for the agent. Supported for classic Foundry agents only. string No No
saasInstanceLocation The source SaaS instance name (Azure AI Foundry). string No No
status The operational state of the agent. Possible values are Active, Running, and Inactive (Stopped). Empty when the agent is not yet deployed. string No No
temperature The temperature parameter for the agent. Supported for classic Foundry agents only. int No No
tools The simplified list of tools allowed for this agent version. string No No
top_p The top-p sampling parameter for the agent. Supported for classic Foundry agents only. int No No
version The version label for the agent (for example, latest or v1). string No No
versionId The version ID for the agent (for example, 1, 2, or a raw ID). string No No
Version Status The lifecycle status returned by the project API (for example, active). string No No

Microsoft Foundry Tool

Field Value
Resource ID azure:foundry-tool
Resource type std:capability
Identity attribute identity
Display attribute name

The following table lists schema attributes for the Microsoft Foundry Tool resource:

Attribute Description Type Entitlement Multi-valued
identity The unique identifier for the tool, constructed from the agent identity, tool type, and tool name or ID. string No No
name The display name of the tool. Empty for file_search and code_interpreter tool types.
toolResourceId The fallback identifier for tools without a name, such as a file_search vector store ID or a code_interpreter resource ID.
toolType The category of the tool. Possible values include openapi, file_search, code_interpreter, and other.

Microsoft Foundry Agent Has Tool

Field Value
Resource ID azure:agent-has-tool
Resource type std:access
Identity attribute identity
Display attribute identity

The following table lists schema attributes for the Microsoft Foundry Agent Has Tool resource:

Attribute Description Type Entitlement Multi-valued
identity Unique identifier of the access link between a Microsoft Foundry agent and a tool. string No No
linkResolvedBy Service that resolved this link( during aggregation.??) string No No

Microsoft Foundry Agent Has Connected Sub-Agent

Field Value
Resource ID azure:agent-has-connected-agent
Resource type std:access
Identity attribute identity
Display attribute identity

The following table lists schema attributes for the Microsoft Foundry Agent Has Connected Sub-Agent resource:

Attribute Description Type Entitlement Multi-valued
identity Unique identifier of the access link between a Microsoft Foundry agent and a connected sub-agent. string No No
linkResolvedBy Service that resolved this link during aggregation. string No No

Microsoft Agent 365 Catalog Resources

The Microsoft 365 Agent Catalog dataset includes the following resources, which are collected together during dataset aggregation.

Resource name Resource type Resource ID
Microsoft Agent 365 Agent microsoft:agent365-package
Microsoft Agent 365 Package Service Principal Access microsoft:agent365-uses-service-principal

Microsoft Agent 365

Field Value
Resource ID microsoft:agent365-package
Resource type std:agent
Identity attribute identity
Display attribute name

The following table lists schema attributes for Microsoft Agent 365 resource:

Attribute Name Attribute Details
agentIdentityBlueprintId The Microsoft Entra Blueprint service principal application ID linked to the catalog package.
agentIdentityId The Microsoft Entra AgentIdentity service principal object ID linked to the catalog package. For line-of-business packages without element details, this value falls back to appId. Used as the machine account key.
appId The application ID for the catalog package, when present.
assetId The asset ID for the catalog package, when present.
availableTo The availability scope for the catalog package.
catalogPackageType The Microsoft Graph copilot package type. Possible values include shared, lob, and thirdParty.
deployedTo The deployment scope for the catalog package.
elementTypes The element types included in the catalog package. This is a multi-valued attribute.
identity The unique catalog package identifier (for example, T_xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx or P_...).
isBlocked Indicates whether the catalog package is blocked (true) or unblocked (false). Block and unblock operations are supported only for Foundry and Microsoft 365 Copilot Agent Builder packages.
lastModifiedDateTime The ISO-8601 timestamp when the catalog package was last modified.
longDescription The long description of the catalog package.
manifestId The manifest ID for the catalog package, when present.
manifestVersion The manifest version of the catalog package.
name The display name of the catalog package.
ownerId The object ID of the catalog package owner, when present.
platform The platform where the agent was created. Possible values include Foundry, Microsoft 365 Copilot Agent Builder, and Copilot Studio.
publisher The publisher of the catalog package.
shortDescription The short description of the catalog package.
spBusinessApplication The source business application name (Microsoft Agent 365).
spStatus The status of the catalog package. Possible values are Active (when isBlocked is false) and Inactive (when isBlocked is true). This value is empty when the blocked state is unknown.
supportedHosts The hosts where the catalog package runs. This is a multi-valued attribute.
version The version of the catalog package.

Microsoft Agent 365 Package Service Principal

Field Value
Resource ID microsoft:agent365-uses-service-principal
Resource type std:access
Identity attribute identity
Display attribute identity

The following table lists schema attributes for Microsoft Agent 365 Package Service Principal resource:

Attribute Description Type Entitlement Multi-valued
identity Unique identifier for the access link between an Agent 365 catalog package and its associated Entra service principal. Constructed as microsoft:agent365-uses-service-principal#<packageId>#<servicePrincipalId>. string No No
linkResolvedBy Service that resolved this link during aggregation. string No No

Microsoft Copilot Studio Resources

The Microsoft Copilot Studio dataset includes the following resources, which are collected together during dataset aggregation.

Resource name Resource type Resource ID
Microsoft Copilot Studio Agent Agent microsoft:copilot-agent
Microsoft Copilot Studio Tool Capability microsoft:copilot-tool
Microsoft Copilot Studio Knowledge Base Capability microsoft:copilot-knowledge
Microsoft Copilot Studio File Attachment Capability microsoft:copilot-file
Microsoft Copilot Studio Agent Uses Tool Access microsoft:copilot-agent-uses-tool
Microsoft Copilot Studio Agent Uses Knowledge Base Access microsoft:copilot-agent-uses-knowledge
Microsoft Copilot Studio Agent Has File Attachment Access microsoft:copilot-agent-has-file
Microsoft Copilot Studio Agent Uses Connected Agent Access microsoft:copilot-agent-uses-agent
Microsoft Copilot Studio Connected Agent Access microsoft:copilot-connected-agent
Microsoft Copilot Studio Agent Uses Service Principal Access microsoft:copilot-agent-uses-service-principal

Microsoft Copilot Studio Agent

Field Value
Resource ID microsoft:copilot-agent
Resource type std:agent
Identity attribute identity
Display attribute name

The following table lists schema attributes for the Microsoft Copilot Studio Agent resource:

Attribute Description Type Entitlement Multi-valued
created_at The ISO-8601 timestamp when the agent was created. string No No
description The description of the Copilot agent. string No No
entraIdentityId The Microsoft Entra service principal identity associated with the agent. For legacy App Registration bots, this value is the appId. For Entra Agent ID bots, this value is the AgentIdentity service principal object ID from synchronizationstatus.botRegistration.applicationId. string No No
identity The unique identifier of the Copilot agent. string No No
name The display name of the Copilot agent. string No No
orgApiUrl The Dataverse organization API base URL for the Power Platform environment that hosts the agent. string No No
owner The owner of the agent, specified as a user principal name (UPN) or email address. string No No
spBusinessApplication The source business application name ( Microsoft Copilot Studio string No No
spStatus The lifecycle status of the agent derived from the Power Platform statecode Active statecode Inactive statecode string No No
status The operational status of the agent. Possible values are Active Inactive string No No
updated_at The ISO-8601 timestamp when the agent was last updated. string No No

Microsoft Copilot Studio Tool

Field Value
Resource ID microsoft:copilot-tool
Resource type std:capability
Identity attribute Identity
Display attribute name

The following table lists schema attributes for the Microsoft Copilot Studio Tool resource:

Attribute Description Type Entitlement Multi-valued
credentialMode The credential mode defined in connectionProperties for the tool connection. string No No
Identity The tool GUID (botcomponentid from Dataverse).
name The display name of the tool.
toolType The tool type extracted from the component data YAML.

Microsoft Copilot Studio Knowledge Base

Field Value
Resource ID microsoft:copilot-knowledge
Resource type std:capability
Identity attribute identity
Display attribute name

The following table lists schema attributes for the Microsoft Copilot Studio Knowledge Base resource:

Attribute Description Type Entitlement Multi-valued
credentialMode The credential mode defined in connectionProperties for the knowledge base connection. string No No
identity The knowledge base GUID (botcomponentid from Dataverse). string No No
name The display name of the knowledge base. string No No

Microsoft Copilot Studio File Attachment

Field Value
Resource ID microsoft:copilot-file
Resource type std:capability
Identity attribute identity
Display attribute name

The following table lists schema attributes for the Microsoft Copilot Studio File Attachment resource:

Attribute Description Type Entitlement Multi-valued
identity The file attachment GUID (botcomponentid from Dataverse). string No No
name The name of the uploaded file. string No No

Microsoft Copilot Studio Agent Uses Tool

Field Value
Resource ID microsoft:copilot-agent-uses-tool
Resource type std:access
Identity attribute identity
Display attribute identity

The following table lists schema attributes for the Microsoft Copilot Studio Agent Uses Tool resource:

Attribute Description Type Entitlement Multi-valued
identity Unique identifier of the access link between a Microsoft Copilot Studio agent and a tool. string No No
linkResolvedBy Service that resolved this link during aggregation. string No No

Microsoft Copilot Studio Agent Uses Knowledge Base

Field Value
Resource ID microsoft:copilot-agent-uses-knowledge
Resource type std:access
Identity attribute identity
Display attribute identity

The following table lists schema attributes for the Microsoft Copilot Studio Agent Uses Knowledge Base resource:

Attribute Description Type Entitlement Multi-valued
identity Unique identifier of the access link between a Microsoft Copilot Studio agent and a knowledge base. string No No
linkResolvedBy Service that resolved this link during aggregation. string No No

Microsoft Copilot Studio Agent Has File Attachment

Field Value
Resource ID microsoft:copilot-agent-has-file
Resource type std:access
Identity attribute identity
Display attribute identity

The following table lists schema attributes for the Microsoft Copilot Studio Agent Has File Attachment resource:

Attribute Description Type Entitlement Multi-valued
identity Unique identifier of the access link between a Microsoft Copilot Studio agent and a file attachment. string No No
linkResolvedBy Service that resolved this link during aggregation. string No No

Microsoft Copilot Studio Agent Uses Connected Agent

Field Value
Resource ID microsoft:copilot-agent-uses-agent
Resource type std:access
Identity attribute identity
Display attribute identity

The following table lists schema attributes for the Microsoft Copilot Studio Agent Uses Connected Agent resource:

Attribute Description Type Entitlement Multi-valued
identity Unique identifier of the access link between a Microsoft Copilot Studio agent and a connected agent. string No No
linkResolvedBy Service that resolved this link during aggregation. string No No

Microsoft Copilot Studio Connected Agent

Field Value
Resource ID microsoft:copilot-connected-agent
Resource type std:access
Identity attribute identity
Display attribute identity

The following table lists schema attributes for the Microsoft Copilot Studio Connected Agent resource:

Attribute Description Type Entitlement Multi-valued
identity Unique identifier of the access link for a Microsoft Copilot Studio connected agent. string No No
linkResolvedBy Service that resolved this link during aggregation. string No No

Microsoft Copilot Studio Agent Uses Service Principal

Field Value
Resource ID microsoft:copilot-agent-uses-service-principal
Resource type std:access
Identity attribute identity
Display attribute identity

The following table lists schema attributes for the Microsoft Copilot Studio Agent Uses Service Principal resource:

Attribute Description Type Entitlement Multi-valued
identity Unique identifier of the access link between a Microsoft Copilot Studio agent and a service principal. string No No
linkResolvedBy Service that resolved this link during aggregation. string No No

Documentation Feedback

Feedback is provided as an informational resource only and does not form part of SailPoint’s official product documentation. SailPoint does not warrant or make any guarantees about the feedback (including without limitation as to its accuracy, relevance, or reliability). All feedback is subject to the terms set forth at https://developer.sailpoint.com/discuss/tos.