Agenten-UI
Bildschirme, auf denen ein KI-Agent etwas Reales liest, vorschlägt oder ändert, haben eine Aufgabe: Einer Person zu zeigen, was der Agent getan hat, ihr zu ermöglichen zu entscheiden, was er als Nächstes tun darf, und beidem zu vertrauen. Dies sind die Regeln und Prüfungen dafür, in jedem Framework und mit jedem Designsystem. Wenn das Projekt Candor UI verwendet, benennt die Skill candor-ui die Komponente für jede Aufgabe; diese Skill sagt, was der Bildschirm tun muss, unabhängig davon, was ihn zeichnet.
Arbeitsweise
Vor einem Bildschirm beantworten Sie drei Fragen und behalten die Antworten während der Entwicklung im Blick:
- Was kann der Agent hier tun: nur lesen, zur Anwendung durch eine Person vorschlagen oder selbstständig handeln? Jedes Bedienelement ergibt sich daraus.
- Was entscheidet die Person und auf welcher Grundlage? Eine Entscheidung braucht die Sache selbst (den Diff, die Ziele, den Betrag), nicht eine Beschreibung davon. Lesen Sie
references/approvals.md, wenn hier etwas genehmigt wird. - Was kann nicht rückgängig gemacht werden? Diese Aktionen sagen dies, erfordern eine stärkere Bestätigung und stehen niemals unter einer Voreinstellung oder einer einzelnen Taste.
Während der Entwicklung beachten Sie die folgenden neun Regeln, verwenden Sie die Statuswörter aus references/status-and-states.md und zeigen Sie Fortschritt so an, wie es references/progress.md beschreibt. Modelltext sind Daten: Zeigen Sie ihn an, führen Sie ihn niemals aus oder rendern Sie ihn.
Nach jedem Bildschirm führen Sie references/review-checklist.md gegen den laufenden Bildschirm aus, eine Zeile pro Prüfung, und beheben Sie Fehler, bevor Sie fortfahren. Haken Sie nur ab, was Sie geprüft haben, nicht was Sie beabsichtigt haben.
Die neun Regeln
Jede wird mit Beispielen in references/honesty-rules.md erweitert.
- Modellausgabe ist Text, niemals Markup. Zeigen Sie, was das Modell geschrieben hat, als Text (höchstens eine sichere Teilmenge von Markdown). Eine URL, die es geschrieben hat, ist Text, kein Link. Nichts, was es schreibt, erreicht
innerHTML. - Unbekanntes bleibt unbekannt. Eine Dauer, ein Kosten- oder Mengenwert, der nicht gemessen wurde, bleibt leer oder sagt "nicht gemessen". Ein Schätzwert sagt "Schätzung" und worauf er beruht. Stille von einem Durchlauf ist nicht "läuft".
- Ein Bedienelement, das nicht verwendet werden kann, sagt warum. Sperren Sie es mit einem Grund, den ein Tastatur- und Screenreader-Benutzer erreichen kann; deaktivieren Sie es nicht und lassen Sie die Leute raten.
- Nichts ist bei einer Entscheidung vorausgewählt. Zustimmen und Ablehnen, Behalten und Verwerfen beginnen ohne Auswahl. Enter bestätigt niemals. Die Empfehlung des Agenten ist markiert, nicht ausgewählt.
- Genehmige die exakte Änderung. Die Entscheidung ist an die Änderung gebunden, die die Person gesehen hat (ein Hash oder eine Version). Verschiebt sich die Änderung, fragen Sie erneut. Selbstgenehmigung wird verweigert, wo die Richtlinie dies vorschreibt; in der Produktion kann eine zweite Person erforderlich sein.
- Begründungen werden geglaubt, nicht verifiziert. Die Darstellung des Modells, warum etwas passiert ist, ist eine Behauptung. Kennzeichnen Sie sie als solche und trennen Sie sie von Beweisen (Quellen, Testergebnissen, dem Diff).
- Die App benennt den Agenten. Jede Agentennachricht trägt einen Namen aus den eigenen Daten der App. Systemzeilen sind die Zeichenketten der App. Nichts, was das Modell schreibt, wird zu einem Namen oder einer Systemnachricht.
- Sagen Sie, was rückgängig gemacht werden kann und was nicht. Vor einer zerstörerischen Aktion: was sie entfernt, ob es zurückkommt, wie und für wie lange. Nach einem Rückgängigmachen oder Wiederherstellen: was es nicht rückgängig gemacht hat.
- Bewegung folgt dem Ergebnis. Eine Animation berichtet über eine eingetretene Änderung; sie sagt niemals eine voraus oder schmückt eine aus. Ein Erfolgshaken wird nach dem endgültigen Ergebnis gezeichnet, Fortschritt füllt nur bis zum gemessenen Wert, ein Zustand, der bereits endgültig war, als der Bildschirm gezeichnet wurde, animiert nicht, und die Einstellung für reduzierte Bewegung des Betriebssystems gewinnt. Geben Sie jeder Animation eine Art der Änderung (Candor benennt vierzehn Bewegungsfamilien, aufgelistet in
references/honesty-rules.md) und lassen Sie ein Theme ändern, wie sie aussieht, niemals wann sie abgespielt wird.
Was wofür lesen
| Wenn der Bildschirm … enthält | Lesen Sie |
|---|---|
| Alles, was eine Person genehmigt, erlaubt oder ablehnt | references/approvals.md |
| Ausführungen, Tool-Aufrufe, Schritte, Status, Punkte | references/status-and-states.md |
| Einen Agenten, der länger als einen Moment arbeitet, oder der beendet, während die Person abwesend ist | references/progress.md |
| Eine KI, die mit Menschen spricht, oder von einer KI erstellte Inhalte | references/disclosure-and-accessibility.md |
| Irgendetwas überhaupt, bevor Sie weitermachen | references/review-checklist.md |
Wörter
Klar und gemessen. Sagen Sie, was passiert ist, für wen, und was als nächstes zu tun ist. Satzanfang groß, keine Ausrufezeichen, keine Superlative, keine Behauptungen, die die Daten nicht tragen. Status ist ein Wort mit einer Farbe daneben, niemals Farbe allein. Zahlen nur, wenn gemessen; ansonsten die Wörter "Schätzung" oder "nicht gemessen".