Zum Inhalt springen
Von C/AL zu AL: der Kurs für NAV-EntwicklerEin Kurs der decoso GmbH & Co. KGErstgespräch
Kursübersicht › Seite 11 von 11

Integration: Microsoft 365, Power Platform, Copilot und Agenten

Teams, Outlook, Excel, Power BI und Power Automate anbinden, Geschäftsereignisse melden, eigene Copilot-Funktionen bauen, MCP Server nutzen.

Stand November 2026 · Version 29

Autor: Elvis Schmidt, decoso GmbH & Co. KG

Lernziele dieser Seite Du weißt, was Business Central ohne eine Zeile Code mit Teams, Outlook, Excel, Word, OneDrive, Power BI und Power Automate kann, an welchen Stellen du als Entwickler eingreifst, wie du ein Geschäftsereignis nach außen meldest, wie Copilot und Agenten arbeiten, wie du eine eigene Copilot-Funktion in AL baust und wie deine API-Pages über den MCP Server zu Werkzeugen für KI-Agenten werden.

Neu vergebene Objekte auf dieser Seite: Codeunits 50116–50118, Page 50105, Enum Extensions 50100 und 50101. Alle liegen im Bereich 50100–50149 der Haupt-App.

1Erst integrieren, dann programmieren

In NAV 2017 war fast jede Anbindung ein Entwicklungsauftrag: Excel über Automation, Outlook über ein Add-in mit eigener Installation, Benachrichtigungen über selbst gebaute Job-Queue-Codeunits. In Business Central ist vieles davon Einrichtung. Deine Aufgabe verschiebt sich: Du sorgst dafür, dass deine Erweiterung in diesen Integrationen gut aussieht und sich sauber ansprechen lässt.

Wunsch des KundenNAV 2017Business CentralDeine Arbeit
Datensatz mit Kollegen besprechenScreenshot per E-MailLink in Teams wird zur KarteFeldgruppe Brick pflegen
Liste in Excel bearbeitenExport, Import per XMLport„In Excel bearbeiten“keine, aber Validierung im Tabellencode
Auswertung für die GeschäftsführungRDLC-BerichtAnalysemodus, Excel-Layout, Power BIQuery oder API bereitstellen
Nachricht bei einem Ereigniseigener Code mit SMTPPower AutomateGeschäftsereignis veröffentlichen
GenehmigungWorkflow-Modul oder EigenbauWorkflow oder Power Automatemeist keine
Text vorschlagen, Daten zusammenfassennicht möglichCopilotToolTips pflegen, bei Bedarf eigene Funktion
Externer Assistent greift auf Daten zuSOAP-DienstMCP Server über API-PagesAPI-Page schreiben, Rechte sauber setzen
Fast alles auf dieser Seite gilt nur für Business Central online. Teams-App, Copilot, Agenten und MCP Server stehen On-Premises nicht oder nur eingeschränkt zur Verfügung. Zum Testen brauchst du eine Online-Sandbox in einem Tenant mit Microsoft-365-Lizenzen.

2Teams

Die Business-Central-App für Teams bietet vier Dinge:

FunktionWas der Anwender sieht
KarteEin eingefügter Link auf einen Datensatz wird zu einer kompakten Karte mit ausgewählten Feldern. Derselbe Effekt entsteht über „In Teams teilen“ im Web-Client.
DetailsDie Schaltfläche „Details“ auf der Karte öffnet die echte Page in einem Fenster innerhalb von Teams, mit FactBoxes, Aktionen und Bearbeitung.
TabEine Liste oder ein Datensatz als Registerkarte in einem Kanal oder Chat.
KontaktsucheGeschäftskontakte aus Business Central in Teams suchen.

Was du als Entwickler beeinflusst

ElementStellschraube
Felder auf der KarteFeldgruppe Brick der Quelltabelle. Sie bestimmt auch die Kacheldarstellung im Web-Client und auf dem Telefon. Zusätzlich gibt es zwei Teams-Events, die Microsoft nur als Ergänzung empfiehlt.
Layout der Karte, weitere Schaltflächennicht änderbar
Details und TabsEs wird die normale Page eingebettet, samt Erweiterungen, Rollenanpassung und Personalisierung. Jede Änderung wirkt in allen Clients.
Unterstützte SeitentypenKarten: Card, Document, ListPlus. Tabs zusätzlich: List und Worksheet. Role Center nicht.
Tabs automatisch anlegenüber die Microsoft Graph API
fieldgroups
{
    fieldgroup(Brick; "Customer No.", "Visit Date", "Visit Type", Description)
    {
    }
    fieldgroup(DropDown; "Entry No.", "Customer No.", "Visit Date")
    {
    }
}

Mehr ist für eine brauchbare Teams-Karte der Besuchsverwaltung nicht nötig. Die Feldgruppen kennst du von Seite 3.

3Outlook

Das Outlook-Add-in zeigt neben einer E-Mail die Daten des Absenders aus Business Central: offene Belege, Saldo, Kontaktdaten. Aus der E-Mail heraus lassen sich Angebote oder Aufträge anlegen und Belege als Anhang zurückschicken. Belegnummern im Text einer E-Mail werden erkannt und verlinkt.

ThemaHinweis für Entwickler
Bereitstellungzentral durch den Microsoft-365-Administrator oder über die unterstützte Einrichtung in Business Central
Angezeigte Seitennormale Pages in schmaler Darstellung. Deine Page Extensions erscheinen dort ebenfalls, also Felder sparsam und in sinnvoller Reihenfolge hinzufügen.
E-Mail-Versand aus Business Centralüber das E-Mail-Modul der System Application mit Konten für Microsoft 365, aktuellen Benutzer oder SMTP. Im Code: Codeunits "Email Message" und Email (Seite 6).
Eingehende E-Mailswerden zunehmend von Agenten verarbeitet (Abschnitt 12), nicht mehr von selbst geschriebenen Postfach-Abrufen.

