---
id: post/bertverbeek-nl/1219
type: post
title: Agents in Business Central – part 1 – the architecture
summary: Agents in Business Central 27.4 allow you to create custom agents that process tasks asynchronously using an orchestrator architecture. The post explains how agents are triggered via task creation, how the orchestrator manages execution with separate sessions and transactions, and how to handle incoming and outgoing messages programmatically.
tier: community
language: en
tags:
  - agents
  - architecture
  - task processing
  - messaging
  - job queue
  - permissions
system: copilot
review:
  state: reviewed
  by: opus
  at: "2026-10-08T01:56:52.157Z"
  flags: []
generated:
  at: "2026-10-08T01:26:53.141Z"
  pipeline: 0.2.0
  prompts:
    extract-post: 1
  input_hash: 79b9cc1182b1e32efc1766e24a61efe73000cc61fef576f746d501c4781db322
evidence:
  - kind: blog
    url: https://www.bertverbeek.nl/blog/2026/02/10/agents-in-business-central-part-1-the-architecture/
    title: Agents in Business Central – part 1 – the architecture
    date: "2026-02-10"
    commit: null
    t: null
    quote: null
  - kind: blog
    url: https://www.bertverbeek.nl/blog/2026/02/10/agents-in-business-central-part-1-the-architecture/
    title: Agents in Business Central – part 1 – the architecture
    date: "2026-02-10"
    commit: null
    t: null
    quote: Since Business Central 27.4 minor update you can create your own agents inside Business Central.
  - kind: blog
    url: https://www.bertverbeek.nl/blog/2026/02/10/agents-in-business-central-part-1-the-architecture/
    title: Agents in Business Central – part 1 – the architecture
    date: "2026-02-10"
    commit: null
    t: null
    quote: Each task can be seen as a separate user session, thus uncommitted data may not be viewable and concurrent modifications can collide.
links:
  learn: []
  objects:
    - object/codeunit/4315
    - object/codeunit/4303
    - object/codeunit/4316
    - object/codeunit/4307
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
post_id: "1219"
source_id: bertverbeek-nl
source_name: Discover MS BC - Bert Verbeek
url: https://www.bertverbeek.nl/blog/2026/02/10/agents-in-business-central-part-1-the-architecture/
published_at: "2026-02-10T07:46:50.000Z"
author: Bert Verbeek
full_text: false
words: 571
quotes:
  - text: Since Business Central 27.4 minor update you can create your own agents inside Business Central.
    why_it_matters: Establishes when custom agents became available and marks the beginning of the feature capability
  - text: Each task can be seen as a separate user session, thus uncommitted data may not be viewable and concurrent modifications can collide.
    why_it_matters: Important architectural consideration for developers implementing agent tasks to avoid data consistency issues
code_objects_mentioned:
  - codeunit Agent Task Builder
  - codeunit Agent Task
  - codeunit Agent Task Message Builder
  - codeunit Agent Message
systems:
  - copilot
  - integration
  - development
versions_mentioned:
  - "27.4"
preview:
  embeddable: true
  frame_url: https://www.bertverbeek.nl/blog/2026/02/10/agents-in-business-central-part-1-the-architecture/embed/
  image: https://www.bertverbeek.nl/wp-content/uploads/2026/02/d365businesscentral_512x512.png
  image_alt: null
  image_w: null
  image_h: null
  site_name: Discover Microsoft Business Central - The wonderful world of Business Central
  favicon: https://www.bertverbeek.nl/wp-content/uploads/2026/02/d365businesscentral_256x256.png
  probed_at: "2026-10-07T11:50:41.344Z"
---

# Agents in Business Central – part 1 – the architecture

[Read the post](https://www.bertverbeek.nl/blog/2026/02/10/agents-in-business-central-part-1-the-architecture/) · Discover MS BC - Bert Verbeek (Bert Verbeek) · 2026-02-10 · 571 words · tier community · reviewed (checked by Opus)

> Agents in Business Central 27.4 allow you to create custom agents that process tasks asynchronously using an orchestrator architecture. The post explains how agents are triggered via task creation, how the orchestrator manages execution with separate sessions and transactions, and how to handle incoming and outgoing messages programmatically.

## Key points

- Custom agents (public preview since 27.4) need the Custom Agent capability enabled, the AGENT - ADMIN permission set, a 27.4+ sandbox and billing setup in the tenant
- Agents start working when a task is created with the Agent Task Builder codeunit; the Agent Task codeunit can restart, stop or check the status of tasks
- The orchestrator runs tasks asynchronously and in parallel, each in its own session and transaction with the agent as user
- Incoming emails can be handled by a Job Queue codeunit that uses the email conversation ID to add replies to an existing task via Agent Task Message Builder, including attachments
- Outgoing messages are found by output type and reviewed status, processed, and then marked as Sent with the Agent Message codeunit

## Quotes

- "Since Business Central 27.4 minor update you can create your own agents inside Business Central." (Establishes when custom agents became available and marks the beginning of the feature capability)
- "Each task can be seen as a separate user session, thus uncommitted data may not be viewable and concurrent modifications can collide." (Important architectural consideration for developers implementing agent tasks to avoid data consistency issues)

## AL objects mentioned

As named in the post. A name that matches one object page by exact type and name links to it; the others stay as named.

- [codeunit 4315 "Agent Task Builder"](../../objects/codeunit/4315.md)
- [codeunit 4303 "Agent Task"](../../objects/codeunit/4303.md)
- [codeunit 4316 "Agent Task Message Builder"](../../objects/codeunit/4316.md)
- [codeunit 4307 "Agent Message"](../../objects/codeunit/4307.md)

## Context

- Features: Custom agents, Agent task creation, Asynchronous execution, Message handling, Conversation tracking, Job Queue integration
- Versions: 27.4

Source: Discover MS BC - Bert Verbeek, community blog. Summary, key points and quotes are derived (CONTENT-NOTICE.md); read the original for the full text.