Extend Copilot in Business Central

Path: Integration with AI > Integrate AI using developer tools for Copilot > Extend Copilot in Business Central · tier official · system copilot · narrative reviewed (checked by Opus)

Overview

This section is for AL developers who add generative AI to Business Central extensions. It starts with an introduction to the building blocks: a prompt dialog page, the AI module of the system application, and an Azure OpenAI resource.

The page “Build the Copilot capability in AL” covers the code side: registering the capability, storing authorization, configuring parameters, defining a metaprompt and generating responses. Two subtopics cover the rest. “Build Copilot user experience” explains the PromptDialog page type and its prompt, generate and content modes. “Test Copilot capability in AL” covers the Evaluation framework and how to write AI tests and agent tests.

Start with the introduction, then build the capability, then design the dialog, and finally set up tests.

Key points

• A Copilot experience needs three parts: a prompt dialog page, the AI module of the system application, and an Azure OpenAI resource.
• Building the capability covers capability registration, authorization storage in IsolatedStorage, parameter configuration, metaprompt definition and response generation.
• The capability page covers chat completion, text completion and embeddings through the System.AI module, plus the token limits to keep in mind. It references 2025 release wave 2.
• The PromptDialog page type has prompt, generate and content modes, and the pages cover error handling and launching Copilot features from prompt actions.
• Testing uses the Evaluation framework (formerly AI Test Toolkit) with JSONL and YAML datasets.
• Test pages cover AI tests and agent tests, plus best practices for non-determinism, safety, languages and model changes.

Subtopics

• Build Copilot user experience (7 pages)
• Test Copilot capability in AL (6 pages)

More Learn pages

• Build the Copilot capability in AL: Integrate with Azure OpenAI Service through the AI module of Business Central.
• Introduction to developing generative AI experiences for your extensions: Learn essential tasks for building Copilot extensions in Business Central. Discover key components like prompt dialog pages and Azure OpenAI integration.

Videos and posts

Linked by a Haiku matcher with a grounding quote from the item’s summary (link/topics.ts); machine-generated.

• Creating Data Driven Text with AI in Business Central (community post): “Create a new Copilot codeunit that accepts customer data as parameters”
• Using CoPilot to Upgrade Service Notes for Invoices in Business Central AL (community post): “automatically upgrade raw service technician notes into professional, customer-facing text for invoices”
• Business Central Under the Hood episode 4: How we built Copilot Chat in Business Central (video): “Prompt Engineering with Test-Driven Development; Azure AI Studio Integration”
• What’s New: Designing and Developing Generative AI Experiences for Your Apps (2023 Release Wave 2) (video): “Copilot for Business Central; System Actions for Generate; AI Module for Copilot Generation”
• What’s New: Prepare Your Copilot Extension - Practical Considerations (2025 release wave 1) (video): “Copilot Extension Cloud Deployment; Shared Infrastructure for Copilot”
• What’s New: Extending Copilot in Business Central (2024 Release Wave 2) (video): “Copilot Prompt Actions on Card and Document Pages”
• Business Central Partner Learnings from the Red Carpet Copilot Program (video): “Copilot development; prompt engineering; Copilot Function with Prompt Engineering”
• What’s New: Extending Copilot Using AL Code (2024 Release Wave 1) (video): “Extending Copilot Using AL Code; token counting; function calling; copilot actions”

Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.