UML mit KI erzeugen

In zwei Dingen, und es sind die beiden, die am meisten Zeit kosten. Das erste ist das leere Blatt: acht Substantive einer Domäne zu benennen und auf eine Fläche zu setzen ist eine halbe Stunde Arbeit, die nichts hervorbringt, worüber jemand streiten würde, und ein Modell erledigt es in Sekunden. Das zweite ist Notation nachschlagen - welche Pfeilspitze Realisierung bedeutet, an welches Ende die Raute gehört, wie eine Multiplizität von 0..* neben 1 aussieht. Dieses Wissen steht in der Spezifikation, die Spezifikation steckt in den Trainingsdaten, und es sich zu merken war nie der interessante Teil der Arbeit.

Das Diagramm oben in diesem Artikel entstand aus einer zwei Sätze langen Beschreibung. Die Klassen stimmen, die Attribute sind plausibel, und wer die Domäne kennt, kann es lesen und über die Teile zu streiten beginnen, auf die es ankommt - und genau dafür ist ein erster Entwurf da.

Sie wiederholen sich über Modelle und über Prompts hinweg, denn darunter sind sie derselbe Fehlschlag: der Generator wählt die häufigste Antwort, und Ihr System ist nicht das häufigste System.

1. Komposition als Aggregation gezeichnet, oder als schlichte Assoziation. Die hohle Raute ist die sicher aussehende Wahl, also ist sie die, die zurückkommt. Sie ist auch die, die sagt, dass die Teile das Ganze überleben - eine Behauptung über Löschen und über Eigentum, die niemand geprüft hat.
2. Multiplizitäten standardmäßig eins-zu-viele. Ungefragt kommt fast jede Assoziation als 1 zu 0..* zurück. Manchmal stimmt das. Wenn nicht, ist es die Art von falsch, die bis ins Schema überlebt.
3. Schnittstellen für einzelne Implementierungen erfunden. Modelle haben sehr viel Enterprise-Java gelesen. Hat Ihre Domäne einen Zahlungsanbieter, ist ein «interface» IPaymentProvider im Entwurf Dekoration.
4. Ganz und gar die falsche Diagrammart.Fragen Sie nach Verhalten über die Zeit, und ein Klassendiagramm kommt zurück, weil Klassendiagramme die Trainingsdaten dominieren. War die Frage „was passiert, wenn die Zahlung fehlschlägt“, wollten Sie ein Sequenzdiagramm.

Keiner davon ist schwer zu beheben. Alle sind schwer zu bemerken, denn eine falsche Beziehungsart sieht genauso selbstsicher aus wie eine richtige, und das Diagramm ist so oder so aufgeräumt.

Drei Zutaten, und die dritte ist die, die man weglässt.

1. Benennen Sie die Diagrammart.„Ein Klassendiagramm“, nicht „ein UML-Diagramm“. Sind Sie unsicher, welche Art Sie wollen, ist das eine Modellierungsfrage, und die vierzehn Arten stehen hier.
2. Geben Sie ihm Ihre Substantive. Die Wörter, die Ihr Team ohnehin benutzt, so geschrieben, wie Ihr Code sie schreibt. Ein Modell, das BorrowRecord erfindet, wenn Sie Loan sagen, erzeugt ein Diagramm, das niemand auf irgendetwas abbilden kann.
3. Nennen Sie die Frage, die das Diagramm beantworten muss.„...das zeigt, was mit Ausleihen geschieht, wenn ein Exemplar ausgesondert wird.“ Das ist es, was aus einem plausiblen Bild eine prüfbare Aussage macht, und es ist der wertvollste Satz in jedem Prompt.

Gehen Sie das durch, bevor das Diagramm Ihren Bildschirm verlässt. Es bildet eins zu eins auf die vier Fehlschläge oben ab, und es ist der ganze Unterschied zwischen einem erzeugten Diagramm, das hilft, und einem, das ein Team ein Jahr lang still falsch informiert.

Zwei Minuten sind nicht übertrieben: bei einem Diagramm mit acht Kästen sind es vier Blicke. Was es funktionieren lässt, ist zu wissen, wonach Sie suchen - deshalb ist die Liste kurz und konkret statt „sorgfältig prüfen“.

Archyno erzeugt in ein Modell statt in ein Bild, und genau dieser Unterschied ist der Grund, warum dieser Artikel dort enden kann, wo er endet. Der KI wird dasselbe Metamodell übergeben, das der Editor durchsetzt, also kommen Elemente und Beziehungen zurück, die die Notation tatsächlich erlaubt - eine Realisierung kann nur auf einer Schnittstelle landen, eine ArchiMate-Bedienungsbeziehung nur die Ebenen verbinden, die die Spezifikation zulässt. Die Fehlerkategorien oben schrumpfen auf die, die kein Werkzeug fangen kann: die über Ihr System.

Weil es ein Modell ist und kein Bild, ist die Korrektur eine Bearbeitung statt eines neuen Prompts. Ändern Sie die Raute, ändern Sie die Multiplizität, benennen Sie die Klasse um - und die Umbenennung erreicht jede Sicht, auf der das Element vorkommt. Das Ergebnis exportiert als PNG, SVG, Mermaid, XMI oder als Sparx-.qea-Datei, und das macht aus einem erzeugten Diagramm etwas, das Sie einem Team geben können, das nicht dasselbe Werkzeug benutzt wie Sie.

Die ArchiMate-Hälfte davon - wo die Ebenenregeln Generierung zugleich schwerer und nützlicher machen - steht in ArchiMate-Diagramme mit KI erzeugen. Was das Werkzeug tut und was nicht, steht unverblümt in warum Archyno.