4Excel

FunktionWas sie tutTechnik dahinter
In Excel öffnenexportiert die aktuelle Liste mit Filtern als Dateireiner Export, keine Rückschreibung
In Excel bearbeitenöffnet die Liste mit einem Add-in, Änderungen werden zurückgeschriebenOData auf der Page. Trigger und Validierung der Tabelle laufen.
AnalysemodusPivot, Gruppierung und Summen direkt auf jeder Liste im Browserarbeitet auf den Feldern der Page und der Tabelle
Excel-Layouts für BerichteBericht liefert Daten in ein Excel-Blatt, die Auswertung baut der Anwender selbstrendering-Block mit Type = Excel (Seite 7)
Finanzberichte nach ExcelBilanz und GuV mit VorlageStandardfunktion
KonfigurationspaketeMassendaten für die EinrichtungRapidStart, wie in NAV
„In Excel bearbeiten“ ist eine offene Tür. Der Anwender kann hunderte Zeilen auf einmal ändern. Fachliche Prüfungen, die nur auf der Page stehen, greifen dort nicht zuverlässig. Prüfungen gehören deshalb in die Tabelle (OnValidate, OnModify). Seiten, die nicht in Excel bearbeitet werden sollen, schützt du über Berechtigungen, nicht über Hoffnung.

Für eigene Exporte aus Code bleibt die Tabelle „Excel Buffer“ mit Streams (Seite 7). In den meisten Fällen ist ein Bericht mit Excel-Layout aber weniger Arbeit und für den Kunden selbst anpassbar.

5Word

EinsatzBeschreibung
Word-Layouts für BelegeAngebot, Auftragsbestätigung, Rechnung als Word-Vorlage. Der Kunde ändert Schrift, Logo und Texte selbst über die Seite „Berichtslayouts“.
Word-Add-in für BelegberichteMit Version 29 überarbeitet: Felder des Berichts lassen sich im Add-in suchen und einfügen, statt über den XML-Zuordnungsbereich.
Wiederverwendbare Kopf- und Fußzeilen, DesignsEbenfalls neu in Version 29: Briefkopf einmal pflegen, in vielen Layouts nutzen.
Word-Vorlagen für SerienbriefeVorlagen auf Basis beliebiger Tabellen, zum Beispiel Anschreiben an Debitoren. Verknüpfte Tabellen lassen sich einbeziehen.

Für dich als Entwickler gilt die Regel von Seite 7: Die Spaltennamen im Dataset sind eine Schnittstelle. Benennst du eine Spalte um, brechen die Layouts, die der Kunde selbst gebaut hat.

6OneDrive

Online ist OneDrive ohne Einrichtung angebunden. Dateien aus Business Central lassen sich direkt im Browser öffnen oder teilen, statt sie herunterzuladen:

  • Anhänge an Belegen und Stammdaten („In OneDrive öffnen“, „Teilen“),
  • Berichte aus dem Berichtseingang,
  • Excel-Exporte von Listen.

Eigene Dateien, die du im Code erzeugst, kannst du auf demselben Weg anbieten. Zuständig ist das Modul „Document Sharing“ der System Application. Du füllst einen temporären Datensatz mit Dateiname, Erweiterung und Inhalt und übergibst ihn an die gleichnamige Codeunit. Prüfe die genaue Signatur mit F12, bevor du sie verwendest.

Für Dokumentenablage mit Aufbewahrungspflicht ist OneDrive nicht gedacht. Dafür gibt es Apps in AppSource, die an SharePoint oder ein Archivsystem anbinden.

7Power BI

BausteinBeschreibung
Eingebettete BerichtePower-BI-Berichte erscheinen als Teil im Role Center und als FactBox auf Listen, gefiltert auf den gewählten Datensatz.
Fertige Power-BI-AppsMicrosoft liefert Berichtspakete für Finanzen, Verkauf, Einkauf, Lager, Projekte und Produktion.
DatenquelleDer Business-Central-Konnektor in Power BI liest API-Pages und API-Queries.
LizenzAnzeigen eigener Berichte ist in der Business-Central-Lizenz enthalten, Teilen und Erstellen braucht je nach Fall Power BI Pro.

Was du beisteuerst

  • API-Queries statt API-Pages für Auswertungen. Eine Query verdichtet auf dem SQL Server und liefert weniger Zeilen. Die Query „ABC Visits per Customer“ aus Seite 7 ist dafür die Vorlage.
  • DataAccessIntent = ReadOnly an Queries und API-Pages für Auswertungen, damit die Abfragen auf der Lesereplik laufen.
  • Stabile Feldnamen. Ein umbenanntes API-Feld bricht jeden Power-BI-Bericht, der es verwendet.
  • Inkrementelles Laden über SystemModifiedAt ermöglichen, indem du das Feld in der API ausgibst.

8Power Automate

Power Automate verbindet Business Central mit hunderten anderer Dienste, ohne AL-Code. Ein Ablauf (Flow) besteht aus einem Auslöser und Aktionen.

ArtBeispiel
Automatischer FlowWenn ein Datensatz angelegt oder geändert wird, sende eine Nachricht in einen Teams-Kanal.
Genehmigungs-FlowEinkaufsbestellung über 5.000 € geht zur Freigabe an die Abteilungsleitung, Antwort per Teams oder E-Mail.
Sofort-FlowDer Anwender startet den Flow aus der Aktionsleiste einer Page (Menü „Automatisieren“) für den markierten Datensatz.
Geplanter FlowJeden Montag eine Liste überfälliger Besuche per E-Mail.
Flow auf GeschäftsereignisWenn ein Besuch als erledigt gemeldet wird, lege eine Aufgabe in Planner an (Abschnitt 9).

