Prompt-Editor

Der Prompt-Editor ist der Rich-Text-Bereich in Agent Builder, in dem Sie den System-Prompt und den Benutzer-Prompt schreiben. Argumente, Tools, Kontexte, Eskalationen und Ausgaben werden als farbcodierte Inline-Referenzen – Pills genannt – und nicht als eingegebene Platzhalter dargestellt.

Der Prompt-Editor ist für autonome Agents und Konversations-Agents verfügbar und gilt für den System-Prompt und den Benutzer-Prompt.

Der @-Trigger

Der Prompt-Editor verwendet einen einzigen Trigger-Schlüssel für alle Referenztypen.

Wenn Sie an einer beliebigen Stelle im Prompt @ eingeben, öffnet sich die Referenzauswahl. Die Auswahl gruppiert verfügbare Verweise in fünf Abschnitte in einer festen Reihenfolge:

1. Eingaben – Argumente, die der Agent zur Runtime erhält
2. Tools – Tools, die mit dem Agenten verbunden sind
3. Kontext – Kontextgrundlage-Quellen
4. Eskalationen – Eskalationspfade
5. Ausgaben – Ausgaben aus vorherigen Schritten, falls zutreffend

Wenn Sie die Eingabe nach @ fortsetzen, wird die Liste mithilfe von Fuzzy-Matching eingeschränkt – ein exaktes Präfix ist nicht erforderlich.Zum Beispiel @srchentspricht tools.web_search.

Tastaturnavigation in der Auswahl

Schlüssel	Aktion
↑ / ↓	Auswahl nach oben oder unten verschieben
Tab / Umschalt+Tab	Wie die Pfeiltasten
Enter	Den hervorgehobenen Verweis einfügen
Esc	Die Auswahl ohne Einfügen schließen
Mausauswahl	Die ausgewählte Referenz einfügen

Wenn @ die Auswahl nicht öffnet

Um eine unbeabsichtigte Aktivierung während der normalen Eingabe zu vermeiden, öffnet das @-Zeichen die Auswahl nur, wenn es wie folgt angegeben wird:

• am Anfang einer Zeile oder
• unmittelbar nach einem Leerzeichen.

Schreiben [e-mail] der Mitte eines Satzes öffnet die Auswahl nicht – @ bleibt als Klartext erhalten.Das Eingeben eines Leerzeichens vor @ erzwingt das Öffnen der Auswahl.

Kompatibilität mit {{ }} Platzhaltern

Vorhandene Prompts, die {{argument_name}} enthalten, funktionieren ohne Migrationsschritt weiter.Wenn der Editor einen Prompt lädt, werden {{ }} Platzhalter automatisch in Pills auf dem Bildschirm konvertiert. Wenn der Prompt gespeichert wird, werden Eingabepills als {{argument_name}} und Tool-, Kontext- und Ausgabepills als @{tools.search} in den Speicher zurückgeschrieben – wobei die Kompatibilität mit allen Backend-Systemen erhalten bleibt, die Prompts als Text lesen.

Das direkte Eingeben von {{ ... }} während der Bearbeitung ist kein Trigger für die Erstellung – es bleibt als Text erhalten und wird erst dann in eine Pille konvertiert, wenn der Prompt gespeichert und erneut geöffnet wird, vorausgesetzt, dass der innere Name mit einem vorhandenen Argument übereinstimmt.Verwenden Sie @ zum Einfügen von Verweisen.

Referenzen als Pillen

Jede Referenz in einem Prompt wird als Inline-Pill gerendert, die Folgendes enthält:

• ein Kategorie-Symbol
• eine Beschriftung – das letzte Segment des Referenzpfads (z. B. web_searchanstelle von tools.web_search)
• eine Farbe, die die Referenzkategorie widerspiegelt: Eingaben in Blau, Tools, Kontexte und Eskalationen in Grün, Ausgaben in Orange

Pills verhalten sich wie einzelne Einheiten:

• Pfeiltasten bewegen den Cursor mit einem Tastendruck über eine Pille hinweg.
• Backspace oder Löschen entfernt die gesamte Referenz.
• Jede Pille verfügt beim Daraufzeigen über eine ×-Schaltfläche zum Entfernen mit der Maus.
• Sie können Pillen in verschiedene Prompt-Felder desselben Agenten oder in die Prompts eines anderen Agenten kopieren und einfügen. Wenn Pills in ein Klar-Textziel außerhalb des Editors eingefügt werden, greifen sie auf das {{...}} oder @{...} Textformat zurück.

Ungültige Referenzen

Wenn ein Verweis auf eine Ressource verweist, die nicht mehr vorhanden ist – z. B. ein Tool, das entfernt wurde, oder ein Argument, das manuell umbenannt wurde – färbt sich die Pille rot. Dies ist nur ein visuelles Signal; der Prompt wird weiterhin so gespeichert, wie er ist.

Eine ungültige Referenz kann gelöst werden, indem Sie die rote Pille löschen und einen Ersatz mit @ auswählen, oder indem Sie die zugrunde liegende Ressource umbenennen, damit die Referenz wieder gültig wird.

Automatische Propagierung von Umbenennungen

Wenn ein Tool, ein Argument, ein Kontext, eine Eskalation oder eine Ausgabe in der Agentendefinition umbenannt wird, erkennt der Editor die Änderung und aktualisiert jede Pille, die darauf verwiesen hat, automatisch in allen Prompt-Feldern. Verschachtelte Pfade werden ebenfalls konsistent neu geschrieben.

Umbenennungen, die außerhalb der Agentendefinition vorgenommen werden, z. B. durch direktes Bearbeiten von Roh-JSON, werden nicht erkannt.

Bearbeiten und Vorschau

Die Symbolleiste oben im Editor enthält eine Schaltfläche zum Umschalten zwischen Bearbeiten / Vorschau.

• Bearbeiten – der Live-Bearbeitungsmodus für die Eingabe von Text, die Anwendung von Formatierung und das Einfügen von Verweisen.
• Vorschau – ein schreibgeschütztes Rendering des Prompts mit allen Pills und angewendetem Markdown.Verwenden Sie die Vorschau, um das endgültige Aussehen von langen oder stark formatierten Prompts zu überprüfen, bevor Sie sie speichern.

Das Wechseln zur Vorschau behält den aktuellen Entwurf bei. Das Wechseln zum Bearbeiten führt zum genauen Bearbeitungsstatus vor dem Wechsel zurück.

Symbolleiste zur Formatierung

Im Bearbeitungsmodus zeigt die Symbolleiste die folgenden Formatierungsaktionen an:

Schaltfläche	Auswirkung	Tastenkombination
H	Überschrift in der aktuellen Zeile umschalten	–
B	Den ausgewählten Text fett markieren	–
I	Den ausgewählten Text kursiv schreiben	–
</>	Inline-Code	–
Nummerierte Liste	Eine nummerierte Liste umschalten	–
Aufzählungsliste	Eine Aufzählungsliste umschalten	–
Rückgängig machen	Schritt zurück durch Bearbeitungen	Strg / ⌘ + Z
Wiederholen	Vorwärts durch Bearbeitungen gehen	Strg / ⌘ + Umschalt + Z

Markdown, das Sie über die Symbolleiste anwenden, wird wörtlich im gespeicherten Prompt beibehalten und mit vollständigem Markdown-Styling – einschließlich Überschriften, Listen, Code-Blöcken, Blockzitaten und Tabellen – im Vorschaufenster gerendert.Die Symbolleiste ist deaktiviert, während der Vorschaumodus aktiv ist.

Abdeckungshervorhebungen

Wenn nach dem Ausführen eines Auswertungssatzes Prompt-Abdeckungsdaten verfügbar sind, erscheint ein Abdeckung-Umschalter in der Symbolleiste.

Die Auswahl von Abdeckung schaltet den Editor in die Vorschau mit Inline-Highlights um, die anzeigen, welche Anweisungen im Prompt während der Auswertung ausgeführt wurden.Die Auswahl eines hervorgehobenen Abschnitts öffnet ein Popover mit einer Liste der spezifischen Auswertungsprozesse, die diesen abgedeckt haben.Die Schaltfläche ↻ neben dem Umschalter berechnet die Abdeckung neu, wenn sich der Prompt oder der Auswertungssatz geändert hat.

