{"title":"Set up agent permissions and profiles (preview)","url":"https://jonas-paprotka.de/docs/dev-itpro/ai/ai-development-toolkit-permissions-profiles/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/ai/ai-development-toolkit-permissions-profiles, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/ai/ai-development-toolkit-permissions-profiles","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Discover how to configure agent permissions and profiles to control access and customize the user interface for sandbox environments.","date":"2026-10-02","meta":{"topic":"concept-article"},"outline":[{"level":1,"title":"Set up agent permissions and profiles (preview)","slug":"set-up-agent-permissions-and-profiles-preview","at":0,"chars":6504},{"level":2,"title":"Permissions","slug":"permissions","at":1191,"chars":1797},{"level":3,"title":"How to determine required permissions","slug":"how-to-determine-required-permissions","at":1428,"chars":555},{"level":3,"title":"Effective permissions","slug":"effective-permissions","at":1983,"chars":1005},{"level":4,"title":"Example","slug":"example","at":2475,"chars":513},{"level":2,"title":"Profiles","slug":"profiles","at":2988,"chars":2452},{"level":3,"title":"The agent and the UI","slug":"the-agent-and-the-ui","at":3477,"chars":1963},{"level":4,"title":"Example of a page customization for an agent profile","slug":"example-of-a-page-customization-for-an-agent-profile","at":4566,"chars":874},{"level":2,"title":"Related information","slug":"related-information","at":5440,"chars":1064}],"text":"# Set up agent permissions and profiles (preview)\n[This article is prerelease documentation and is subject to change.]\n> IMPORTANT\n > This is a preview feature. Preview features might have restricted functionality and are subject to supplemental terms of use<https://www.microsoft.com/en-us/business-applications/legal/supp-powerplatform-preview/>.\n > The AI development toolkit is available in sandbox environments only. The Agent SDK for AL is available in sandbox environments and, starting from version 28.1, also in production environments.\n > This article is primarily intended for product owners, domain experts, consultants, and developers who want to experiment with AI capabilities in Business Central.\nThe Business Central AI development toolkit is an environment that allows subject matter experts, product owners, consultants, and developers to experiment with AI capabilities in Business Central by building agents. It's available in sandbox environments and designed for testing and learning purposes, providing a safe environment to explore AI functionalities without affecting production data. See AI development toolkit overview (preview)<ai-development-toolkit-overview>.\n## Permissions\nThe agent operates with explicit permission sets that control what data and actions it can access. This follows the principle of least privilege-grant only the permissions necessary for the agent's intended functionality.\n### How to determine required permissions\nYou can refer to the documentation about how to\ncreate or modify permissions for a specific workflow via recording permissions</ui-define-granular-permissions#create-or-modify-permissions-by-recording-your-actions>.\nAlternatively, you can assign existing permission sets to the agent, treating it like a user performing the intended tasks. In this approach, applying the principle of least privilege becomes especially critical to minimize the risk of the agent accessing functionality beyond its intended scope.\n### Effective permissions\nWhen a user schedules a task for an agent, the task is executed with permissions from the intersection of the user's permissions and the agent's permissions. This design ensures agents never exceed the privileges of the user who scheduled the task.\n> NOTE\n> If the agent makes a user intervention request, the task continues proceeding with the permissions of the user that responded to that intervention request. This user might be different from the task creator.\n#### Example\nPermission|User|Agent|Effective Permissions\nRead Customers|Yes|Yes|Yes\nModify Customers|Yes|Yes|Yes\nDelete Customers|Yes|No|No\nPost Sales Orders|Yes|No|No\nRead Items|No|Yes|No\nThis means that in this example:\n The agent can read and modify customers (both user and agent have these permissions)\n The agent can't delete customers or post sales orders (agent lacks these permissions, even though the user has them)\n The agent can't read items (user lacks this permission, even though the agent has it)\n## Profiles\nThe agent is assigned to a profile (role) that determines which UI elements it can see and interact with. The profile also defines the role center, which is the agent's starting point when it executes a task.\nYou can create custom profiles specifically for agents, using page customization properties to control visibility of actions, layouts, views, and operations like insert/delete. See ../developer/devenv-design-profiles and ../developer/devenv-page-customization-object.\n### The agent and the UI\nAn agent can interact with the UI it sees. It can access search on any list page, but not Tell me. The agent is assigned to a profile just like any other user and this is the key to controlling its access. For the Profile (Role), to ensure that you don't expose too much of the UI, it's recommended to build a custom profile for the agent in the same way as you would build a custom profile for a user. The intent is to define an inclusion list or positive list of UI elements exposed to the agent.\nOn the page customization object, you can set specific flags to control what the agent can see and do on that page. The following flags are available:\nProperty|Data type|If set to...\nClearActions|Boolean|true, all actions on the page are removed for the agent.\nClearLayout|Boolean|true, the layout of the page is simplified for the agent.\nClearViews|Boolean|true, all views on the page are removed for the agent.\nDeleteAllowed|Boolean|false, the delete action isn't allowed for the agent.\nInsertAllowed|Boolean|false, the insert action isn't allowed for the agent.\n#### Example of a page customization for an agent profile\nWith the following page customization, the agent assigned to this profile won't see any actions or views on the Customer Card page, will have a simplified layout, and won't be able to insert or delete customers.\n```al\npagecustomization 50100 CustomerAgentProfileCustomization\n{\n    PageType = Card;\n    PageID = Customer;\n    ClearActions = true; // No actions available\n    ClearLayout = true;  // Simplified layout\n    ClearViews = true;    // No views available\n    DeleteAllowed = false; // Delete not allowed\n    InsertAllowed = false; // Insert not allowed\n\n    layout\n    {\n       modify(Name) { Visible = true; }\n       // Other changes\n    }\n    ...\n}\n```\nOnce you have built and published a profile, you can assign it to the agent in the Profile field on the Agent Card or from the Configure agent wizard.\n## Related information\nOverview (preview)<https://learn.microsoft.com/dynamics365/business-central/dev-itpro/ai/ai-development-toolkit-landing-page>\nDesigning and coding agents (preview)<ai-development-toolkit-overview>\nCreate and activate (preview)<ai-development-toolkit-agent-create>\nWrite effective instructions (preview)<ai-development-toolkit-instructions>\nInstruction keywords (preview)<ai-development-toolkit-instruction-keywords>\nIntegrate with the Tasks AL API (preview)<ai-development-toolkit-tasks-api>\nAttachment capabilities and limitations (preview)<ai-development-toolkit-attachments>\nRun an agent (preview)<ai-development-toolkit-run-agent>\nIterate and manage (preview)<ai-development-toolkit-iterate>\nFrequently asked questions (preview)<ai-development-toolkit-faq>\nBest practices for designing an agent (preview)<ai-development-toolkit-best-practices>\nCreate a Sales Validation Agent (preview)<ai-development-toolkit-sales-validation>\nTransparency note: Business Central AI development toolkit (preview)<transparency-note-ai-development-toolkit>"}