Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > agorum core Module und Plugins > NORA | 360°

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

NORA | 360° wird mit ALBERT | AI und dem ALBERT | AI Developer 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.

Hinweis: Das ALBERT | AI Developer Studio ist Bestandteil der ALBERT | AI Suite und wird mit ihr installiert. Wie Sie im Developer Studio allgemein arbeiten, beschreibt Mit ALBERT l AI Developer Studio arbeiten.

 

Beispiel für einen eingerichteten NORA | 360° Workspace im Developer 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 die ALBERT | AI Suite. Das ALBERT | AI Developer Studio ist darin enthalten.
  4. Für die Verwendung von ALBERT | AI Developer Studio benötigen Sie API-Zugriff auf ein leistungsstarkes KI-Modell. Wir nutzen beispielsweise Claude Opus 4.7.

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

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

Developer Studio installieren

Das ALBERT | AI Developer Studio ist Bestandteil der ALBERT | AI Suite. Eine eigene Installation ist nicht nötig.

Installieren oder aktualisieren Sie die ALBERT | AI Suite im agorum core plugin manager.

Ergebnis: Das ALBERT | AI Developer Studio ist installiert.

Berechtigungen vergeben

Damit ein Entwickler das ALBERT | AI Developer Studio öffnen und darin mit ALBERT | AI arbeiten kann, braucht er folgende Berechtigungen:

Eine eigene Benutzergruppe für die KI-Voreinstellung mit der Verbindung zum Sprachmodell brauchen die Entwickler nicht. Einzelheiten beschreibt ALBERT l AI Developer Studio berechtigen.

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 Developer 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.

Achtung: Die KI-Voreinstellungen agorum_dev_studio_agorum_core_development, agorum_dev_studio_agorum_core_development_qs und agorum_dev_studio_agorum_core_development_documentation werden bei jedem Update des Plugins neu bereitgestellt. Eigene Änderungen daran gehen dabei verloren. Tragen Sie das Sprachmodell deshalb nur in agorum_dev_studio_development_base ein (siehe ALBERT l AI Developer Studio konfigurieren).

 

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 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.

Das Konfigurationsprojekt legt ALBERT | AI im Developer Studio für Sie an. Nennen Sie dazu im Chat die Projektart (Kunden-, Partner- oder agorum-Projekt), den Namen und das Kürzel des Kunden oder Partners sowie den Projektnamen. ALBERT | AI nennt Ihnen den daraus gebildeten Projektnamen und fragt vor dem Anlegen nach. Wie das im Einzelnen abläuft, beschreibt Mit ALBERT l AI Developer Studio arbeiten.

Alternativ erstellen Sie das Projekt mit dem Template Manager, siehe Neues Projekt installieren (aus Vorlage).

 

Erstellen eines eigenen Konfigurationsprojekts mit dem Template Manager

Tipps:

  • Die Konfigurationsprojekte für NORA | 360° verwenden die technischen Namen agorum.smartorga.<name>. 
  • Wenn Sie einen abweichenden Produktnamen (Marketing-Namen) angeben wollen, können Sie bei Bedarf das Pipe-Zeichen durch ein kleines "L" ersetzen. Das Pipe-Zeichen selbst ist nicht zulässig.

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

Nachdem das Konfigurationsprojekt erstellt wurde, richten Sie Ihren Arbeitsbereich im Developer 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, zum Beispiel noradev.

    Ergebnis: Der Workspace ist angelegt und geöffnet.
  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.

Hinweis: Durch das Einbinden der NORA | 360° Basisprojekte in den Workspace kann die KI bestehende Objekttypen, Deklarationen und Beispiele als Referenz heranziehen. 

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

Tipp: Das NORA | 360° Projekt agorum.smartorga enthält im Ordner ai/knowledge/agorum-core-development umfangreiche Wissensdateien. Diese Wissensdateien werden von ALBERT | AI verwendet. Sie können diese Informationen aber natürlich auch selbst lesen und bei Ihren Entwicklungen und Prompts berücksichtigen.

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 Developer Studio Workspace in einem neuen Tab öffnen

NORA | 360° mit Prompts entwickeln

Jetzt können Sie NORA | 360° direkt über natürlichsprachliche Prompts im Developer 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.

Die Schritte, die der Konfigurator von agorum.dev abdeckt, führt ALBERT | AI dabei selbst aus: Metadaten-YML ausführen, Übersetzungen einlesen sowie Cardlets und Decorators registrieren.

Achtung: Nach jeder Änderung am Projekt muss die NORA | 360° Konfiguration neu generiert und die Oberfläche neu geladen werden.

Manuelle Schritte nach der Erstellung

Nachdem ALBERT | AI alle Dateien erstellt hat, führen Sie für NORA | 360° Deklarationen folgende Schritte selbst aus:

  1. Klicken Sie mit der rechten Maustaste auf die declaration.js und wählen Sie NORA | 360° > Entwicklung > Deklaration registrieren.
  2. Laden Sie die Oberfläche neu (F5).
  3. Klicken Sie mit der rechten Maustaste auf die declaration.js und wählen Sie NORA | 360° > Entwicklung > Konfiguration generieren.

Beispiel-Prompts für die NORA-Entwicklung

Die folgenden Beispiele zeigen typische Prompts, mit denen Sie NORA | 360° im Developer 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