Skip to content

Smart Agents

The Smart Agents list shows every AI agent defined in your Business Central company.

Page type: List Source table: Smart Agent Object: Page 72778300 "Smart Agents QUA"Page.72778300.SmartAgents.al

The Smart Agents list shows every AI agent defined in your Business Central company. You can create, activate, chat with, and delete agents from here. Rows are color-coded by status — green for active, amber for draft, red for disabled — so you can see at a glance which agents are ready to use.

In plain terms

This is the home base for your agents — the equivalent of the Customer or Item list, but each row is an AI assistant. An agent is a configured assistant your users chat with to get work done in BC; you create them here and open each one's Agent Card to configure it.

The lifecycle is like a document's: a new agent starts in Draft (amber), you Activate it to make it usable (green), and you can Deactivate it to Disabled (red). Only Active agents can be chatted with. The Capabilities and Published columns are at-a-glance summaries of what each agent can do and where users can reach it, and Total Credits Used shows lifetime credit spend per agent.

Tip for first-timers: use Create Templates to generate ready-made agents for common areas (Sales, Finance, Inventory, …). It's the fastest way to see a working agent before you build one from scratch.

How to open it

  • Role CenterSmart Agents group → Smart Agents.
  • Tell Me (Alt+Q) → search "Smart Agents".

Fields

Agent list (repeater)

FieldTypeDescription
ImageMediaAgent image or icon.
IconTextA short visual identifier for this agent (3-4 letters).
NameTextThe display name of this agent.
DescriptionTextA short description of what this agent does.
AI ModelTextThe AI model currently assigned to this agent.
StatusEnumThe current state of this agent. Values: Draft, Active, Disabled.
CapabilitiesTextActive capabilities: Web Search, BC Data Access, Image Analysis, Knowledge Base. Read-only computed summary.
Total Credits UsedDecimalTotal credits consumed by this agent. Read-only.
Last Used AtDateTimeWhen this agent was last used. Read-only.
PublishedTextThe platforms where this agent is currently available. Read-only computed summary.

Actions

ActionWhat it does
New AgentCreate a new AI agent.
EditOpen the agent card to review or change its configuration.
ChatOpen a chat session with this agent. Available only when the agent is Active and its Output Type is Chat.
ActivateProvision and activate the selected agent. Validates instructions, syncs with the backend, and sets status to Active. Requires the tenant to be registered in Smart Agents Setup.
DeactivateSet the selected agent to Disabled so it can no longer be used for chat. Prompts for confirmation.
Delete AgentPermanently delete the selected agent and all its data. This cannot be undone.
Delete SelectedPermanently delete every agent currently selected (and all of their data). This cannot be undone.
Create TemplatesCreate pre-configured agent templates for common Business Central scenarios (Sales, Purchasing, Finance, Inventory, CRM, HR, etc.).
Incoming SharesView and accept or reject agent share invitations from other tenants.
CreditsView your credit balance and purchase history.
SetupOpen Smart Agents configuration.

Notes

  • The Chat action is disabled when the agent is not Active or when its Output Type is JSON. JSON-output agents are not available for interactive chat.
  • Activate checks that the tenant is registered before trying to reach the backend. If registration is missing, you are directed to Smart Agents Setup.
  • When an agent's instructions conflict with system rules, Activate offers to apply a suggested fix before continuing.
  • After successful activation the agent is automatically registered as published in the Business Central channel.
  • Delete Agent and Delete Selected permanently remove all related data (sessions, messages, knowledge files, data sources). There is no undo.