Product

Microsoft Entra Agent ID

Track documentation and Message Center changes for Microsoft Entra Agent ID.

Microsoft Learn documentation ↗

Latest Microsoft Entra Agent ID changes

Agent Default Inactivity Policy

Governance

The Agent ID default inactivity policy page updates links to related lifecycle policy and end-user agent management documentation.

Agent Id Governance Overview

Microsoft identity platform

The agent identity overview revises wording about automatically assigning identities to Microsoft Copilot Studio agents and creating the related identity blueprint.

My Access Portal Overview

Fundamentals

The overview’s guidance on managing agent identities and viewing their access and activity information was updated.

Entra Agent ID lifecycle policies (preview)

Governance

The documentation now directs administrators to **Agent ID (Preview)** instead of **Agent IDs**, and updates the introductory wording about agent identity lifecycle risks.

Microsoft Entra Agent ID default inactivity policy

Governance

The documentation describes a preview policy that notifies owners after 60 days of inactivity, disables identities after 90 days, and deletes them after 455 days. Administrators can enable it, configure its scope, and set fallback notification recipients.

Disable Agent Identities

General

The documented procedure now uses **Disable** > **Disable in all tenants** and specifies that the impact applies to multi-tenant blueprints.

Disable Agent Identities

General

The documentation now explains that globally disabling a blueprint can cause related agents in other tenants to fail or lose functionality. It also adds steps for disabling a blueprint in the Microsoft Entra admin center.

Create Blueprint

General

The documentation now states that when **Users can create agent blueprints** is set to **Yes**, any tenant user can create an agent identity blueprint and its principal. Otherwise, the Agent ID Developer and Agent ID Administrator roles can create them.

Entra Agent ID lifecycle policies

Governance

The article explains how to create policies for agent identities, including periodic reconfirmation, minimum sponsor requirements, inactivity monitoring, notifications, grace periods, and enforcement actions. The capability is in preview.

Investigate Agent ID autonomous sign-ins

Authentication

Adds a how-to article explaining Health Monitoring signals and alerts, log correlation, impact criteria, troubleshooting, and prerequisites for autonomous agent sign-ins. The monitoring and alerts are documented as being in preview.

Investigate Agent ID interactive sign-ins

Authentication

A new how-to explains how to interpret Health Monitoring signals, correlate agent properties with sign-in and audit logs, and mitigate common failures. It also identifies the relevant non-interactive sign-in logs and documents licensing and role prerequisites.

Agent Id

Conditional Access

The documentation now states that Conditional Access evaluates the signed-in user who is the token subject, including users targeted directly or through groups. Selecting an agent identity does not cover OBO traffic.

Agent Id

General

The documentation clarifies that policies scoped through the Users assignment do not apply to agent user accounts, regardless of whether they target all users, selected users, groups, directory roles, or external users. To protect agents, select Agents under Users, agents, or workload identities.

Agent Id

Conditional Access

The documentation clarifies that Conditional Access policies targeting agent identities do not apply to on-behalf-of (OBO) traffic, because the user is the subject of that flow.

Agent Id

General

The documentation now identifies the agent identity, rather than the application or autonomous agent, as the subject in application-only access.

Agent Id

Conditional Access

The Agent ID documentation now uses the correct anchor for the “Allow approved agents by using custom security attributes” policy example.

Agent Id

Conditional Access

The policy example link now points to the `use-custom-security-attributes` section.

Agent Id

General

The Conditional Access Agent ID page now links to Microsoft Agent 365 plans and pricing instead of the Agent ID getting-started information.

Agent Id

Conditional Access

The Microsoft Agent 365 licensing prerequisite bullet was reformatted for consistency.

Agent Id

Conditional Access

The documentation now states that Microsoft Entra ID Conditional Access for agents requires an eligible license plan, including Microsoft 365 E7 with Agent 365 and Microsoft Entra Suite. The explanatory governance phrase was removed.

Agent Id

Conditional Access

