Overview

Everything in this stage is UI only — no AL needed. By the end you’ll have a working agent that’s run its first task.

ℹ Before You Start
Your environment has already been set up with the Custom Agent capability enabled and the AGENT - ADMIN permission set assigned to your user. If the agent icon is missing from the navigation bar, let your facilitator know.

Part 1 — Create the Agent

1

Open the agent designer

In the top-right navigation bar of your Role Centre, look for the + (plus) icon. Select it, then choose Agent > Create.

The plus icon used to create a new agent

2

Choose a starting point

In the Create agent wizard, select Create agent from scratch, then choose Next.

3

Give your agent an identity

Fill in the following fields:

  • Name — a short internal name, e.g. WorkshopAgent01
  • Display Name — what users will see, e.g. My First Agent
  • Initials — suggested automatically, but feel free to change it
  • Description — optional; briefly describe what the agent does

Select the arrow to continue to the next page.

4

Set the agent's profile

Under Profile (role), select Setup profile and choose Business Manager. This determines which UI pages and actions the agent can see and interact with.

5

Set permissions

Under Permissions, select Manage permissions and add the SUPER permission set. This gives the agent access to everything in the environment for the purposes of this workshop.

⚠ Workshop Only
Fine for a sandbox. In production, assign only what the agent actually needs.
6

Write the agent's instructions

Under Instructions for the agent, select Edit instructions and enter the following:

You are a helpful Business Central assistant.
When given a task, look up the requested information
and provide a clear, concise summary to the user.

Keep them short and specific — you'll refine them in later stages.

7

Activate and save

Turn on the Active toggle, then select Update to complete the setup.

The agent icon in the navigation bar should change to reflect this.

✓ You're here when…
The agent icon in the top navigation changes and your agent appears in the Agents (preview) page with a status of Active.

Part 2 — Trigger Your First Task

8

Run a task

Select the Run task action. In the dialog, enter a simple task for the agent — for example:

List the top 5 customers by name.

Confirm and hit Start — watch the agent pick it up.

9

Watch it run

The task pane on the right updates in real time. Watch it work through the steps and check you see a result.

✓ Stage complete when…
Your agent has processed a task and you can see its output in the task log.

Stuck?

  • If you see “Something went wrong” in the task pane, do a force refresh (Ctrl + Shift + R on Windows, Cmd + Shift + R on Mac) and try running the task again