Berührungspunkte mit AL

ThemaErklärung
KonnektorDer Business-Central-Konnektor arbeitet mit API-Pages. Deine eigene API-Page aus Seite 7 ist dort sichtbar, sobald sie veröffentlicht ist.
Auslöser bei Datenänderungberuhen auf Webhooks der APIs. Sie melden mit Verzögerung und sagen nicht, was sich fachlich ereignet hat.
Geschäftsereignissemelden fachliche Ereignisse mit eigenen Nutzdaten. Das ist der sauberere Weg (Abschnitt 9).
Flow als Aktion auf einer PageIn Page Extensions gibt es dafür customaction mit CustomActionType = Flow. Meist reicht es, wenn der Anwender den Flow selbst über „Automatisieren“ anheftet.
Gebundene AktionenProzeduren mit [ServiceEnabled] auf API-Pages lassen sich aus einem Flow aufrufen, zum Beispiel „Besuch abschließen“.
Faustregel: Alles, was Daten in Business Central prüft oder bucht, gehört in AL. Alles, was nach außen benachrichtigt, weiterleitet oder andere Dienste anstößt, gehört in Power Automate. So bleibt die Geschäftslogik testbar und der Kunde kann seine Benachrichtigungen selbst ändern.

9Geschäftsereignisse nach außen

Auf Seite 5 hast du Events kennengelernt, die innerhalb von Business Central wirken. Ein externes Geschäftsereignis geht einen Schritt weiter: Fremde Systeme abonnieren es und erhalten eine Benachrichtigung über das Netz. Power Automate nutzt dafür den Dataverse-Auslöser „Wenn eine Aktion ausgeführt wird“. Andere Systeme abonnieren direkt über eine API.

Die Funktion ist in der Microsoft-Dokumentation weiterhin als Vorschau gekennzeichnet. Prüfe den Stand, bevor du einem Kunden Zusagen machst.
enumextension 50100 "ABC Event Category" extends EventCategory
{
    value(50100; "ABC Visits")
    {
        Caption = 'Customer Visits';
    }
}

codeunit 50116 "ABC Visit Business Events"
{
    Access = Internal;

    [ExternalBusinessEvent('abcvisitcompleted', 'Customer visit completed',
        'Triggered when a customer visit is marked as completed.', EventCategory::"ABC Visits")]
    [RequiredPermissions(PermissionObjectType::TableData, Database::"ABC Customer Visit", 'R')]
    procedure VisitCompleted(visitId: Guid; customerNo: Code[20]; visitDate: Date)
    begin
    end;

    [EventSubscriber(ObjectType::Table, Database::"ABC Customer Visit", 'OnAfterModifyEvent', '', false, false)]
    local procedure RaiseOnVisitCompleted(var Rec: Record "ABC Customer Visit"; var xRec: Record "ABC Customer Visit"; RunTrigger: Boolean)
    begin
        if Rec.IsTemporary() then
            exit;
        if Rec.Completed and not xRec.Completed then
            VisitCompleted(Rec.SystemId, Rec."Customer No.", Rec."Visit Date");
    end;
}
BausteinErklärung
Prozedur mit leerem RumpfSie ist nur die Beschreibung des Ereignisses. Der Aufruf löst die Benachrichtigung aus.
Attributparametertechnischer Name, Anzeigename, Beschreibung, Kategorie
Parameter der Prozedurbilden die Nutzdaten. Erlaubt sind einfache Typen wie Guid, Text, Code, Boolean, Decimal, Integer, Date, DateTime, Enum, RecordId. Keine Records.
[RequiredPermissions]optional: Nur wer diese Rechte hat, darf abonnieren.
BerechtigungssatzAbonnenten brauchen den Standardsatz „Ext. Events – Subscr“.
Katalog aktualisierenIn Power Apps an der Tabelle „Business Central Virtual Data Source Configuration“ die Aktion „Refresh Business Event Catalog“ ausführen, sonst erscheint das neue Ereignis nicht.
Zeitpunkt der Benachrichtigung: Sie wird erst gesendet, wenn die Transaktion abgeschlossen ist. Bei einem Fehler mit Rollback wird nichts gesendet. Das ist genau das Verhalten, das du mit einem selbst gebauten HttpClient-Aufruf mitten in der Buchung nicht bekommst (Seite 6).

Schicke in den Nutzdaten Schlüssel statt Inhalte: die SystemId und wenige Kennfelder. Der Empfänger holt Details bei Bedarf über die API. Wie jedes Event ist auch dieses eine Schnittstelle. Name und Parameter änderst du nach der Auslieferung nicht mehr.

10Dataverse und Power Apps

Dataverse ist die Datenplattform hinter Dynamics 365 Sales, Customer Service und Power Apps. Zwischen Business Central und Dataverse gibt es vier Arten der Zusammenarbeit:

ArtBeschreibungWann
DatensynchronisationDatensätze werden zwischen beiden Systemen abgeglichen (Debitor ↔ Firma, Kontakt ↔ Kontakt).Vertrieb arbeitet in Dynamics 365 Sales
Virtuelle TabellenBusiness-Central-Daten erscheinen in Dataverse, ohne kopiert zu werden. Grundlage sind API-Pages.Power Apps soll Live-Daten lesen und schreiben
DatenänderungsereignisseAnlegen, Ändern, Löschen als Auslösereinfache Reaktionen
Geschäftsereignissefachliche Ereignisse aus Abschnitt 9Abläufe über Systemgrenzen