Der Wechsel zurück zur Bearbeitung deaktiviert die Abdeckungshervorhebung.

KI-Vorschläge überprüfen

Wenn Autopilot oder ein anderer KI-Assistant ein Neuschreiben Ihres Prompts vorschlägt, wechselt der Editor in den Diff-Modus:

• Entfernte Inhalte werden mit einer roten Durchstreichung angezeigt.
• Hinzugefügte Inhalte werden mit einer grünen Hervorhebung angezeigt.
• Der Editor ist schreibgeschützt, während die Diff angezeigt wird.

Zwei Schaltflächen erscheinen unten rechts im Editor: Akzeptieren ersetzt den Prompt durch die vorgeschlagene Version, und Ablehnen verwirft den Vorschlag und stellt das Original wieder her.Der Original-Prompt bleibt genau erhalten, bis eine dieser Schaltflächen ausgewählt ist.

Vollbildbearbeitung

Das Symbol zum Erweitern am rechten Ende der Symbolleiste öffnet den Editor in einem Vollbild-Modal. Dies ist nützlich für lange Prompts, bei denen der verfügbare Bildschirmplatz begrenzt ist. Im Modal vorgenommene Bearbeitungen bleiben erhalten, wenn das Modal geschlossen wird.

Barrierefreiheit

• Jede Symbolleistenschaltfläche ist mit Tab über die Tastatur erreichbar und enthält einen Tooltip und aria-label.
• Die Referenzauswahl ist vollständig tastaturgesteuert – das Einfügen einer Referenz erfordert keine Maus.
• Der Umschalter „Bearbeiten/Vorschau“ und der Umschalter „Abdeckung“ geben ihren Status über aria-pressed-Semantik bekannt.
• Der Editor teilt den Namen des aktiven Felds – z. B. „System-Prompt“ – durch seine ariaLabel-Konfiguration den Bildschirmlesern mit.

Häufig gestellte Fragen

Werden vorhandene Prompts nicht mehr funktionieren?

Nein. Der Editor liest und schreibt im selben Format wie zuvor – {{argument}} für Eingaben und @{path} für Tools, Kontexte und Ausgaben. Vorhandene Prompts öffnen sich automatisch als Pills. Es ist kein Migrationsschritt erforderlich.

Can I still type {{ to insert an argument?

Nein. {{ }} ist kein Erstellungs-Trigger im Editor mehr.Verwenden Sie @ stattdessen.Jeglicher während der Bearbeitung eingegebene {{ ... }} bleibt als Klartext erhalten und wird erst dann in eine Pille konvertiert, wenn Sie den Prompt speichern und erneut öffnen, sofern der innere Name mit einem vorhandenen Argument übereinstimmt.

Does the @ trigger conflict with email addresses or social handles?

Nein. Die Auswahl öffnet sich nur, wenn @ am Anfang einer Zeile oder direkt nach einem Leerzeichen erscheint, sodass [e-mail] in der Mitte eines Satzes als Nur-Text behandelt wird.

Was passiert, wenn ich ein Argument oder Tool umbenenne?

Der Editor erkennt Umbenennungen in der Agentendefinition und aktualisiert jeden Verweis über alle Prompts hinweg automatisch. Eine Referenz färbt sich nur rot, wenn die zugrunde liegende Ressource gelöscht oder ihr Pfad in einer Weise geändert wurde, die der Editor nicht ableiten konnte.

Kann ich den neuen Editor deaktivieren?

Der Prompt-Editor wird während der Einführung durch ein Funktions-Flag geschützt. Um während des Einführungsfensters zum vorherigen Editor zurückzukehren, wenden Sie sich an Ihren UiPath-Ansprechpartner.

Siehe auch

• Prompts – System-Prompts, Benutzer-Prompts und Anleitung zum Schreiben von Prompts
• Argumente definieren – Erstellen Sie Eingabe- und Ausgabeargumente und verweisen Sie in Prompts darauf