{"title":"Create and activate an agent (preview)","url":"https://jonas-paprotka.de/docs/dev-itpro/ai/ai-development-toolkit-agent-create/","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-agent-create, 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-agent-create","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":"Learn how to create and activate an agent in Business Central to automate tasks, integrate AI, and enhance your workflows.","date":"2026-10-02","meta":{"topic":"concept-article"},"outline":[{"level":1,"title":"Create and activate an agent (preview)","slug":"create-and-activate-an-agent-preview","at":0,"chars":8505},{"level":2,"title":"Prerequisites","slug":"prerequisites","at":1184,"chars":785},{"level":2,"title":"Get started","slug":"get-started","at":1969,"chars":769},{"level":2,"title":"Turn on the design capability","slug":"turn-on-the-design-capability","at":2738,"chars":4683},{"level":3,"title":"Configure an agent","slug":"configure-an-agent","at":3205,"chars":2909},{"level":3,"title":"Accessing agent settings after creation","slug":"accessing-agent-settings-after-creation","at":6114,"chars":559},{"level":3,"title":"Understanding agent states","slug":"understanding-agent-states","at":6673,"chars":284},{"level":3,"title":"Recognizing agent icons","slug":"recognizing-agent-icons","at":6957,"chars":464},{"level":2,"title":"Related information","slug":"related-information","at":7421,"chars":1084}],"text":"# Create and activate an agent (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.\nWith the AI development toolkit, you can create an agent to test various AI functionalities, such as automating tasks and integrating AI into your workflows. An agent can be given specific instructions and tasks to see how it performs in different scenarios. The agent is considered as a user in Business Central, so it can be assigned permission sets to control what data and actions it can access.\nSee AI development toolkit overview (preview)<ai-development-toolkit-overview>.\n## Prerequisites\nBefore you can create an agent, ensure that you have the following prerequisites in place:\n Enable the Custom Agent capability in Business Central. See Configure Copilot and agent capabilities</enable-ai>.\n Appropriate permissions to design an agent in Business Central.\n   \"AGENT - ADMIN\" gives you permission to design agents.\n   \"AGENT - DIAGNOSTICS\" gives you access to see the execution cost and the serialized page in the agent task log entries.\n A sandbox environment for testing and experimentation from version 27.2 (can include customer data such as sandbox copies of production data)\n Billing setup for agent capabilities in your tenant. See Manage consumption billing for agents (preview)<../administration/tenant-admin-center-manage-consumption-billing>.\n## Get started\nCreating an agent involves several key phases: design, configuration, and testing. You start by defining your agent's identity and purpose, then specify its behavior through natural language instructions. The agent needs appropriate permissions and user profiles to interact with your Business Central environment safely and effectively.\nThe development process is iterative by design. You can continuously refine your agent's instructions, adjust what it has access to via its profile and permissions, and test different scenarios until it performs as expected. The agent design experience provides tools to monitor the agent's reasoning and actions, making it easy to identify areas for improvement and validate that the agent meets your requirements.\n## Turn on the design capability\nThe design capability is on if the ![Create new agent] Agent icon appears in the top navigation menu of the role center.\nIf the icon isn't present, turn it on from the Copilot & agent capabilities page, like other Copilot features in Business Central. The design capability is listed under Production ready previews. See Configure Copilot and AI agent capabilities</enable-ai>.\nNext, configure, and activate the agent to get started.\n### Configure an agent\nThe Create agent wizard allows you to configure your agent by setting up its instructions, profile, and permissions. The wizard is also where you enable the agent for use, once it's set up.\n1. In the navigation bar at the upper right of the role center, select ![Create new agent] Agent > Create.\n1. In the Create agent wizard, choose whether to create a blank agent or use a template.\n  To create a blank agent, choose Create agent from scratch, and then choose Next.\n  To use a template, choose Sales Validation, choose Next, and then choose Create agent. The template provides a starting point with predefined instructions and tasks focused on sales order validation. The next steps describe how to customize the agent further. See Create a Sales Validation Agent (preview)<ai-development-toolkit-sales-validation>.\n1. On the Create agent (preview) wizard, enter a Name and Display Name and Initials field values are now suggested based on the Name, but can be modified.\n![Agent designer setup]\n1. In the Description field, provide an optional description for the agent.\n1. Choose the arrow to go to the next page of the wizard.\n1. Under Profile (role), use the Setup profile option to select the profile that determines what UI elements the agent can see and interact with.\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 Set up agent permissions and profiles (preview)<ai-development-toolkit-permissions-profiles>.\n1. Under Permissions, use Manage permissions to add the permissions that the agent should have.\nThis allows you to define what data and actions it can access. This is important for ensuring that the agent operates within the boundaries of your organization's data security policies. See Set up agent permissions and profiles (preview)<ai-development-toolkit-permissions-profiles>\n1. Under Instructions for the agent, use the Edit instructions option to provide a clear and concise description of what you want the agent to do. This serves as the prompt that guides the agent's behavior. See Write effective instructions for an agent (preview)<ai-development-toolkit-instructions>.\n1. Under Optimize agent instructions, use the Go to task playground option to go to the Agent task playground page, where you can refine the agent's instructions and create a task to run the agent. See Iterate and manage an agent (preview)<ai-development-toolkit-iterate>. If you want to skip this step for now, you can return to it later after activating the agent. If you choose to go to the task playground, you must complete the setup of the agent first.\n1. Turn on the Active toggle.\n1. Select Update to complete the setup.\nThe agent icon changes to ![Agent design icon] after configured, indicating the agent is active and ready to handle tasks.\n### Accessing agent settings after creation\nYou can access and modify the settings of an existing agent either from the icon ![Agent design icon] or by navigating to the Agents (preview) page and selecting the agent you want to configure.\nIn the Agents (preview) page, choose the agent, and either open the Agent Card , or use the Setup while standing on the agent to modify and the Create agent (preview) wizard opens.\nIn the Copilot chat pane for the specific agent, choose the ![Agent design settings icon] icon to open a Configure agent (preview) wizard.\n### Understanding agent states\nAn agent is by default in the Disabled state. You must activate the agent to use it, but you can only activate it after you have defined its purpose and tasks. Working on the setup, you can switch the agent between Disabled and Active states as needed.\n### Recognizing agent icons\nEach agent in Business Central displays an icon that indicates its origin. The following table describes the three types of agent icons.\nIcon|Description\n![First-party agent icon.]|An agent built and published by Microsoft.\n![Third-party agent icon.]|An agent built and published through an extension, for example, on Marketplace.\n![Custom agent icon.]|An agent created using the Business Central agent design and builder capabilities.\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>\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>\nSet up permissions and profiles (preview)<ai-development-toolkit-permissions-profiles>\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>"}