Neu in Version 29: Zusätzliche Dataverse-Felder lassen sich in Business Central zuordnen, ohne dass ein Entwickler die Integrationstabellen erweitern muss.

Power Apps eignet sich für schmale Oberflächen neben dem ERP: eine Erfassungsmaske für den Außendienst auf dem Telefon, eine Inventur-App, ein Kiosk in der Werkstatt. Bevor du so etwas baust, prüfe, ob die mobile Business-Central-App mit einer einfachen eigenen Page nicht genügt.

11Copilot: was eingebaut ist

Microsoft unterscheidet zwei Begriffe. Copilot ist ein Assistent, den der Anwender anstößt und der Vorschläge macht. Agenten arbeiten selbstständig Aufgaben ab und legen dem Menschen Ergebnisse zur Prüfung vor (Abschnitt 12).

BereichFunktionWas sie tut
Für alleChatfindet Datensätze und erklärt Felder und Abläufe, auch die aus Zusatz-Apps
Analyseassistentbaut aus einer Beschreibung in Alltagssprache eine Analyseansicht mit Gruppierung, Pivot und Summen
Zusammenfassenzeigt neben einem Datensatz die wichtigsten Punkte mit Links
Autofillschlägt Feldwerte auf Karten und Belegen vor, auch auf eigenen Seiten
FinanzenBankabstimmungschlägt Zuordnungen und Gegenkonten vor
E-Beleg-Zuordnungordnet elektronische Eingangsrechnungen Bestellzeilen zu
VerkaufVerkaufszeilen vorschlagenerzeugt Zeilen aus Freitext, einer eingefügten Unterhaltung oder einer Datei
Marketingtexteschreibt Artikelbeschreibungen, optional direkt für Shopify
LagerErsatzartikelschlägt Alternativen für nicht lieferbare Artikel vor
EinrichtungNummernserienschlägt einheitliche Nummernserien vor

Was das für deine Erweiterung bedeutet

StellschraubeWirkung
ToolTip an jedem FeldDer Chat erklärt Felder anhand der ToolTips. Fehlen sie, kann Copilot zu deiner App nichts sagen. Seit einigen Versionen stehen ToolTips am Tabellenfeld (Seite 3).
Sprechende Caption-TexteSuche, Chat und Analyseassistent arbeiten mit den Bezeichnungen.
AboutTitle und AboutText an Pagesbeschreiben den Zweck einer Seite, für Einführungshinweise und für Copilot
Feldgruppen und Datenklassifizierungbestimmen, was in Zusammenfassungen sinnvoll erscheint und was als vertraulich gilt
Seite „Copilot- und Agent-Funktionen“Hier schaltet der Administrator jede Funktion einzeln ein oder aus, auch deine eigene.
Der Copilot-Chat selbst ist nicht erweiterbar. Du kannst ihm keine eigenen Befehle beibringen, sondern nur über gute Metadaten beeinflussen, was er über deine App weiß.

12Agenten

AgentAufgabe
Sales Order Agentliest Kundenanfragen aus einem Postfach, erkennt den Kontakt, erstellt ein Angebot zur Prüfung und wandelt es nach Bestätigung in einen Auftrag um
Payables Agentüberwacht ein Postfach auf Eingangsrechnungen, liest die Daten aus, gleicht mit Bestellungen und Wareneingängen ab und schlägt Konten für offene Zeilen vor
Expense AgentSpesenerfassung per Foto, E-Mail oder Chat mit Prüfung gegen Firmenrichtlinien. Mitarbeiter brauchen dafür keine Business-Central-Lizenz.

Wie Agenten technisch arbeiten

  • Ein Agent ist ein eigener Benutzer mit eigenen Berechtigungssätzen. Was auf Seite 8 über Berechtigungen steht, gilt für ihn genauso.
  • Er arbeitet über die normalen Pages mit einem eigenen Profil. Deine Page Extensions sieht er also auch, und deine Validierungen greifen.
  • Jeder Schritt wird protokolliert. Der Mensch prüft und gibt frei. Seit Version 29 gibt es dafür einen gemeinsamen Aufgabenbereich für alle Agenten und die Prüfung direkt auf der Seite.
  • Die Nutzung wird nach Verbrauch abgerechnet. Das ist ein Kostenpunkt, den der Kunde kennen muss.

Folgen für deinen Code

RegelGrund
Keine Confirm- oder Message-Dialoge in Validierungen ohne GuiAllowed()-PrüfungEin Agent kann Rückfragen nicht wie ein Mensch beantworten.
Fehlermeldungen mit klarem Text und HandlungsanweisungDer Agent liest die Meldung und versucht, darauf zu reagieren.
Pflichtfelder im Tabellencode erzwingen, nicht nur auf der PageDer Agent nutzt möglicherweise eine andere Seite oder ein anderes Profil.
Eigene Felder mit ToolTip versehenSonst weiß der Agent nicht, wofür sie gedacht sind.

Eigene Agenten baust du heute auf zwei Wegen: in Copilot Studio über den MCP Server (Abschnitt 14) oder mit den Agent-Werkzeugen in AL, die Microsoft schrittweise öffnet. Für den Anfang ist der erste Weg der einfachere.

13Eigene Copilot-Funktion in AL

Das KI-Modul der System Application (Namespace System.AI) bindet Azure OpenAI an. Es unterstützt Sprachmodelle für Text, keine Bild- oder Spracherkennung. Eine eigene Funktion besteht aus vier Teilen.

Teil 1: Funktion registrieren

enumextension 50101 "ABC Copilot Capability" extends "Copilot Capability"
{
    value(50100; "ABC Visit Summary")
    {
        Caption = 'Summarize customer visits';
    }
}

