Back to Blog
Published:
Last Updated:
Fresh Content
Copilot BoundaryChapter 28

What can Agent Designer build in Business Central, and what still needs a developer?

6 min read
1,234 words
high priority
Ali Ahmed

Ali Ahmed

AI Solutions Engineer, Cognilium AI

TL;DR

Agent Designer prototypes custom agents without a developer, up to a point. What it covers, and where an AL developer is still required.

A consultant builds a working agent in the wizard with no AL code at all. Two published boundaries decide whether it becomes a system: the development toolkit is sandbox-only while the AL SDK reaches production from version 28.1, and nothing triggers a custom agent without developer work.

What can you build without writing code?

An agent that Business Central treats as a user, configured through four decisions.

Microsoft describes the wizard steps directly. You give the agent a Name, Display Name and Initials; then a Profile (role) that "determines what UI elements the agent can see and interact with"; then Permissions, framed as "important for ensuring that the agent operates within the boundaries of your organization's data security policies"; then Instructions, which "serves as the prompt that guides the agent's behavior."

There is a starting template as well as a blank canvas. You choose "Create agent from scratch", or the Sales Validation template, which "provides a starting point with predefined instructions and tasks focused on sales order validation."

Agents start switched off, deliberately:

"An 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."

And Microsoft is explicit about who this is for — the release plan names "partner personas like consultants, product owners, and domain experts, as well as developers and even power users." The wizard is not a developer tool with a friendly face. It is aimed at the person who knows the process.

What does the permission model actually give you?

More precision than most people expect, because the agent is a user.

"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."

That single sentence is the governance story. An agent does not get a special sandbox of its own — it gets permission sets, the same mechanism you already audit.

The profile control goes finer than permission sets do. You build profiles specifically for agents "using page customization properties to control visibility of actions, layouts, views, and operations like insert/delete."

Read the last two words. You can hand an agent a profile that can see a page and cannot delete on it. For anything that reads a record and proposes a correction, that is exactly the shape you want — and it is configuration rather than code.

Two permission sets gate the building itself: AGENT - ADMIN "gives you permission to design agents", and AGENT - DIAGNOSTICS "gives you access to see the execution cost and the serialized page in the agent task log entries."

Diagnostics is the one people skip and then need. Without it you cannot see what the agent actually did, step by step, when it does something surprising.

Where can a custom agent actually run?

This is the boundary that decides whether you are prototyping or deploying, and Microsoft draws it precisely:

"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."

Two different things with two different answers. The wizard — the design experience a consultant uses — is a sandbox tool. The AL SDK is the production path, and it opened at 28.1.

So an agent designed in the wizard is a prototype by definition. That is not a criticism; Microsoft calls the experience "a low-risk environment for envisioning and prototyping." It is a statement about what you can promise.

⚠️ The status wording matters and it is not "preview". The page carries "[This article is prerelease documentation and is subject to change.]" and "This is a preview feature"while the design capability itself is listed in Business Central under Production ready previews. Those are different labels with different commitments, and the release plan gives general availability as October 2026.

What still needs a developer?

Getting it to run when something happens.

"there aren't yet any built-in integrations to automatically trigger these custom agents based on incoming emails, events, or scheduled recurrences (this can be done by professional developers using the APIs available in the AI Development Toolkit)."

The built-in agents do not have this problem. Payables and Sales Order watch a mailbox through an internal dispatcher. A custom agent waits to be handed a task.

Microsoft offers a way to test around it in the meantime — you can "simulate these scenarios by including the email header and body in the task message to mimic incoming emails, or by manually triggering the agent." Simulating a trigger is a test, not a deployment.

This is the gap between a capability and a system, and it is the single most important thing to establish before promising a custom agent to anyone. It is documented, not discoveredthe same boundary appears across all the built-in agents.

Is it worth prototyping now?

Yes, and the reason is that the expensive question is answerable cheaply.

The expensive question in any agent project is not "can it be built" — it is "will the reasoning hold on our actual process." That is exactly what the wizard answers, in a sandbox, with real data copies, in an afternoon. Finding out that an agent cannot reliably follow your rules is worth far more before the AL work than after it.

Four things to establish while prototyping:

  1. Does the instruction set hold? Write the rules in natural language and see where the agent improvises.
  2. What profile does it actually need? Start with the narrowest and widen only where it fails.
  3. Where does it stop and ask? Every halt is a person's time, and that is the real running cost.
  4. What would trigger it in production? Answer this before the prototype succeeds, not after.

And a note on timing. General availability is October 2026. If you are writing a statement of work now, use Microsoft's labels rather than rounder ones, and re-read the environment boundary before you commit to where the thing will run.

About Cognilium Cognilium builds AI optimization apps for Microsoft Dynamics 365 — companion apps that optimize the pricing, inventory, warehouse and planning decisions your ERP manages but can't optimize. Dynamics is your system of record. Cognilium is your system of intelligence. https://cognilium.ai · https://www.linkedin.com/company/37180269/

Agentic ERP. We build turnkey AI optimization apps for Dynamics 365 — sidecar applications that run in your own Azure tenancy and solve the calculations a standard ERP is not built to compute. Built on Azure OpenAI, Microsoft Fabric and Copilot Studio. We build these on request, against your data and your environment.

More on the boundary between what Copilot does and what you build: Agentic ERP on Dynamics 365.