The licensing requirements now list Microsoft 365 E7, or Microsoft Agent 365 paired with at least Microsoft Entra P1 or Microsoft 365 E3.

Conditional Access for agents

Conditional Access

The documentation now refers to real-time risk information, rather than session risk information, among the signals used to determine access.

Conditional Access for Agents in Microsoft Entra

Conditional Access

The overview now explains policy decisions, evaluation timing, token subjects and audiences, and supported agent access patterns. It also adds links to related identity-management and policy guidance.

Howto Target Agent Identities

General

The agent identity targeting documentation now links to the relevant section on Conditional Access policies and agent identity blueprints.

Microsoft Entra Conditional Access for agents overview

Conditional Access

The overview now explains how Conditional Access evaluates the token subject and resource, and distinguishes delegated, agent-identity, and agent-user-account scenarios. Licensing and network-control requirements remain documented.

Policy Autonomous Agents

Conditional Access

The autonomous agents policy documentation now includes a section for custom security attributes in policies.

Secure agents that act as users with Conditional Access

Conditional Access

The page now covers agent identities and additional policy options, including custom security attributes, agent execution environments, device compliance, network locations, and agent risk. It also updates policy creation steps and links.

Secure autonomous agents with Conditional Access

Conditional Access

The article now documents the enhanced object picker for selecting agent identities and blueprints, updates policy-creation steps, and notes that an Agent 365 license will soon be required.

Secure autonomous agents with Microsoft Entra Conditional Access

Conditional Access

The article now focuses on Conditional Access for agents using their own identities, adds prerequisites, clarifies that policies target agent identities rather than users, and recommends report-only block policies for unapproved agents.

Agent Access Packages

General

The documentation now states more clearly that an agent needs assigned OAuth delegated permissions to assist a user when accessing a target resource’s APIs.

Agent Access Packages

General

The documentation now states that agent identities need delegated OAuth permissions for target resources, such as Microsoft Graph or an application, to assist users with API access.

Agent Id Governance Overview

Standards

The documentation now describes the linked guidance as covering delegated and application permissions for Microsoft Graph and applications.

Call Api Azure Services

Developer

The documentation corrects spelling errors, including “credentials,” and adds missing punctuation to a step describing token credentials and Azure SDK clients.

Entitlement Management Access Package Resources

Governance

The documentation now identifies the resource role as applying to an AI agent’s service principal or agent ID and adds numbered steps for selecting API permissions, permission type, required permissions, and updating the configuration.

Integrate N8n Agent

General

The n8n agent integration page no longer includes the `author` and `ms.author` metadata fields.

Authorization Agent Id

Developer

The documentation now describes blocked highly privileged directory roles for agent identities without the obsolete custom-role restriction wording.

Agent Users

Authentication

The documentation now states that agent user accounts can be assigned custom roles, while privileged administrator roles remain restricted.

Authorization Agent Id

General

The authorization documentation now states that custom roles can be assigned to agents.

Conditional Access for Agents in Microsoft Entra

Conditional Access

The documentation now distinguishes agents acting for signed-in users, using their own identity, or using an agent user account. It adds separate guidance links for autonomous agents and agent users and updates the listed licensing combinations.

Secure autonomous agents with Conditional Access

Conditional Access

The article now presents Conditional Access for autonomous agents as a scenario-based pattern, adds prerequisites, and recommends starting block policies in report-only mode. It also notes that an Agent 365 license will soon be required.

Target agents in Microsoft Entra Conditional Access policies

Conditional Access

The article now uses a scenario-based structure, explains that conditions and controls depend on the token subject, and links separately to guidance for agent identities and agent user accounts. Terminology, metadata, and related links were also updated.

Migrate Copilot Studio agents to Microsoft Entra Agent ID

Message CenterMC1478488 on mc.merill.net ↗Stay informed
Conditional Access

