NORA | 360° mit dem ALBERT | AI Dev Studio entwickeln

NORA | 360° wird mit ALBERT | AI und dem ALBERT | AI Dev Studio entwickelt und angepasst. Das Developer Studio ist eine KI-gestützte Entwicklungsumgebung, die sich direkt in agorum core integriert und die Konfiguration von NORA | 360° Objekttypen, Metadaten, UI-Elementen und Geschäftslogik erheblich vereinfacht und beschleunigt.

Beispiel für einen eingerichteten NORA | 360° Workspace im Dev Studio

Voraussetzungen

1. Sie benötigen eine aktuelle Installation von agorum core pro. Wir empfehlen die Verwendung der aktuell verfügbaren neuesten Version.
2. Sie benötigen aktuelle Versionen der NORA | 360° Plugins.
3. Sie benötigen ALBERT | AI und ALBERT | AI Agents.
4. Für die Verwendung von ALBERT | AI Dev Studio benötigen Sie API-Zugriff auf ein leistungsstarkes KI-Modell. Wir nutzen beispielsweise Claude Opus 4.7.

Dev Studio für die NORA | 360° Entwicklung einrichten

Die folgenden Schritte zeigen, wie Sie das Dev Studio für die Entwicklung von NORA | 360° Projekten einrichten:

Plugins installieren

Sie benötigen aktuelle Versionen der ALBERT | AI Plugins und des Template Managers.

Bis zur Veröffentlichung von ALBERT | AI Dev Studio erhalten Sie dieses Plugin als zip-Paket und müssen es über das Support Tool oder den Template Manager installieren.

1. Öffnen Sie den Plugin Manager und installieren Sie die aktuellen Versionen von ALBERT | AI und ALBERT | AI Agents und Template Manager.
2. Öffnen Sie Weitere Apps in der Seitenleiste und anschließend das Support Tool.
3. Navigieren Sie im Support Tool zu Base System > Actions > Install Package.
4. Wählen Sie das zip-Package mit dem Dev Studio agorum.dev.studio-<VERSION>.zip, das Sie von agorum^® erhalten haben, aus und klicken Sie Install. 

ALBERT | AI Voreinstellungen einrichten

Das Developer Studio wird mit mehreren KI-Voreinstellungen ausgeliefert. Diese KI-Voreinstellungen enthalten bereits die notwendigen Einstellungen, um ALBERT | AI mit dem aktuellen Kontext im Dev Studio zu verwenden. Intern verwenden diese KI-Voreinstellungen die gemeinsame KI-Voreinstellung agorum_dev_studio_development_base, in der lediglich noch die KI-Voreinstellung mit der Verbindung zum Sprachmodell eingetragen werden muss.

1. Richten Sie eine KI-Voreinstellung ein, die die Verbindung zu Ihrem Sprachmodell herstellt (siehe KI-Voreinstellungen einrichten).
   In diesem Beispiel haben wir die KI-Voreinstellung agorum_ai_internal_dev_claude_large genannt. Diese Voreinstellung haben wir im Konfigurationsprojekt agorum.ai.internal.dev erstellt und die Benutzergruppe GRP_agorum.ai.internal.dev_ai_presets zugeordnet. Wenn Sie Ihre KI-Einstellungen in einem eigenen Konfigurationsprojekt verwalten (was wir empfehlen), können Sie analoge Einstellungen verwenden.
2. Öffnen Sie die KI-Voreinstellung agorum_dev_studio_development_base.
3. Tragen Sie als Referenzeinstellung die in Schritt 1 eingerichtete Voreinstellung ein, in diesem Beispiel agorum_ai_internal_dev_claude_large.
4. Speichern Sie die Änderung.

Beispiel für eine KI-Voreinstellung für ein großes KI-Modell

Beispiel für das Referenzieren der Modelleinstellung für das große KI-Modell

Konfigurationsprojekt mit dem Template Manager erstellen

Setzen Sie Ihre NORA | 360°-Anpassungen/‑Erweiterungen in einem eigenen Konfigurationsprojekt um. Dieses Projekt enthält alle Metadaten, Objekttyp-Definitionen, UI-Elemente, Handler und Übersetzungen für Ihre individuellen Anpassungen.

Für Informationen zum Erstellen eines neuen Projekts mit dem Template Manager siehe Neues Projekt installieren (aus Vorlage).

Erstellen eines eigenen Konfigurationsprojekts mit dem Template Manager

Workspace für NORA | 360° im Developer Studio einrichten

Nachdem das Konfigurationsprojekt erstellt wurde, richten Sie Ihren Arbeitsbereich im Dev Studio ein:

1. Öffnen Sie ALBERT | AI Developer Studio über das Hauptmenü  > Development > Open Developer Studio.
2. Im Developer Studio gruppieren Sie Entwicklungsaufgaben über Workspaces. Ein Workspace enthält dazu ein oder mehrere Konfigurationsprojekte oder Ordner. 
   Wählen Sie beim ersten Öffnen Neuen Workspace erstellen.
3. Geben Sie den Namen Ihres neuen Workspaces an. Beispiel: noradev
   
   Ergebnis: Das Developer Studio öffnet sich. 
4. Fügen Sie als Nächstes die NORA | 360° Projekte und Ihr eigenes NORA | 360° Konfigurationsprojekt zum Workspace hinzu. Wählen Sie dazu im Menü Datei > Projekte zum Workspace hinzufügen.
5. Suchen Sie nach agorum.smartorga und doppelklicken Sie auf das Projekt, um es hinzuzufügen.
   
   Ergebnis: agorum.smartorga wird Ihnen links im Explorer angezeigt.
6. Fügen Sie Ihr eigenes Konfigurationsprojekt zu Ihrem Workspace hinzu.
   
   Ergebnis: Ihr Konfigurationsprojekt wird Ihnen links im Explorer angezeigt.

Beispiel für einen eingerichteten NORA | 360° Workspace im Dev Studio

Workspace an die Seitenleiste heften und in einem neuen Fenster öffnen

1. Wenn Sie zukünftig auf Ihren neuen Workspace über die Seitenleiste zugreifen wollen, klicken Sie im agorum core Fenster (und nicht im darüber geöffneten Developer Studio Fenster) unten links in der Seitenleiste mit der rechten Maustaste auf Developer Studio - <Workspace-Name> und wählen Sie Als neuen Tab an Tab-Leiste anheften.
2. Jetzt können Sie das Developer Studio mit Ihrem NORA | 360° Workspace in einem neuen Browser-Tab öffnen. Klicken Sie dazu mit der rechten Maustaste auf den Eintrag in der Seitenleiste und wählen Sie In neuem Fenster öffnen.

Einen Dev Studio Workspace in einem neuen Tab öffnen

NORA | 360° mit Prompts entwickeln

Jetzt können Sie NORA | 360° direkt über natürlichsprachliche Prompts im Dev Studio entwickeln. ALBERT | AI erstellt auf Basis Ihrer Beschreibung automatisch alle notwendigen Dateien, von der Metadatendefinition über die Objekttyp-Deklaration bis hin zu UI-Elementen und Handlern.

Manuelle Schritte nach der Erstellung

Nachdem ALBERT | AI alle Dateien erstellt hat, sind abhängig von den erstellten Dateien folgende manuelle Aktionen erforderlich:

1. Metadaten registrieren: Die metadata.yml im Editor öffnen und den Run-Button klicken.
2. Übersetzungen deployen: Rechtsklick auf den messages-Ordner > agorum core template manager > Paket importieren.
3. Declaration registrieren: Rechtsklick auf die declaration.js > NORA | 360° > Entwicklung > Deklaration registrieren.
4. Cardlet registrieren: Rechtsklick auf die Cardlet-Datei > agorum core template manager > Registrieren > cards cardlet.
5. Decorator registrieren (falls erstellt): Rechtsklick auf die Decorator-Datei > agorum core template manager > Registrieren > cards decorator.
6. Oberfläche neu laden (F5)
7. Konfiguration generieren: Rechtsklick auf die declaration.js > NORA | 360° > Entwicklung > Konfiguration generieren.

Beispiel-Prompts für die NORA-Entwicklung

Die folgenden Beispiele zeigen typische Prompts, mit denen Sie NORA | 360° im Dev Studio erweitern können. Verwenden Sie diese als Ausgangspunkt und passen Sie sie an Ihre Anforderungen an.

Einen neuen Objekttyp erstellen

Erstelle einen neuen NORA-Objekttyp "Fahrzeugakte" in meinem Projekt <Projektname>.
Die Fahrzeugakte soll folgende Felder haben:
- Marke (Text, Pflichtfeld)
- Modell (Text)
- Kennzeichen (Text, Pflichtfeld)
- Baujahr (Zahl)
- Kilometerstand (Zahl)
- Nächste Inspektion (Datum)
- Fahrzeugstatus (Dropdown: Aktiv, In Werkstatt, Stillgelegt, Verkauft)

Der Fahrzeugstatus soll farbcodiert in der Card-Ansicht angezeigt werden.
Erstelle auch einen passenden Ablagebereich-Typ für Fahrzeugakten.
Schreibe Autotests und führe sie aus.

