Mit ALBERT l AI Developer Studio arbeiten

Diese Dokumentation zeigt, wie Sie das Developer Studio öffnen, einen Workspace einrichten, Dateien bearbeiten und gemeinsam mit ALBERT | AI entwickeln. Eine durchgehende Anleitung führt vom neuen Konfigurationsprojekt bis zum ersten einfachen Projekt; am Ende finden Sie praxisnahe Anwendungsfälle mit Beispiel-Prompts.

Voraussetzung: Sie sind für das Developer Studio berechtigt (siehe ALBERT l AI Developer Studio berechtigen), und für die Arbeit mit ALBERT | AI ist ein Sprachmodell eingetragen (siehe ALBERT l AI Developer Studio konfigurieren).

Begriffe

Developer Studio öffnen

1. Öffnen Sie das Hauptmenü ≡.
2. Wählen Sie Development > Open Developer Studio.
   
   Ergebnis: Das Fenster Developer Studio öffnet sich. Ohne geöffneten Workspace sehen Sie die Startseite mit den Schaltflächen Neuen Workspace erstellen und Bestehenden Workspace öffnen. Ist ein Workspace geöffnet, trägt das Fenster seinen Namen: Developer Studio - <Workspace>.

Explorer mit Projekt und Ressourcen (links), Editor (Mitte), ALBERT | AI (rechts)

 

Kontextmenü eines Developer-Studio-Workspace in der Seitenleiste

Die Oberfläche

Workspace einrichten

Workspace erstellen

1. Klicken Sie auf der Startseite auf Neuen Workspace erstellen oder wählen Sie Datei > Neuer Workspace.
2. Geben Sie einen Namen für den Workspace ein, etwa den Namen des Projekts oder der Aufgabe.
3. Bestätigen Sie mit Speichern.
   
   Ergebnis: Der Workspace ist angelegt und geöffnet. Er ist noch leer.

Projekte und Ordner hinzufügen

1. Wählen Sie Datei > Projekte zum Workspace hinzufügen.
   Das Fenster Objekt-Auswahl listet alle Konfigurationsprojekte.
2. Grenzen Sie die Liste über das Feld Ergebnis in „Alles“ einschränken ein, etwa mit agorum.smartorga, und wählen Sie das Projekt aus. Sie können mehrere Projekte wählen.
3. Klicken Sie auf OK.
4. Für einen Ordner, der kein Projekt ist, wählen Sie Datei > Ordner zum Workspace hinzufügen und wählen den Ordner aus.
   
   Ergebnis: Die Projekte und Ordner erscheinen links im Explorer.

Workspace verwalten

Neue Workspaces legt das Developer Studio in Ihren eigenen Dateien an. Ein Workspace gehört deshalb einem Benutzer; mehrere Entwickler arbeiten am selben Projekt jeweils in ihrem eigenen Workspace. Die Einstellungen eines Workspace – geöffnete Dateien, ausgewählte Datei – speichert das Developer Studio automatisch. Wird derselbe Workspace in einem anderen Fenster geändert, fragt es, ob Sie ihn neu laden möchten.

Dateien bearbeiten

• Öffnen: Ein Klick auf eine Datei, die das Developer Studio selbst bearbeiten kann (siehe Editoren), zeigt sie in einer vorläufigen Registerkarte (grauer Punkt am Symbol). Wählen Sie danach eine andere Datei, ersetzt sie diese Registerkarte. Ein Doppelklick oder die erste Änderung macht die Registerkarte dauerhaft.
• Editoren: JavaScript-Dateien (.js) öffnen sich im Skript-Editor, Markdown-Dateien (.md) im Markdown-Editor, Dateien wie .yml, .json, .properties, .xml, .css, .txt oder .svg im Texteditor. Andere Dateien öffnet das Developer Studio so, wie agorum core sie sonst auch öffnet.
• Speichern: Strg+S oder die Schaltfläche Save über dem Editor speichert die aktive Datei. Ungespeicherte Änderungen erkennen Sie am orangefarbenen Punkt am Symbol der Registerkarte.
• Registerkarten schließen: Klicken Sie mit der rechten Maustaste auf eine Registerkarte. Sie können Alle speichern, den aktiven Editor, alle anderen, alle links oder rechts davon oder alle Editoren schließen.
• Änderungen von außen: Ändert jemand – etwa ALBERT | AI – eine geöffnete Datei, lädt das Developer Studio sie automatisch neu. Haben Sie in der Datei selbst noch ungespeicherte Änderungen, fragt es vorher, ob Sie die Datei neu laden möchten. Eine gelöschte Datei wird geschlossen.
• Neue Datei, neuer Ordner: Wählen Sie im Explorer den Zielordner und dann Datei > Neue Datei bzw. Neuer Ordner oder das Symbol in der Symbolleiste. Eine neue Datei braucht eine Dateiendung, etwa .js.