On August 24, 2026, we initiated the gradual roll out of self-service migrations to Microsoft Entra Agent IDs for Copilot Studio agents in Power Platform Advisor. Beginning on September 2026, automatic migrations of agents without Entra Agent ID to Microsoft Entra Agent ID were also initiated.

Permissions Reference

Governance

The AI Administrator and AI Reader descriptions were updated from “Microsoft 365 Copilot” to “Microsoft Copilot.” Their role IDs remain unchanged.

Agent Owners Sponsors Managers

Governance

Sponsors can disable agent identities, modify sponsors, and soft-delete resources, but cannot enable or restore agent blueprints or identities.

Manage Agent Identities End User

General

The documentation now states that sponsors cannot re-enable disabled agents; an owner or administrator must help re-enable them.

Agent Access Packages

General

The documentation now provides step-by-step My Access portal instructions for authorized users to request an access package for another user, including the US Government portal URL.

Agent Token Claims

General

The documentation now shows different sample GUID values for the aud, appid, oid, sub, and tid claims.

Agent Token Claims

Authentication

The Agent ID token claims documentation no longer includes one `tid` claim table row.

Agent Tokens

Developer

The user delegation section now spells out “on-behalf-of (OBO)” on first use. No feature behavior or requirements changed in the supplied diff.

Authentication protocols in agents

Authentication

The page description was shortened by removing the phrase “Key concepts.” The documented OAuth 2.0 protocols and token exchange patterns remain unchanged.

Best Practices Agent Id

Microsoft identity platform

The best-practices documentation now uses the full “Microsoft Entra Agent ID” and “Microsoft Entra ID” names in two recommendations. The guidance itself is unchanged.

Best Practices Agent Id

Security

The documentation now recommends creating agent identities from an agent identity blueprint instead of using standard app registrations or service principals. It also adds .NET usage guidance and lists required roles and permission.

Call Api Azure Services

Security

The documentation updates its C# examples, separating app-only, on-behalf-of-user, and user-identification scenarios. Samples now configure agent identity options and pass the credential to the Blob client correctly.

Call Api Azure Services

Developer

The code sample now uses `<your-tenant-id>` instead of `<your-tenant>` for the `TenantId` value.

Call Api Custom

Developer

The documentation updates its C# examples, including distinct method names for UPN and object ID calls, a revised controller constructor signature, and clearer user-data method names.

Call Api Custom

Developer

The documentation now spells out “on-behalf-of (OBO)” on first use in the token scenario guidance. The referenced method is unchanged.

Call Api Microsoft Graph

Developer

The Agent ID Microsoft Graph documentation now labels sample variables as `usersAppOnly` and `usersOnBehalfOfUser`, clarifying the scenarios they represent.

Call Api Microsoft Graph

Developer

The documentation adds Microsoft Graph and Microsoft.Identity.Web imports, changes sample calls from Applications to Users, and clarifies that configured scopes must match the Graph resources used. Examples use User.Read and User.ReadBasic.All.

Call Api Microsoft Graph

Developer

The documentation adds an OpenID Connect using directive and renames two C# sample variables: `applications` to `applicationsForUser` and `me` to `meByOid`.

Call Api Microsoft Graph

Developer

The `TenantId` example value changed from `<my-test-tenant>` to `<your-tenant-id>` for clearer documentation.

Configure Third Party Agents

Developer

The third-party agents documentation now labels the sidecar setup link “Configure Microsoft Entra ID Auth SDK for agent identities” instead of “Configure Entra ID Auth SDK.”

Create Delete Agent Identities

Developer

The documentation updates the C# sample’s imports, endpoint structure, downstream API call, and model declarations to provide valid create-agent-identity code.

Create Delete Agent Identities

General

The documentation now uses `<your-tenant-id>` instead of `<my-test-tenant>` in the token endpoint and `TenantId` code examples.

Error Codes

Authentication

The error-code documentation now separates quota, blueprint, blueprint principal, agent identity, and agent identity creation errors, with clearer descriptions and table headings.

Get the service principal for Microsoft Graph

Authentication