Erstelle eine Spec.

Einen bestehenden Objekttyp erweitern

Erweitere den bestehenden NORA-Objekttyp "Projekt" um ein neues Feld "Projektstatus" 
mit den Werten: Anfrage, Angebot, In Durchführung, Abgeschlossen.
Der Status soll:
- einen Standardwert "Anfrage" beim Erstellen erhalten
- farbcodiert in der Card-Ansicht angezeigt werden
- direkt aus der Card-Ansicht per Klick änderbar sein (Part-Edit)
- als Suchfilter im ACIC verfügbar sein

Erstelle eine Spec.

Beziehungen zwischen Objekttypen konfigurieren

Erstelle einen neuen NORA-Objekttyp "Inspektion" als Kind-Objekt der Fahrzeugakte.
Die Inspektion soll folgende Felder haben:
- Inspektionsdatum (Datum, Pflichtfeld)
- Inspektionsart (Dropdown: Regelmäßige Inspektion, TÜV, Reparatur)
- Ergebnis (Dropdown: Bestanden, Mängel festgestellt, Nicht bestanden)
- Bemerkungen (Textfeld, mehrzeilig)

Die Inspektion soll im Dashboard der Fahrzeugakte als Liste angezeigt werden.
Aus der Fahrzeugakte heraus soll man neue Inspektionen anlegen können.

Erstelle eine Spec.

Metadaten und UI-Elemente hinzufügen

Füge dem NORA-Objekttyp "Vorgang" ein neues Feld "Priorität" hinzu 
mit den Werten: Niedrig, Normal, Hoch, Kritisch.
Das Feld soll:
- in der Eingabemaske als Dropdown erscheinen
- den Standardwert "Normal" haben
- in der Card-Ansicht farbig angezeigt werden 
  (Niedrig=grau, Normal=blau, Hoch=orange, Kritisch=rot)
- als Facetten-Filter in der Suche verfügbar sein

Erstelle eine Spec.

Komplexe Geschäftslogik umsetzen

Erstelle eine Personalakte als neuen NORA-Objekttyp mit folgenden Anforderungen:
- Felder: Personalnummer (Pflicht), Vorname, Nachname, Abteilung (Dropdown), 
  Eintrittsdatum, Position
- Der Name der Akte soll automatisch aus "Nachname, Vorname (Personalnummer)" 
  gebildet werden
- Erstelle einen Kind-Objekttyp "Mitarbeitergespräch" mit den Feldern:
  Gesprächsdatum, Gesprächsart (Dropdown), Teilnehmer (User-Picker), Ergebnis
- Mitarbeitergespräche sollen im Dashboard der Personalakte als Liste erscheinen
- Erstelle passende Suchfilter für Abteilung und Position

Erstelle eine Spec.

Best Practices

• Schrittweise vorgehen: Beginnen Sie mit einem einfachen Objekttyp und erweitern Sie diesen nach und nach. So behalten Sie den Überblick und können Zwischenergebnisse prüfen.
• Konkret formulieren: Je präziser Ihr Prompt, desto besser das Ergebnis. Nennen Sie Feldnamen, Datentypen, Dropdown-Werte und gewünschtes Verhalten explizit.
• Spec-getrieben entwickeln: Nutzen Sie das Spezifikations-getriebene Entwicklungsvorgehen. Es reicht aus, wenn Sie ALBERT | AI Ihre Anforderungen als Prompt formulieren und dann am Ende schreiben: "Erstelle eine Spec". ALBERT | AI weiß dann, was zu tun ist. Es wird eine Spezifikations-MD-Datei erstellt, in der alles von ALBERT | AI genauestens zusammengetragen wird, was zur Umsetzung der Anforderung notwendig ist. Zusätzlich werden dort noch offene Fragen gestellt, die vom Benutzer beantwortet werden müssen. Auf Basis der Spezifikation und der zusätzlichen Benutzerantworten setzt ALBERT | AI dann die Anforderung um.
• Autotests nutzen: Lassen Sie die KI Autotests für Ihre Erweiterungen erstellen und ausführen. So stellen Sie sicher, dass alles korrekt funktioniert.
• Basisprojekte als Referenz: Die mitgelieferten NORA-Projekte (agorum.smartorga.crm, agorum.smartorga.project, agorum.smartorga.ticket) dienen als Referenz für eigene Erweiterungen.
• Ein Chat pro Aufgabe: Starten Sie für jede neue Entwicklungsaufgabe einen frischen Chat im Dev Studio. Das sorgt für bessere Ergebnisse.