Im Workspace suchen

Wechseln Sie links in den Reiter Suche und geben Sie einen Suchbegriff ein. Gesucht wird in allen Projekten und Ordnern des Workspace. Ein Ordner im Ergebnis wird im Explorer angezeigt, eine Datei im Editor geöffnet.

Mit ALBERT | AI entwickeln

Jeder Workspace hat einen eigenen Chat mit ALBERT | AI; das Developer Studio legt ihn beim ersten Öffnen des Workspace an. ALBERT | AI arbeitet mit der KI-Voreinstellung Developer Studio und kennt laufend

• die Projekte und Ordner des Workspace,
• die geöffneten und die im Explorer ausgewählten Dateien und Ordner,
• die installierte Version von agorum core,
• das Entwicklungswissen von agorum core und das Projektwissen der Projekte im Workspace (siehe ALBERT l AI Developer Studio anpassen).

So arbeitet ALBERT | AI im Developer Studio:

• Erst nachschlagen, dann umsetzen. ALBERT | AI liest vor jeder Umsetzung im Wissen und in der Dokumentation nach und nennt die Quellen.
• Nur im Workspace schreiben. Dateien anlegen, ändern, verschieben oder löschen darf ALBERT | AI nur in den Projekten und Ordnern des Workspace. Muss etwas außerhalb geändert werden, nennt ALBERT | AI das Ziel und fragt Sie vorher ausdrücklich. Lesen darf ALBERT | AI überall.
• Aufgabendatei. Bei jeder Aufgabe legt ALBERT | AI im Workspace-Ordner des Projekts eine Datei agents-<Workspace-ID>.md an, mit Ihrem Auftrag, den Arbeitsschritten und den verwendeten Quellen. So verliert ALBERT | AI auch bei langen Aufgaben nicht den Faden.
• Spezifikation bei größeren Aufgaben. Betrifft eine Aufgabe mehrere Komponenten oder sind Fragen offen, schreibt ALBERT | AI zuerst eine Spezifikation (doc/specs/spec-<Thema>.md im Projekt) und wartet auf Ihre Freigabe. Sie können das auch ausdrücklich verlangen: „Erstelle eine Spec.“
• Konfigurieren statt von Hand registrieren. Projekte anlegen, aguila-Widgets, Services oder Filter registrieren, YML-Dateien ausführen und Übersetzungen einlesen erledigt ALBERT | AI über die Werkzeuge des Konfigurators von agorum.dev (siehe Werkzeuge von ALBERT | AI).
• Prüfen und testen lassen. ALBERT | AI lässt den erstellten Code von einem eigenen QS-Agenten prüfen und schreibt und führt Autotests aus, wo sie nötig sind.

Tipps für gute Ergebnisse

• Ein Chat pro Aufgabe. Starten Sie für jede neue Aufgabe einen neuen Chat. Ein frischer Chat arbeitet ohne Altlasten und zuverlässiger.
• Kontext zeigen. Öffnen Sie die Dateien, um die es geht, und wählen Sie das Projekt im Explorer aus – ALBERT | AI sieht beides.
• Konkret formulieren. Nennen Sie Dateinamen, Feldnamen, Datentypen, Auswahlwerte und das gewünschte Verhalten.
• Erst planen, dann umsetzen. Lassen Sie bei größeren Vorhaben zuerst einen Plan oder eine Spec erstellen und prüfen Sie ihn, bevor ALBERT | AI umsetzt.
• Logik vor Oberfläche. Lassen Sie die Fachlogik als Bibliothek mit Autotest bauen und binden Sie sie erst danach in Masken, Workflows oder Services ein. Bibliotheken lassen sich automatisch testen, Oberflächen kaum.
• Zusammengehöriges bündeln. Beschreiben Sie Bibliothek, Autotest und Maske – oder Metadaten und Ordnerstruktur – in einem Prompt, damit ALBERT | AI alles einheitlich benennt.
• Bei Fehlern messen lassen. Beschreiben Sie, was Sie beobachten und was Sie erwarten. ALBERT | AI baut dann gezielt Protokollausgaben ein, statt zu raten.