If the prototype holds and the trigger is the missing half, that is the part we build. Bring the process and the event that should start it to a 15-minute call.

Sources

Sources and fact-check
#§ClaimTierPrimary sourceVerdict
11Wizard fields: Name, Display Name, Initials, Profile, Permissions, Instructions, with each definition quotedT1 — verbatim ×3ai-development-toolkit-agent-create, re-fetched 2026-09-15PASS
21Sales Validation template and "Create agent from scratch"T1 — verbatim, names character-exactSame pagePASS
31"An agent is by default in the Disabled state…"T1 — verbatimSame pagePASS
41"partner personas like consultants, product owners, and domain experts…"T1 — verbatimRelease planPASS
52"The agent is considered as a user in Business Central, so it can be assigned permission sets…"T1 — verbatimAgent-create pagePASS — the governance spine
62Profiles use "page customization properties to control visibility of actions, layouts, views, and operations like insert/delete"T1 — verbatimSame pagePASS
72AGENT - ADMIN and AGENT - DIAGNOSTICS with their stated effectsT1 — verbatim ×2, names copied character-exact including spacingSame page, PrerequisitesPASS
82"Diagnostics is the one people skip and then need"T2 — ours, an opinion, labelledPASS
93"The AI development toolkit is available in sandbox environments only. The Agent SDK for AL… starting from version 28.1, also in production environments."T1 — verbatim, re-verified on a fresh fetch 2026-09-15Same page, ImportantPASS — load-bearing
103"a low-risk environment for envisioning and prototyping"T1 — verbatimRelease planPASS
113Three status labels: prerelease documentation · preview feature · Production ready previews · GA October 2026T1 — verbatim ×3 plus the release-plan tableBoth pagesPASS — not collapsed into one word
124"there aren't yet any built-in integrations to automatically trigger these custom agents…"T1 — verbatimRelease planPASS
134Microsoft's own simulation workaroundT1 — verbatimRelease planPASS
144Built-in agents have a dispatcher; custom ones do notT1 — presence documented on payables-agent, absence quoted from the release planTwo pagesPASS — presence and absence sourced separately
155The prototyping argument and the four checksT2 — ours, method, no measured result and no customerPASS

Tier summary: 13 × T1 (all verbatim), 2 × T2 — 0 × T4.

🔴 No pricing, per the founder ruling of 2026-09-15. AGENT - DIAGNOSTICS is described as giving visibility of "the execution cost" because that is Microsoft's own field wording — no rate, no currency and no total appears anywhere.

### ⚠️ Status: three labels, deliberately not collapsed This page says "This is a preview feature" and "[This article is prerelease documentation and is subject to change.]", while the design capability is listed under "Production ready previews" in the product, and the release plan gives GA October 2026. Those are not synonyms. This repo has previously applied [PP] where Microsoft said production-ready preview and corrected it three times; all three labels are reproduced here rather than reduced to one.

⏰ Perishable — re-check before publication. General availability is October 2026, and a GA release is exactly what closes a trigger limitation. Claim 12 is the sentence most likely to change. The page was re-fetched on 2026-09-15 for this article rather than relying on an earlier read.

No figures of ours. The only numbers are a version string, a month and Microsoft's own labels.

Share this article

The work behind this series

What Microsoft ships, what it does not, and the layer we build where a general assistant runs out.

Ali Ahmed

Ali Ahmed

AI Solutions Engineer, Cognilium AI

Ali Ahmed is an AI Solutions Engineer at Cognilium AI.

Applied AI AgentsAgentic SystemsRetrieval-Augmented Generation (RAG)LLM Product Engineering
Next in this series
How does a Business Central agent interact with pages instead of an API?
Chapter 29 · 6 min
In short

Key takeaways

  • A consultant builds a working agent with no AL code — name, profile, permissions and natural-language instructions are the whole wizard.
  • The agent is a Business Central user. It gets permission sets, not a private sandbox, and that is the governance answer.
  • Agent profiles control visibility down to operations like insert and delete, which is the right shape for anything that reads and proposes.
  • The development toolkit is sandbox-only; the AL SDK is the production path and reaches production environments from version 28.1. An agent designed in the wizard is a prototype by definition.
  • Nothing triggers a custom agent. Simulating a trigger is a test, not a deployment, and wiring a real one is developer work.
  • The design capability is listed under production-ready previews with general availability planned for October 2026 — three different status words that are not interchangeable.
What goes wrong

Common mistakes to avoid

  • Demonstrating in a sandbox and calling it production. Microsoft draws that line on the page.
  • Promising a scheduled or email-triggered custom agent without budgeting developer time.
  • Skipping the diagnostics permission. Without it you cannot see what the agent did when it surprises you.
  • Giving an agent a broad profile because it is quicker. Start narrow; it is a profile, not a code change.
  • Writing "GA" or "preview" loosely in a statement of work. Microsoft's own labels differ and carry different commitments.

Terms in this article

Definitions in the Cognilium glossary.

Frequently Asked Questions

Find answers to common questions about the topics covered in this article.

Still have questions?

Get in touch with our team for personalized assistance.

Contact Us

Still have a question this did not answer?

The person who wrote this article answers these. Describe your setup and what you are stuck on — you will get a straight answer, including where we think the approach is wrong.