codeunit 50117 "ABC Copilot Setup"
{
    Subtype = Install;
    Access = Internal;
    InherentEntitlements = X;
    InherentPermissions = X;

    trigger OnInstallAppPerDatabase()
    begin
        RegisterCapability();
    end;

    procedure RegisterCapability()
    var
        EnvironmentInfo: Codeunit "Environment Information";
        CopilotCapability: Codeunit "Copilot Capability";
        LearnMoreUrlTxt: Label 'https://www.decoso-web.de', Locked = true;
    begin
        if not EnvironmentInfo.IsSaaSInfrastructure() then
            exit;
        if CopilotCapability.IsCapabilityRegistered(Enum::"Copilot Capability"::"ABC Visit Summary") then
            exit;
        CopilotCapability.RegisterCapability(
            Enum::"Copilot Capability"::"ABC Visit Summary",
            Enum::"Copilot Availability"::Preview,
            LearnMoreUrlTxt);
    end;
}

Die App hat bereits die Install-Codeunit 50112 aus Seite 8. Mehrere Install-Codeunits sind erlaubt. Rufe RegisterCapability() zusätzlich aus der Upgrade-Codeunit auf, sonst fehlt die Registrierung bei Kunden, die von Version 1.1 kommen. Die Funktion erscheint danach auf der Seite „Copilot- und Agent-Funktionen“ und kann dort abgeschaltet werden.

Teil 2: Zugangsdaten sicher ablegen

Du brauchst die Adresse einer Azure-OpenAI-Ressource, den Namen der Bereitstellung und einen Schlüssel. Diese Werte stehen nie im Code. Sie kommen in IsolatedStorage, der Schlüssel als SecretText (Seite 6).

Teil 3: Text erzeugen

codeunit 50118 "ABC Visit Summary"
{
    Access = Internal;

    procedure Generate(CustomerNo: Code[20]; UserWish: Text): Text
    var
        AzureOpenAI: Codeunit "Azure OpenAI";
        AOAIChatMessages: Codeunit "AOAI Chat Messages";
        AOAIChatCompletionParams: Codeunit "AOAI Chat Completion Params";
        AOAIOperationResponse: Codeunit "AOAI Operation Response";
        Endpoint: Text;
        Deployment: Text;
        ApiKey: SecretText;
    begin
        IsolatedStorage.Get('ABCEndpoint', DataScope::Module, Endpoint);
        IsolatedStorage.Get('ABCDeployment', DataScope::Module, Deployment);
        IsolatedStorage.Get('ABCApiKey', DataScope::Module, ApiKey);

        AzureOpenAI.SetAuthorization(Enum::"AOAI Model Type"::"Chat Completions", Endpoint, Deployment, ApiKey);
        AzureOpenAI.SetCopilotCapability(Enum::"Copilot Capability"::"ABC Visit Summary");

        AOAIChatCompletionParams.SetMaxTokens(800);
        AOAIChatCompletionParams.SetTemperature(0);

        AOAIChatMessages.SetPrimarySystemMessage(GetMetaprompt());
        AOAIChatMessages.AddUserMessage(BuildVisitText(CustomerNo) + ' ' + UserWish);

        AzureOpenAI.GenerateChatCompletion(AOAIChatMessages, AOAIChatCompletionParams, AOAIOperationResponse);
        if not AOAIOperationResponse.IsSuccess() then
            Error(AOAIOperationResponse.GetError());

        exit(AOAIChatMessages.GetLastMessage());
    end;

    local procedure GetMetaprompt(): Text
    begin
        exit('You summarize customer visits for a sales team. ' +
             'Use only the visits given in the user message. ' +
             'Answer in the language of the user. ' +
             'Return at most five short sentences. ' +
             'If there are no visits, say so and do not invent any.');
    end;

    local procedure BuildVisitText(CustomerNo: Code[20]): Text
    var
        CustomerVisit: Record "ABC Customer Visit";
        Builder: TextBuilder;
    begin
        CustomerVisit.SetRange("Customer No.", CustomerNo);
        CustomerVisit.SetCurrentKey("Visit Date");
        CustomerVisit.Ascending(false);
        if CustomerVisit.FindSet() then
            repeat
                Builder.AppendLine(StrSubstNo('%1 | %2 | %3',
                    Format(CustomerVisit."Visit Date", 0, 9),
                    CustomerVisit."Visit Type",
                    CustomerVisit.Description));
            until (CustomerVisit.Next() = 0) or (Builder.Length() > 6000);
        exit(Builder.ToText());
    end;
}
BegriffBedeutung
Metaprompt (Systemnachricht)legt Rolle, Grenzen und Ausgabeform des Modells fest. Hier steckt die eigentliche Arbeit. In echten Apps legst du ihn nicht als Text im Code ab, sondern in einem Key Vault oder in IsolatedStorage.
Temperatur0 bis 2. Niedrig ergibt gleichbleibende, sachliche Antworten, hoch ergibt freiere Texte.
TokenAbrechnungs- und Längeneinheit. Eingabe und Ausgabe zusammen dürfen die Grenze des Modells nicht überschreiten. ApproximateTokenCount schätzt vorab.
AbrechnungsartSeit 2025 Wave 2 gibst du bei der Registrierung an, wer zahlt: „Custom Billed“ (du oder der Kunde über eine eigene Azure-Ressource), „Microsoft Billed“ (Business-Central-KI-Ressourcen) oder „Not Billed“.

Teil 4: Oberfläche mit PromptDialog