Anleitung: Neues Konfigurationsprojekt anlegen und umsetzen

Diese Anleitung führt einmal durch den ganzen Ablauf: Sie legen ein neues Konfigurationsprojekt an, richten dafür einen Workspace ein und setzen mit ALBERT | AI ein einfaches Projekt um. Als Beispiel dient eine Vertragsablage für die fiktive Firma Musterfirma GmbH.

Schritt 1: Workspace erstellen

1. Öffnen Sie das Developer Studio über ≡ > Development > Open Developer Studio.
2. Wählen Sie Neuen Workspace erstellen und geben Sie als Namen Vertragsablage ein.
3. Klicken Sie auf Speichern.
   
   Ergebnis: Der leere Workspace ist geöffnet, rechts steht der Chat mit ALBERT | AI bereit.

Schritt 2: Konfigurationsprojekt anlegen

Ein neues Projekt legt ALBERT | AI über den Konfigurator von agorum.dev an. Der Konfigurator bildet Projektname, Beschreibung und Metadaten-Präfix nach festen Regeln aus Ihren Angaben und legt die Grundstruktur an: project.yml, export.yml, Projektbeschreibung und Sprachdateien.

Halten Sie diese Angaben bereit:

1. Bitten Sie ALBERT | AI im Chat, das Projekt anzulegen, zum Beispiel:

   Lege ein neues Kunden-Projekt an: Kunde "Musterfirma GmbH", Kürzel musterfirma, Projektname contracts, Titel "Musterfirma Vertragsablage".

2. ALBERT | AI nennt Ihnen den Projektnamen – im Beispiel musterfirma.contracts – und fragt, ob das Projekt angelegt werden soll. Das Projekt entsteht außerhalb des noch leeren Workspace, deshalb ist Ihre Zustimmung nötig. Bestätigen Sie.
3. Wählen Sie Datei > Projekte zum Workspace hinzufügen, suchen Sie musterfirma.contracts und wählen Sie es aus.
   
   Ergebnis: Das neue Projekt erscheint links im Explorer, mit den Ordnern yml, doc und deploy (darin die Sprachdateien). Ab jetzt darf ALBERT | AI darin schreiben.

Schritt 3: Anforderung beschreiben und eine Spec erstellen lassen

1. Wählen Sie das Projekt musterfirma.contracts im Explorer aus.
2. Beschreiben Sie im Chat, was entstehen soll, und schließen Sie mit „Erstelle eine Spec.“, zum Beispiel:

   Im Projekt musterfirma.contracts soll eine einfache Vertragsablage entstehen:
   - Metadaten für Verträge: Vertragsnummer (Text, Pflicht), Vertragspartner (Text, Pflicht),
     Vertragsart (Auswahl: Wartung, Miete, Lizenz, Sonstiges), Vertragsbeginn (Datum),
     Vertragsende (Datum), Kündigungsfrist in Monaten (Zahl)
   - eine Metadaten-Sammlung "Vertrag" mit diesen Feldern
   - eine Ordnerstruktur unter /agorum/roi/Files/Verträge mit den Unterordnern Aktiv und Archiv
   - Schreibe Autotests für die Metadaten und führe sie aus.
   Erstelle eine Spec.

3. ALBERT | AI legt die Spezifikation im Projekt unter doc/specs/ an. Öffnen Sie sie im Explorer, lesen Sie sie und beantworten Sie die offenen Fragen – im Chat oder direkt im Abschnitt Antworten der Spec.
4. Geben Sie die Spec frei, etwa mit „Die Spec passt, bitte umsetzen.“
   
   Ergebnis: Die Spec beschreibt Anforderungen, betroffene Dateien und Vorgehen, alle offenen Fragen sind geklärt.

Schritt 4: Umsetzen lassen und Ergebnis prüfen

ALBERT | AI setzt die Spec um: Es schreibt metadata.yml, metadata-collection.yml und structure-basis.yml, trägt Texte in die Sprachdateien ein, führt die YML-Dateien über den Konfigurator aus, lässt das Ergebnis vom QS-Agenten prüfen und führt die Autotests aus. Zum Schluss fasst ALBERT | AI zusammen, was entstanden ist und welche Quellen verwendet wurden.

