Table of Contents

Voraussetzungen

Dieses Dokumentation beschreibt die notwendigen Voraussetzungen und detaillierten Schritte zur Einrichtung des unitop KI Frameworks. Das Framework ist die zentrale Komponente des unitop KI Basis Add-ons und dient der Anbindung Ihres unitop ERP-Systems an die leistungsstarken Azure OpenAI Services von Microsoft. Eine korrekte Einrichtung ist grundlegend für die Nutzung aller KI-gestützten Funktionen.

Bevor Sie mit der Einrichtung des unitop KI Frameworks beginnen, müssen folgende Voraussetzungen erfüllt sein:

Microsoft Dynamics 365 Business Central Business Central Version 26.0 oder höher
Das unitop KI Basis Add-on muss in Ihrer Business Central Umgebung lizenziert und installiert sein
Microsoft Azure Abonnement und Ressourcen Alle Azure-Ressourcen sollten idealerweise im Azure Tenant Ihres Unternehmens verwaltet werden.
Azure Abonnement Ein aktives Microsoft Azure Abonnement mit ausreichenden Rechten zur Erstellung und Verwaltung von Ressourcen.
Azure OpenAI Service Ressource Eine bereitgestellte Azure OpenAI Service Ressource in Ihrem Azure Abonnement
Kostenhinweis: Für die Bereitstellung der Azure OpenAI Ressource selbst fallen in der Regel keine monatlichen Grundgebühren an. Kosten entstehen nutzungsbasiert (Pay-as-you-go) durch den Verbrauch von Tokens bei API-Aufrufen an die KI-Modelle.
Modellbereitstellungen im Azure OpenAI Service Innerhalb Ihrer Azure OpenAI Service Ressource müssen die spezifischen KI-Modelle, die Sie verwenden möchten, bereitgestellt (deployed) sein.
Beispiele für Modelle: gpt-4o, gpt-4.1, gpt-4.1-mini (oder aktuellere Versionen)

Wichtig beim Deployment-Typ:

Deployment-Typ Beschreibung Empfehlung
Regional Datenverarbeitung erfolgt garantiert in der ausgewählten Azure-Region (z. B. "West Europe", "Sweden Central") Dies ist die empfohlene Einstellung für produktive Umgebungen, um DSGVO-Konformität sicherzustellen
Datenzonenstandard (Data Zone Standard) Verarbeitung im Euroraum Ist ebenfalls DSGVO-konform
Globaler Standard (Global Standard) Daten können potenziell weltweit verarbeitet werden Für EU-Unternehmen und DSGVO-Kontext nicht empfohlen
API-Schlüssel des Azure OpenAI Service Für die Authentifizierung der API-Aufrufe von unitop an die Azure OpenAI Modelle wird ein API-Schlüssel benötigt.
Dieser Schlüssel ist in den Bereitstellungen in der Azure AI Foundry im Azure Portal zu finden.
Azure Active Directory (Entra ID) App-Registrierung für OAuth 2.0 Das unitop KI Framework benötigt eine Methode, um die Liste der verfügbaren Modellbereitstellungen aus Ihrer Azure OpenAI Ressource dynamisch abzurufen. Dies geschieht über OAuth 2.0.
Folgende Komponenten werden benötigt:
• Eine App-Registrierung in Ihrem Azure Active Directory (Azure AD / Entra ID)
• Diese App-Registrierung benötigt mindestens Leseberechtigungen auf Ihre Azure OpenAI Service Ressource
Folgende Informationen dieser App-Registrierung werden für die Einrichtung benötigt:
• Tenant ID (Verzeichnis-ID)
• Application (Client) ID (Anwendungs-ID)
• Client Secret (Anmeldeinformationen -> Zertifikate & Geheimnisse -> Neuer geheimer Clientschlüssel, notieren Sie den Wert des Geheimnisses direkt nach der Erstellung, da er später nicht mehr angezeigt wird.)