page 50105 "ABC Visit Summary Prompt"
{
    Caption = 'Summarize visits with Copilot';
    PageType = PromptDialog;
    Extensible = false;
    IsPreview = true;
    ApplicationArea = All;

    layout
    {
        area(Prompt)
        {
            field(UserWish; UserWish)
            {
                ShowCaption = false;
                MultiLine = true;
                InstructionalText = 'What should the summary focus on?';
            }
        }
        area(Content)
        {
            field(Summary; Summary)
            {
                ShowCaption = false;
                MultiLine = true;
                Editable = false;
            }
        }
    }

    actions
    {
        area(SystemActions)
        {
            systemaction(Generate)
            {
                Caption = 'Generate';
                trigger OnAction()
                var
                    VisitSummary: Codeunit "ABC Visit Summary";
                begin
                    Summary := VisitSummary.Generate(CustomerNo, UserWish);
                end;
            }
            systemaction(Regenerate)
            {
                Caption = 'Regenerate';
                trigger OnAction()
                var
                    VisitSummary: Codeunit "ABC Visit Summary";
                begin
                    Summary := VisitSummary.Generate(CustomerNo, UserWish);
                end;
            }
            systemaction(OK)
            {
                Caption = 'Keep it';
            }
            systemaction(Cancel)
            {
                Caption = 'Discard';
            }
        }
    }

    procedure SetCustomer(NewCustomerNo: Code[20])
    begin
        CustomerNo := NewCustomerNo;
    end;

    var
        CustomerNo: Code[20];
        UserWish: Text;
        Summary: Text;
}

Der Seitentyp PromptDialog gibt den Ablauf vor, den Anwender von allen Copilot-Funktionen kennen: Eingabe, Erzeugen, Ergebnis ansehen, behalten oder verwerfen. Aufgerufen wird die Seite aus einer Aktion auf der Debitorenkarte, üblicherweise im Bereich area(Prompting) mit dem Copilot-Symbol.

Verantwortung: Du schickst Kundendaten an einen KI-Dienst. Kläre vor dem Einsatz, welche Daten das sind, in welcher Region die Azure-Ressource liegt und ob der Kunde zugestimmt hat. Zeige Ergebnisse immer als Vorschlag, den ein Mensch übernimmt, und schreibe nie ungeprüft in gebuchte Daten. Microsoft erwartet zu jeder Funktion eine Beschreibung für Administratoren („Learn more“-Link bei der Registrierung).

14MCP Server: deine APIs als Werkzeuge für Agenten

Das Model Context Protocol (MCP) ist ein Standard, über den KI-Assistenten Werkzeuge ansprechen. Auf Seite 10 hast du den AL MCP Server kennengelernt, der beim Entwickeln hilft. Hier geht es um den Business Central MCP Server: Er macht die Daten und Aktionen einer Umgebung für Agenten zugänglich, etwa in Copilot Studio, Microsoft Copilot, Teams, VS Code oder Claude.

Was Agenten darüber können

VorgangGrundlage
Datensätze lesenAPI-Pages und API-Queries
Anlegen, Ändern, LöschenAPI-Pages, wenn in der Konfiguration erlaubt
Aktionen ausführengebundene Aktionen an API-Pages, zum Beispiel Buchen
Freie Datenabfragen (Vorschau)Werkzeuge wie bc_data_find_tables, bc_data_get_table_schema, bc_data_query, nur lesend

Einrichtung

  1. Seite „Model Context Protocol (MCP) Server Configurations“ öffnen (Page 8350). Nötig ist der Berechtigungssatz „MCP - Admin“.
  2. Neue Konfiguration anlegen, Name und Beschreibung vergeben, „Active“ zunächst aus lassen.
  3. Unter „Server Features“ die „API Tools“ aktivieren.
  4. Unter „Available APIs“ die gewünschten API-Objekte hinzufügen und je Objekt festlegen: Allow Read, Create, Modify, Delete, Actions.
  5. Für Schreibzugriffe zusätzlich „Unblock Edit Tools“ einschalten.
  6. „Validate“ ausführen, dann „Active“ setzen. Eine aktive Konfiguration ist schreibgeschützt.
  7. Über „Advanced“ → „Connection String“ die Verbindungsdaten für den Client kopieren.
"businesscentral": {
   "url": "https://mcp.businesscentral.dynamics.com",
   "type": "http",
   "headers": {
      "TenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
      "EnvironmentName": "DEV",
      "Company": "CRONUS DE",
      "ConfigurationName": "ABC Besuche"
   }
}

Aus API-Objekten werden Werkzeuge

Jede erlaubte Operation wird zu einem Werkzeug. Der Name entsteht aus den API-Metadaten, nicht aus der Caption:

ErlaubnisWerkzeugnameBeispiel für die Besuchs-API (Page 50103)
Allow ReadList_<EntitySetName>_PAG<ID>List_CustomerVisits_PAG50103
Allow CreateCreate_<EntityName>_PAG<ID>Create_CustomerVisit_PAG50103
Allow ModifyModify_<EntityName>_PAG<ID>Modify_CustomerVisit_PAG50103
Allow DeleteDelete_<EntityName>_PAG<ID>Delete_CustomerVisit_PAG50103

Die Beispielnamen setzen voraus, dass deine API-Page EntitySetName = 'customerVisits' und EntityName = 'customerVisit' trägt. Daran siehst du, warum die Namensgebung aus Seite 7 wichtig ist: Ein Agent wählt sein Werkzeug anhand dieses Namens.

Die Standardkonfiguration erlaubt bereits Lesezugriff. Ohne jede Einrichtung können Agenten alle geeigneten API-Pages und API-Queries finden und lesen, für die der angemeldete Benutzer Ausführungs- und Leserechte hat. Sobald deine App eine API-Page enthält, ist sie auf diesem Weg erreichbar. Der Schutz sind die Berechtigungssätze aus Seite 8, nicht das Verstecken der Seite. Prüfe bei jeder API-Page, wer sie ausführen darf und welche Felder sie ausgibt.