1. Prüfen Sie die Zusammenfassung und die geänderten Dateien im Explorer.
2. Laden Sie die agorum core Oberfläche neu (F5), damit neue Metadaten und Texte überall sichtbar werden.
3. Prüfen Sie das Ergebnis wie ein Anwender: Legen Sie im Ordner Verträge/Aktiv ein Dokument ab und vergeben Sie die neuen Metadaten.
4. Wünschen Sie Änderungen, beschreiben Sie sie im selben Chat. Für die nächste, neue Aufgabe – etwa eine Erfassungsmaske – starten Sie einen neuen Chat.
   
   Ergebnis: Ihr Projekt musterfirma.contracts enthält eine lauffähige Vertragsablage mit Autotests. Um es auf ein anderes System zu bringen, lässt sich das Projekt exportieren – auch das erledigt ALBERT | AI auf Wunsch über den Konfigurator.

Praxisnahe Anwendungsfälle

Die folgenden Beispiele zeigen typische Aufgaben im Developer Studio. Passen Sie Namen und Anforderungen an Ihr Projekt an und starten Sie jede Aufgabe in einem neuen Chat.

Erstelle im aktuell geöffneten Projekt eine lib zur Umrechnung von Distanzen
(m, km, Meilen, Yards, Fuß). Mache einen Autotest für diese lib und führe ihn aus.
Erstelle dann eine Maske mit Eingabefeld für den Wert, Auswahl für Quell- und
Zieleinheit, Button "Umrechnen" und Ausgabefeld. Verwende die lib.
Nenne Maske und lib distance-converter, den Autotest test-distance-converter.

Erstelle eine Maske sample-metadata-edit.js, die als Widget registriert wird.
Sie bekommt die ID eines Dokuments und zeigt dessen Metadaten
musterfirma_contracts_number und musterfirma_contracts_end zum Bearbeiten,
rechts daneben das Dokument. Unten links "Abbruch", unten rechts "Speichern".
Erstelle einen Autotest für die Maske und teste das Ergebnis.

Erstelle einen Workflow freigabe-workflow: Er startet immer mit einem Anhang.
Zuerst wählt der Starter einen Benutzer für die Freigabe (Weiter nur mit Auswahl,
Abbruch). Der Benutzer sieht ein Pflicht-Textfeld und die Buttons "Freigegeben",
"Gesperrt" und "Abbruch". Bei "Freigegeben" wird der Anhang nach
/agorum/roi/Files/WF/freigegeben verschoben, sonst endet der Workflow.
Unterstütze einen Debug-Modus, der bei Testläufen die Anhänge kopiert.

Im Projekt musterfirma.contracts: Erstelle eine Tracking-Datei doc/translations.md,
trage jede Datei des Projekts ein und prüfe Datei für Datei, ob sie Texte enthält,
die übersetzt werden müssen. Aktualisiere die Tracking-Datei nach jeder Prüfung.

Nimm doc/translations.md und arbeite alle markierten Dateien ab: Schlüssel anlegen,
in die Sprachdateien eintragen, in der Tracking-Datei als erledigt markieren.

Erweitere den NORA-Objekttyp "Projekt" in meinem Projekt musterfirma.nora um ein
Feld "Projektstatus" (Anfrage, Angebot, In Durchführung, Abgeschlossen), Standardwert
Anfrage, farbig in der Card-Ansicht. Erstelle eine Spec.

Beim Speichern in der geöffneten Maske kommt keine Meldung und die Metadaten
bleiben leer. Erwartet: Meldung "Gespeichert" und gesetzte Metadaten.
Baue Protokollausgaben ein, damit wir die Ursache finden.

Welche aguila-Widgets, Services und YML-Dateien hat das Projekt musterfirma.contracts
registriert? Gibt es Registrierungen, deren Skript nicht mehr existiert?

Erstelle eine Übersicht über das Projekt musterfirma.contracts und speichere sie im
Projektwissen. Halte dort auch fest: Alle Oberflächentexte nur über
Übersetzungsschlüssel.

Werkzeuge von ALBERT | AI

ALBERT | AI arbeitet im Developer Studio mit der Werkzeuggruppe agorum_dev_studio_development_tools. Sie enthält unter anderem Werkzeuge zum Lesen und Schreiben von Dateien, für Wissen und Dokumentation, zum Lesen der MetaDB, für die Suche nach Icons, zum Ausführen von Autotests und die Werkzeuge des Konfigurators von agorum.dev. Die Werkzeuge aus agorum.ai.dev sind einzeln beschrieben: