Formatierung im Chat

Antworten eines Agenten werden als Markdown (GitHub-Flavour) gerendert: Überschriften, Listen, Tabellen, Codeblöcke, Links. Darüber hinaus versteht der Chat zwei Container-Direktiven, mit denen ein Agent lange, strukturierte Antworten gliedern kann, ohne dass am Produkt etwas geändert werden muss — es genügt, sie im Systemprompt des Agenten zu erwähnen.

Beide Direktiven beginnen mit ::: am Zeilenanfang und werden von einer Zeile mit nur ::: geschlossen.

Einklappbare Abschnitte: ::: detail

::: detail Nachweise im Detail
| Nachweis | Fundstelle |
| --- | --- |
| Rentenverlauf | § 9 Abs. 2 Satz 1 Nr. 3 |
:::

Der Text nach dem Schlüsselwort ist die Überschrift, die immer sichtbar bleibt; der Rest ist eingeklappt und wird per Klick aufgedeckt. Ohne Überschrift steht dort Details. ::: details funktioniert genauso.

Das ist das Mittel für Antworten, die eine Zusammenfassung und die vollständige Begründung enthalten: Die Zusammenfassung bleibt lesbar, die Begründung ist einen Klick entfernt statt zwei Bildschirmseiten weiter unten.

Während der Agent noch schreibt, ist ein noch nicht geschlossener Abschnitt aufgeklappt — man sieht also zu, wie er entsteht — und klappt zu, sobald das schließende ::: eintrifft.

Hinweiskästen: ::: warning und Verwandte

::: warning Ungeprüfter Entwurf
Diese Auskunft ist maschinell erstellt und fachlich nicht freigegeben.
:::

Sieben Schlüsselwörter, vier Darstellungen:

Schlüsselwort	Darstellung
note, info	neutral
tip, success	grün
warning, caution	gelb
danger	rot

note und info bleiben absichtlich neutral: Ein Hinweis, der genauso laut ist wie die Warnung daneben, entwertet die Warnung.

Der Text nach dem Schlüsselwort ist ein optionaler Titel. Nutzen Sie einen Kasten für die eine Zeile, die nicht untergehen darf — einen Vorbehalt, eine offene Rückfrage, eine Frist. Nicht für jeden zweiten Absatz; ein Dokument aus lauter Kästen hat keine Hierarchie mehr.

Verschachtelung und Grenzen

• Container dürfen ineinander liegen (ein Hinweiskasten in einem ::: detail), bis zu acht Ebenen tief.
• Der Inhalt ist normales Markdown — Tabellen, Listen, Code, Zitate funktionieren darin unverändert.
• Innerhalb eines Codeblocks (```) wird nichts umgewandelt; ein Beispiel der Syntax bleibt ein Beispiel.
• Container müssen auf der äußersten Ebene stehen, nicht eingerückt in einem Listenpunkt.
• Ein unbekanntes Schlüsselwort (::: sidebar) bleibt als Text stehen, statt zu verschwinden.

Breite Tabellen

Eine Tabelle, die breiter ist als das Fenster, wird horizontal scrollbar, statt ihre Spalten zusammenzuquetschen. Spaltenköpfe werden nie mitten im Wort umbrochen. Trotzdem gilt: Auf einem Telefon sind drei bis vier Spalten das Maximum, das ohne Scrollen lesbar bleibt. Was in mehr Spalten möchte, gehört meistens in mehrere Zeilen oder in ein ::: detail.

Quellenangaben

Wenn ein Agent Wissen aus einem Wissensbestand nutzt, verweist er mit [1], [2] auf die gefundenen Stellen. Diese Marker werden zu anklickbaren Chips; bei einem PDF öffnet der Klick die Datei auf der zitierten Seite. Eine Angabe in Prosa ((Akte, Seite 47)) kann das nicht — sie bleibt Text, den man von Hand nachschlägt. Ein Agent, der auf Seiten verweisen soll, sollte deshalb die [n]-Marker verwenden.