Regeln für agententaugliche API-Pages

  • Nur Felder ausgeben, die ein Außenstehender sehen darf. Was die API zeigt, sieht auch der Agent.
  • Sprechende, stabile Namen für EntityName, EntitySetName und Felder.
  • Unterseiten vom Typ ListPart oder CardPart werden nicht als Werkzeug unterstützt. Jede Entität braucht eine eigene API-Page auf oberster Ebene.
  • Schreibrechte nur dort freigeben, wo die Tabelle alle Prüfungen selbst erzwingt.
  • Copilot Studio erlaubt höchstens 70 Werkzeuge je Agent. Bei vielen APIs hilft der „Dynamic Tool Mode“.

15Weitere nützliche Funktionen

FunktionNutzenFür Entwickler
Page ScriptingAbläufe im Browser aufzeichnen und wieder abspielen, für Abnahmetests nach Updates. Seit Version 29 allgemein verfügbar.Aufzeichnungen lassen sich in die Pipeline einbinden (Seite 9).
AnalysemodusPivot auf jeder Liste, Ansichten speicher- und teilbarFelder in der Tabelle sauber benennen, FlowFields sparsam einsetzen
Mobile AppTelefon und Tablet, Kamera und StandortBarcode-Scan über die Feldeigenschaft ExtendedDatatype = Barcode
Control Add-inseigene Oberflächenelemente in JavaScript, zum Beispiel Diagramme, Karten, UnterschriftenfeldObjekttyp controladdin, Ersatz für die alten Client-Add-ins (Seite 6)
Shopify-ConnectorArtikel, Kunden, Aufträge und Bestände mit einem Shop abgleichen. In Version 29 um B2B und Retouren erweitert.erweiterbar über Events der Shopify-App
E-BelegeRahmenwerk für elektronische Rechnungen mit länderspezifischen Formateneigene Formate und Dienste über Interfaces anbinden
TelemetrieLaufzeitdaten der App in Application Insights, auswertbar mit fertigen Power-BI-BerichtenVerbindungszeichenfolge in app.json, eigene Signale über Session.LogMessage (Seite 9)
Rollenanpassung und PersonalisierungKunden blenden Felder selbst ein und ausFelder mit Visible = false anbieten statt für jeden Wunsch eine Page Extension zu schreiben

16Übung: Besuchsverwaltung anbinden

Voraussetzung ist eine Online-Sandbox mit Teams. Für Schritt 4 brauchst du zusätzlich eine Azure-OpenAI-Ressource. Wenn du keine hast, lass ihn aus.

Schritt 1: Teams-Karte

  1. In src/ABCCustomerVisit.Table.al die Feldgruppe Brick aus Abschnitt 2 ergänzen oder anpassen.
  2. App veröffentlichen, die Besuchskarte öffnen, Link kopieren und in einen Teams-Chat einfügen.
  3. Prüfen: Zeigt die Karte die vier Felder? Öffnet „Details“ die Besuchskarte?
  4. In einem Kanal einen Tab mit der Liste „Kundenbesuche“ anlegen.

Schritt 2: Geschäftsereignis

  1. src/ABCEventCategory.EnumExt.al und src/ABCVisitBusinessEvents.Codeunit.al aus Abschnitt 9 anlegen.
  2. Beide neuen Objekte in den Berechtigungssatz „ABC Visit - Objects“ aufnehmen.
  3. Dataverse-Verbindung mit „Virtuelle Tabellen und Ereignisse aktivieren“ einrichten und den Katalog aktualisieren.
  4. In Power Automate einen Flow mit dem Auslöser „Wenn eine Aktion ausgeführt wird“ bauen: Katalog „Dynamics 365 Business Central“, Kategorie „Customer Visits“, Aktion „Customer visit completed“. Als Folgeschritt eine Nachricht in einen Teams-Kanal senden.
  5. Einen Besuch auf „Erledigt“ setzen und prüfen, ob die Nachricht erscheint.

Schritt 3: MCP Server

  1. Konfiguration „ABC Besuche“ nach Abschnitt 14 anlegen, API-Page 50103 mit „Allow Read“ hinzufügen, validieren, aktivieren.
  2. Verbindungszeichenfolge in einen MCP-fähigen Client eintragen, zum Beispiel VS Code.
  3. Fragen: „Welche Besuche gab es im letzten Monat bei Debitor 10000?“
  4. Gegenprobe mit einem Benutzer ohne den Satz „ABC Visit - Read“. Der Zugriff muss scheitern.

Schritt 4 (optional): Copilot-Zusammenfassung

  1. Die Objekte aus Abschnitt 13 anlegen: Enum Extension 50101, Codeunits 50117 und 50118, Page 50105.
  2. Auf der Seite „ABC Visit Setup“ drei Aktionen oder Felder ergänzen, über die ein Administrator Endpunkt, Bereitstellung und Schlüssel in IsolatedStorage schreibt. Den Schlüssel als maskiertes Feld erfassen und nie wieder anzeigen.
  3. Auf der Debitorenkarte eine Aktion „Besuche zusammenfassen“ ergänzen, die Page 50105 mit SetCustomer(Rec."No.") und RunModal() öffnet.
  4. Prüfen, dass die Funktion auf der Seite „Copilot- und Agent-Funktionen“ erscheint und sich abschalten lässt.

Schritt 5: Übersetzen und einchecken