The documentation replaces inconsistent tenant placeholders with `<your-tenant-id>` and standardizes `<agent-blueprint-clientid>` to `<agent-blueprint-client-id>` in code samples.

Howto Delete Agent Identity

General

The delete-agent-identity article no longer contains a TODO asking engineering to confirm whether cascade cleanup removes associated agent user accounts.

Inheritable Permissions

Fundamentals

The page no longer includes a TODO questioning support for enumerated scopes versus `allAllowed`/`none`. The diff provides no evidence of a product or feature change.

Integrate Aws Bedrock Agent

Security

The guide updates “Entra” to “Microsoft Entra” in the diagram alt text, setup heading, and TENANT_ID descriptions. No technical procedure or feature change is shown.

Integrate Aws Bedrock Agent

General

The documentation now spells out “on-behalf-of” before introducing the OBO acronym in the OAuth 2.0 authentication description.

Integrate N8n Agent

Microsoft identity platform

The n8n integration page now consistently calls the pattern “Microsoft Entra ID Auth SDK (sidecar)” instead of “Microsoft Entra Auth SDK.”

Key Concepts

Fundamentals

The key concepts page now labels the link “Microsoft Entra Agent ID OAuth protocols” instead of “oauth protocols.”

Manage agents in end user experience

General

The page’s `ms.topic` metadata was changed from `how-to #Required; leave this attribute/value as-is` to `how-to`. The topic classification remains unchanged.

Microsoft Entra Sdk For Agent Identities

Developer

The documentation now identifies app-only tokens as using client credentials, expands on-behalf-of to OBO, and consistently uses the `agent-identity-client-id` placeholder in request examples.

Microsoft Entra Sdk For Agent Identities

Developer

The documentation replaces “Entra ID Auth SDK” with “Microsoft Entra ID Auth SDK” in two descriptions. The endpoint formats and behavior are unchanged.

Plan Agent Identity Architecture

Architecture

The documentation now explains that agents should use an agent identity blueprint and the `#Microsoft.Graph.AgentIdentity` object, rather than standard app-registration APIs. It also lists supported creation channels, roles, permissions, and .NET usage.

Plan Agent Identity Architecture

Architecture

The agent identity architecture planning page now links to the correct interactive agent authentication article instead of the previous broken path.

Secure an Amazon Bedrock agent with Microsoft Entra Agent ID

Developer

The Amazon Bedrock integration guide now consistently uses “Microsoft Entra ID Auth SDK (sidecar)” in its description, explanations, container reference, and links. No behavior or availability change is described.

Security For Ai Overview

Fundamentals

The documentation now expands MCP, A2A, and OBO on first use to improve clarity and retrievability.

Validate agent identity tokens in a downstream API

Authentication

The documentation now refers to the “Microsoft Entra ID Auth SDK (sidecar)” instead of the “Microsoft Entra SDK auth sidecar.” The token-validation guidance is otherwise unchanged.

What Is Agent Id Platform

Microsoft identity platform

The page’s bullet describing platforms and services that create agents retains the same wording and examples, including Copilot Studio, AWS Bedrock, and n8n. No substantive content change is shown.

What Is Microsoft Entra Agent Id

Authentication

The page updates image accessibility text, refines wording about agent identities, and standardizes the name “Microsoft Entra ID Auth SDK (sidecar)” for third-party agent integrations.

Whats New Agent Id

Provisioning

The Agent ID documentation now refers to the linked SDK as the “Microsoft Entra ID Auth SDK” instead of “Entra ID Auth SDK.”

Grant Agent Access Microsoft 365

Developer

The documentation now lists how an agent with its own identity can communicate through Outlook email, OneDrive and SharePoint comments, Teams chats, and Teams channels, including the permissions required for inbound and outbound communication.

Agent On Behalf Of Oauth Flow

Standards

The documentation now explicitly states that child agent identities, like their parent blueprints, cannot initiate interactive `/authorize` flows. Interactive consent attempts return `AADSTS82014`; required delegated permissions must be preauthorized instead.

Agent On Behalf Of Oauth Flow

Standards

The documentation now explains that Tc must target the agent identity blueprint, while T1 targets the token-exchange resource and is validated as bound to the blueprint and child agent identity. It also states that agent identities cannot use interactive consent and must have delegated permissions preauthorized through inheritable blueprint permissions.

Howto Target Agent Identities

General

The documentation now lists two license options: Microsoft 365 E7, or Microsoft Agent 365 paired with Microsoft Entra P1 or Microsoft 365 E3.

Howto Target Agent Identities

General

The documentation replaces the Microsoft Entra ID P1/P2 license requirement and the note that an Agent 365 license would soon be required with a direct Agent 365 license requirement.

Licensing Agent Id

Fundamentals

The documentation replaces standalone Entra licensing options for agents with guidance that Microsoft Agent 365 is required. It states that Agent 365 is included with Microsoft 365 E7 and available as an add-on to Microsoft E5, A5, Business Premium, or Defender Suite plus Purview Suite.

Agent Owners Sponsors Managers

General

In Microsoft Agent ID, the agent's identity, blueprint, and blueprint principal may all have sponsors associated with them. In addition, agents can have an [agent's user account](agent-users.md) created in order to access user-oriented services. While the Entra user has a sponsor relationship, there are differences between the user account sponsors and sponsors of the agent identity, blueprint, or blueprint principal.

Licensing Identity Protection

Security

Starting soon, ID Protection for agents will require a [Microsoft Agent 365 license](https://www.microsoft.com/microsoft-agent-365#plans-and-pricing) to extend protection to agents through [Microsoft Entra Agent ID](../agent-id/what-is-microsoft-entra-agent-id.md#how-to-get-started).

Agent Id

Conditional Access

In this flow, the agent can't reuse the user's original token because it was issued for a different audience. Instead, the agent uses the OBO flow to exchange tokens with Microsoft Entra ID, obtaining a new token scoped to the target resource. This token exchange is also evaluated by Conditional Access, letting admins enforce granular controls over which resources agents can access on behalf of the user.

Agent Id Design Patterns

Architecture

Learn how to map your AI agent architecture to Microsoft Entra Agent ID, including blueprints, agent identities, and an agent's user account.

AI-guided setup for Microsoft Entra Agent ID

Provisioning

Describes how to use an AI coding agent to automate the onboarding process for Microsoft Entra Agent ID, including blueprint creation, credential configuration, and agent identity provisioning.

Best Practices Agent Id

Monitoring

Learn operational best practices for designing, securing, and governing AI agent identities with Microsoft Entra Agent ID, including blueprint design, credential management, access controls, and monitoring strategies.

Licensing Identity Protection

Security

Starting soon, ID Protection for agents will require a [Microsoft Agent 365 license](https://www.microsoft.com/microsoft-agent-365#plans-and-pricing) to extend protection to agents through [Microsoft Entra Agent ID](../agent-id/what-is-microsoft-entra-agent-id.md#how-to-get-started).

Manage agent identities in your organization

Conditional Access

Learn how to manage agent identities across your organization. View, disable, govern, and monitor agents using the Microsoft Entra admin center and Conditional Access.

Manage agents in end user experience

General

Learn how to manage agent identities in the end user experience within Microsoft Entra. View, control, and take action on agents you own or sponsor with ease.

Microsoft Entra Agent ID logs

Authentication

Learn how audit and sign-in activities associated with agent identities are logged in Microsoft Entra ID.

Migrate Copilot Studio Agents To Agent Id

Governance

Learn how to recreate Microsoft Copilot Studio agents with Microsoft Entra Agent ID for enhanced governance and security. No in-place migration path exists today.

Plan Agent Identity Architecture

Architecture

Use this decision guide to choose the right identity type, operation pattern, and blueprint and agent identity structure for your AI agents in Microsoft Entra Agent ID.

Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…