--- id: topic/dev-itpro/integration-with-ai/integrate-ai-using-developer-tools-for-c/extend-copilot-in-business-central type: topic title: Extend Copilot in Business Central summary: "Extending Copilot in Business Central with AL: building a Copilot capability with the System.AI module and Azure OpenAI, designing the user experience with the PromptDialog page type, and testing capabilities and agents. It answers how-to questions for AL developers." tier: official language: en system: copilot review: state: reviewed by: opus at: "2026-10-07T02:18:27.474Z" flags: [] generated: at: "2026-10-08T06:31:25.130Z" pipeline: 0.2.0 prompts: hub-topic: 1 input_hash: 9308fd8a626d4f00ca44fcd3d8e6e79d6bf998054fccaa1aa38c757b4293a73d evidence: - kind: learn url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/ai-test-copilot-bestpractices title: Best Practices for Testing the Copilot Capability in AL date: "2026-10-02" commit: null t: null quote: null - kind: learn url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/ai-build-experience title: Build a Copilot user experience with the PromptDialog page date: "2026-05-03" commit: null t: null quote: null - kind: learn url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/ai-build-capability-in-al title: Build the Copilot capability in AL date: "2026-10-02" commit: null t: null quote: null - kind: learn url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/copilot-create-promptdialog title: Create prompt dialog page for Copilot feature date: "2026-10-02" commit: null t: null quote: null - kind: learn url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/copilot-customize-generate-mode title: Customize generate mode caption in Copilot date: "2026-10-02" commit: null t: null quote: null - kind: learn url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/ai-test-copilot-datasets title: Datasets date: "2026-10-02" commit: null t: null quote: null - kind: learn url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/copilot-design-content-mode title: Design content mode of prompt dialog page date: "2026-10-02" commit: null t: null quote: null - kind: learn url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/copilot-design-prompt-mode title: Design the prompt mode of prompt dialog page date: "2026-10-02" commit: null t: null quote: null - kind: learn url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-page-prompt-error-handling title: Error handling in prompt dialogs date: "2026-10-02" commit: null t: null quote: null - kind: learn url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/ai-test-copilot-testtool title: Evaluation date: "2026-10-02" commit: null t: null quote: null - kind: learn url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/ai-build-experience-overview title: Introduction to developing generative AI experiences for your extensions date: "2025-07-25" commit: null t: null quote: null - kind: learn url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-page-prompting-floating-actionbar title: Prompting using a floating action bar date: "2026-10-02" commit: null t: null quote: null - kind: learn url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/ai-test-copilot title: Test the Copilot Capability in AL date: "2026-10-02" commit: null t: null quote: null - kind: learn url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/ai-test-copilot-agent-tests title: Write agent tests date: "2026-10-02" commit: null t: null quote: null - kind: learn url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/ai-test-copilot-ai-tests title: Write AI tests date: "2026-10-02" commit: null t: null quote: null links: learn: - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/ai-build-capability-in-al - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/ai-build-experience-overview objects: [] features: [] topics: - topic/dev-itpro/integration-with-ai/integrate-ai-using-developer-tools-for-c - topic/dev-itpro/integration-with-ai/integrate-ai-using-developer-tools-for-c/extend-copilot-in-business-central/build-copilot-user-experience - topic/dev-itpro/integration-with-ai/integrate-ai-using-developer-tools-for-c/extend-copilot-in-business-central/test-copilot-capability-in-al localizations: [] videos: - video/06vgkq2EXmA - video/lNASlydCidI - video/NE7NIjpkX3c - video/QCo-uIfPs9g - video/UgagVZVKCso - video/ytYKvn2MiGs posts: - post/aardvarklabs-blog/1816 - post/aardvarklabs-blog/2759 guidelines: [] learn_toc_path: - Integration with AI - Integrate AI using developer tools for Copilot - Extend Copilot in Business Central toc_file: dev-itpro/TOC.md parent: topic/dev-itpro/integration-with-ai/integrate-ai-using-developer-tools-for-c children: - topic/dev-itpro/integration-with-ai/integrate-ai-using-developer-tools-for-c/extend-copilot-in-business-central/build-copilot-user-experience - topic/dev-itpro/integration-with-ai/integrate-ai-using-developer-tools-for-c/extend-copilot-in-business-central/test-copilot-capability-in-al coverage: learn: 15 code: 0 video: 6 blog: 2 guideline: 0 bc_forms: [] member_hash: 2ff560236f34656dcd4015f51cfddab4d5ae4484d1dfe47d2ddcd8d76f8788c0 narrative: generated --- # Extend Copilot in Business Central > Extending Copilot in Business Central with AL: building a Copilot capability with the System.AI module and Azure OpenAI, designing the user experience with the PromptDialog page type, and testing capabilities and agents. It answers how-to questions for AL developers. Path: [Integration with AI](../../integration-with-ai.md) > [Integrate AI using developer tools for Copilot](../integrate-ai-using-developer-tools-for-c.md) > 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](extend-copilot-in-business-central/build-copilot-user-experience.md) (7 pages) - [Test Copilot capability in AL](extend-copilot-in-business-central/test-copilot-capability-in-al.md) (6 pages) ## More Learn pages - [Build the Copilot capability in AL](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/ai-build-capability-in-al): Integrate with Azure OpenAI Service through the AI module of Business Central. - [Introduction to developing generative AI experiences for your extensions](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/ai-build-experience-overview): 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](../../../../posts/aardvarklabs-blog/1816.md) (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](../../../../posts/aardvarklabs-blog/2759.md) (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](../../../../videos/06vgkq2EXmA.md) (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)](../../../../videos/lNASlydCidI.md) (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)](../../../../videos/NE7NIjpkX3c.md) (video): "Copilot Extension Cloud Deployment; Shared Infrastructure for Copilot" - [What's New: Extending Copilot in Business Central (2024 Release Wave 2)](../../../../videos/QCo-uIfPs9g.md) (video): "Copilot Prompt Actions on Card and Document Pages" - [Business Central Partner Learnings from the Red Carpet Copilot Program](../../../../videos/UgagVZVKCso.md) (video): "Copilot development; prompt engineering; Copilot Function with Prompt Engineering" - [What's New: Extending Copilot Using AL Code (2024 Release Wave 1)](../../../../videos/ytYKvn2MiGs.md) (video): "Extending Copilot Using AL Code; token counting; function calling; copilot actions" Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn's own.