EnglischDeutsch
Customer Visits (Kategorie)Kundenbesuche
Customer visit completedKundenbesuch erledigt
Summarize customer visitsKundenbesuche zusammenfassen
Summarize visits with CopilotBesuche mit Copilot zusammenfassen
What should the summary focus on?Worauf soll die Zusammenfassung achten?
Keep it / DiscardÜbernehmen / Verwerfen
git add .
git commit -m "Integration: Teams-Karte, Geschaeftsereignis, Copilot-Zusammenfassung"
git push

17Typische Fallen

FalleFolgeAbhilfe
Keine Feldgruppe BrickTeams-Karte zeigt zufällige oder kaum FelderFeldgruppe an jeder eigenen Tabelle mit Karte pflegen
Prüfung nur auf der Page„In Excel bearbeiten“, API, Agent und MCP umgehen siePrüfung in die Tabelle
Confirm in OnValidateAgenten und Hintergrundsitzungen scheiternGuiAllowed() prüfen oder Rückfrage auf die Page verlegen
API-Page ohne Rechteprüfung ausgeliefertüber den MCP Server für jeden berechtigten Benutzer lesbarAusführungsrecht nur in passenden Sätzen, Felder beschränken
API-Feld oder Ereignis umbenanntFlows, Power-BI-Berichte und Agenten brechenNamen als Schnittstelle behandeln, neue Version anlegen
HTTP-Aufruf in der Buchung statt GeschäftsereignisBenachrichtigung trotz Rollback, langsame TransaktionGeschäftsereignis und Power Automate
API-Schlüssel im Code oder in einer normalen TabelleSchlüssel lesbar für jeden mit TabellenzugriffSecretText und IsolatedStorage oder Key Vault
Copilot-Funktion nur in der Install-Codeunit registriertfehlt bei Bestandskunden nach dem Upgradeauch im Upgrade-Code registrieren
KI-Ergebnis ungeprüft gespeichertfalsche Daten im Systemimmer Vorschlag mit Übernehmen oder Verwerfen
Test nur in DockerTeams, Copilot und MCP lassen sich dort nicht prüfenOnline-Sandbox verwenden
Fehlende ToolTipsCopilot-Chat kann die eigenen Felder nicht erklärenToolTip an jedem Feld, die Code-Analyse meldet Lücken

18Selbsttest und Zusammenfassung

1. Womit bestimmst du die Felder einer Teams-Karte?

Mit der Feldgruppe Brick der Quelltabelle. Die Teams-Events sind nur eine Ergänzung.

2. Warum reicht eine Prüfung auf der Page nicht aus?

Weil Excel-Bearbeitung, APIs, Agenten und der MCP Server die Daten auf anderen Wegen ändern. Nur Tabellencode greift überall.

3. Was unterscheidet ein externes Geschäftsereignis von einem Integration Event?

Das Integration Event wirkt innerhalb von Business Central für andere Apps. Das Geschäftsereignis benachrichtigt fremde Systeme, und zwar erst nach dem Commit.

4. Welche Datentypen darf ein Geschäftsereignis als Parameter haben?

Einfache Typen wie Guid, Text, Code, Boolean, Zahlen, Datum, Enum, RecordId. Keine Records.

5. Was ist der Unterschied zwischen Copilot und einem Agenten?

Copilot wird vom Anwender angestoßen und macht Vorschläge. Ein Agent arbeitet selbstständig Aufgaben ab und legt Ergebnisse zur Prüfung vor.

6. Kannst du dem Copilot-Chat einen eigenen Befehl hinzufügen?

Nein. Der Chat ist nicht erweiterbar. Du beeinflusst ihn über ToolTips, Captions und Seitenbeschreibungen. Eigene Funktionen baust du als PromptDialog.

7. Welche zwei Objekte registrieren eine eigene Copilot-Funktion?

Eine enumextension von „Copilot Capability“ und eine Codeunit, die RegisterCapability aufruft.

8. Deine App enthält eine API-Page. Was kann ein Agent über den MCP Server ohne weitere Einrichtung?

Die Seite finden und lesen, sofern der angemeldete Benutzer sie ausführen und die Tabelle lesen darf. Schreiben erst nach ausdrücklicher Freigabe in einer Konfiguration.

9. Wie heißt das Lesewerkzeug für eine API-Page 50103 mit EntitySetName = 'customerVisits'?

List_CustomerVisits_PAG50103.

Zusammenfassung

  • Viele frühere Entwicklungsaufträge sind heute Einrichtung in Teams, Excel, Power BI und Power Automate.
  • Deine Erweiterung wird gut integrierbar durch vier Dinge: Feldgruppen, ToolTips, Prüfungen in der Tabelle und saubere API-Pages.
  • Fachliche Ereignisse meldest du mit [ExternalBusinessEvent] nach außen, die Reaktion baut der Kunde in Power Automate.
  • Copilot schlägt vor, Agenten arbeiten selbstständig. Beide nutzen deine Pages und Metadaten.
  • Eigene KI-Funktionen entstehen aus Registrierung, sicherer Schlüsselablage, Metaprompt und PromptDialog.
  • Über den MCP Server werden API-Pages zu Werkzeugen für Agenten. Berechtigungen sind dabei der einzige Schutz.
Für Anwender und Key User ist ein eigener Kurs geplant: Bedienung des Web-Clients im Vergleich zu NAV, Suchen und Filtern, Ansichten, Personalisierung, Analysemodus, Excel und Teams im Alltag sowie die neuen Funktionen gegenüber dem alten Standard. Der Link wird hier ergänzt, sobald die Adresse feststeht.

Quellen (Stand November 2026)

Eigene Copilot-Funktionen oder Agenten-Anbindung?Wir bauen sie mit euch oder für euch.

Erstgespräch vereinbaren

Fehler gefunden? Bitte melden. Wir prüfen jede Meldung.