Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Es gibt viele Möglichkeiten, wie Sie Ihre Themen verwalten können. Copilot Studio enthält eine Themenprüfung, mit der Sie wissen können, ob in Ihren Themen Fehler auftreten. Sie können Themen aktivieren oder deaktivieren, damit sie Personen, die mit Ihrem Agenten chatten, nicht angezeigt werden. Sie können Themen auch duplizieren, um die Erstellung neuer Themen zu erleichtern.
Themenfehler anzeigen
Wenn Sie ein Thema speichern, meldet Copilot Studio alle Probleme im Thema.
- Fehler verhindern, dass Ihr Agent funktioniert. Sie müssen sie beheben, bevor Sie Ihren Agenten veröffentlichen können.
- Warnungen hindern Ihren Agent nicht daran, zu arbeiten, können aber dazu führen, dass einige Themen nicht wie erwartet funktionieren. Sie sollten Warnungen beheben, sobald Sie sie sehen.
Auf der Seite Themen sehen Sie in der Spalte Fehler, ob ein Thema Fehler hat und wenn ja, wie viele. Auf dieser Seite werden nur Fehler angezeigt, da diese im Gegensatz zu Warnungen verhindern, dass Ihr Agent funktioniert.
Öffnen Sie Ihr Thema von der Seite Themen aus.
Wählen Sie Themenprüfung auf der Symbolleiste aus.
Der Bereich Themenprüfung wird angezeigt und meldet Fehler und Warnungen für Ihr Thema.
Wählen Sie einen Fehler aus, um direkt zu dem Knoten zu wechseln, der den Fehler enthält.
Ein Thema aktivieren oder deaktivieren
Themen können den Status Ein oder Aus haben, um anzugeben, ob sie in einer Agentenkonversation verwendet oder ausgelöst werden können. Standardmäßig werden neue Themen mit dem Status Ein erstellt.
Um den Status eines Themas zu ändern, wechseln Sie zur Seite Themen und verwenden Sie den Umschalter für das gewünschte Thema.
Wenn ein Thema Ein eingeschaltet ist, wird es wie erwartet ausgelöst. Themen werden aufgrund ihrer Triggerausdrücke ausgelöst oder wenn ein anderes Thema darauf umleitet.
Wenn ein Thema deaktiviert ist:
- Das Thema-Symbol
wird grau mit einem Indikator. - Das Thema hat überhaupt keine Wirkung.
- Das Thema wird nicht ausgelöst, wenn Triggerausdrücke in einer Unterhaltung verwendet werden oder wenn ein anderes Thema darauf umleitet.
- Die Themenprüfung erkennt einen Fehler, wenn ein anderes Thema zu einem Off-Thema weitergeleitet wird.
- Wenn Sie einen Agenten veröffentlichen, werden alle Themen veröffentlicht, unabhängig davon, ob sie eingeschaltet oder ausgeschaltet sind.
Tipp
Schalten Sie ein Thema aus , um es in einem Entwurfsstatus zu bearbeiten. Behalten Sie den Status Aus bei, während Sie Änderungen an anderen Themen veröffentlichen, die bereit sind, live geschaltet zu werden.
Thema kopieren
Nachdem Sie einige Themen erstellt haben, können Sie ein vorheriges Thema als Basis beim Erstellen neuer Themen verwenden.
Auf der Themen-Seite wählen Sie die drei Punkte (...) neben Ihrem Themennamen aus und wählen Sie dann "Eine Kopie machen".
Dadurch wird ein Duplikat des ausgewählten Themas erstellt, wobei (Kopie) dem Namen hinzugefügt wird. Der gesamte Inhalt des Themas, z. B. die Beschreibung, die Triggerausdrücke und die gesamte Unterhaltung, wird in das neue Thema kopiert.
Um Verwechslungen mit dem ursprünglichen Thema, das dieselben Triggerausdrücke verwendet, zu vermeiden, sollten Sie das neue Thema vielleicht ausschalten.
Wenn Sie mit der Bearbeitung des neuen Themas fertig sind, schalten Sie es ein, um es zu testen. Wenn es fertig ist, veröffentlichen Sie das neue Thema.
Die Anzahl der Kopien eines Themas ist unbegrenzt. Jedes Thema hat seine eigene interne ID.
Thema umbenennen
Sie können die Werkzeugleiste der Bearbeitungsfläche verwenden, um ein Thema schnell umzubenennen. Wählen Sie in der Symbolleiste Themen und dann den Themennamen in der Liste aus. Wählen Sie auf der Themenseite den Themennamen aus, geben Sie einen neuen Namen ein und drücken Sie dann die Eingabetaste.
Wichtig
Vermeiden Sie die Verwendung von Punkten (.) in Ihren Themennamen. Es ist nicht möglich, eine Lösung zu exportieren, die einen Agenten mit Punkten im Namen eines seiner Themen enthält.
Zu anderem Thema umleiten
Um die Unterhaltung von einem Thema zu einem anderen zu verschieben, ohne von vorn beginnen zu müssen, fügen Sie einen Umleitungsknoten hinzu. Wenn die Unterhaltung das Ende des Zielthemas erreicht, wird sie standardmäßig im ursprünglichen Thema fortgesetzt. Sie können nach dem Umleitungsknoten nach Bedarf weitere Knoten einfügen.
Wählen Sie das Symbol
"Knoten hinzufügen" unter dem Knoten aus, nach dem der Übergang erfolgen soll, zeigen Sie auf die Themenverwaltung, und wählen Sie "Gehe zu einem anderen Thema" aus.Wählen Sie das Zielthema aus der Liste aus.
Übergeben Sie Variablen zwischen Themen, falls erforderlich. Wenn das Thema, zu dem Sie weiterleiten, Eingabevariablen erfordert oder Ausgabevariablen an das ursprüngliche Thema zurückgeben soll, geben Sie für jede Variable einen Wert ein bzw. wählen Sie einen aus.
Speichern Sie Ihr Thema, und verwenden Sie dann den Bereich Test-Agent , um zu bestätigen, dass Ihr Agent das Zielthema erfolgreich aufgerufen hat.
Überlegungen zum Unterhaltungszustand beim Erneuten Aufrufen von Themen
Wenn Ihr Thema Vorschaukarten, Bestätigungsaufforderungen und Connectoraktionen (z. B. das Erstellen eines Azure DevOps-Arbeitsauftrags) enthält, kann es nicht erneut in derselben Unterhaltung verwendet werden. Die erste Ausführung wird wie erwartet abgeschlossen, aber wenn Sie zum Anfang desselben Themas umgeleitet werden, könnte der Agenten-Orchestrator den vorhandenen Dialogstatus wiederverwenden und vorherige Bestätigungsschritte als bereits abgeschlossen betrachten. Daher kann die Ausführung nach der Vorschau beendet werden.
Durch das Löschen von Variablen oder das Umleiten an den Startknoten wird dieser Zustand nicht zurückgesetzt. Durch das Duplizieren des Themas wird ein neuer Dialogkontext erstellt, dieser Ansatz wird jedoch nicht für wiederholte Ausführungen skaliert. So umgehen Sie diese Einschränkung:
- Teilen Sie den Fluss in zwei Themen auf:
- Verwenden Sie ein übergeordnetes Thema (Schleife), um zu fragen, ob der Benutzer eine andere Arbeitsaufgabe erstellen möchte.
- Verwenden Sie ein untergeordnetes Thema (Ausführung), um die Datensammlung, Vorschau, Bestätigung und die Erstellung von Azure DevOps-Arbeitsaufgaben zu verwalten.
- Leiten Sie zwischen Themen um, um den Gesprächszustand zuverlässig zurückzusetzen.
Mit diesem Muster können Benutzer mehrere Arbeitsaufgaben innerhalb einer einzelnen Unterhaltung ohne Probleme erstellen.
Aktuelles Thema oder alle Themen beenden
Standardmäßig kehrt eine umgeleitete Unterhaltung am Ende des aufgerufenen Thema zum ursprünglichen Thema zurück. Um ein Thema zu verlassen oder die Unterhaltung zu beenden, verwenden Sie den Knoten Aktuelles Thema beenden oder den Knoten Alle Themen beenden.
Ein Aktuelles Thema beenden-Knoten beendet das aktuelle Thema. Wenn das aktuelle Thema von einem anderen Thema aufgerufen wird, kehrt die Unterhaltung sofort zum ursprünglichen Thema zurück. Dieser Knoten wird häufig in einer Bedingungsverzweigung verwendet. Ein Zweig verlässt das Thema frühzeitig, während ein anderer Zweig das aktuelle Thema fortsetzt.
Mit dem Knoten Alle Themen beenden werden alle aktiven Themen sofort beendet. Ihr Agent betrachtet die nächste Nachricht des Benutzenden als die erste Nachricht in einer neuen Unterhaltung.
Um den Benutzenden darüber zu informieren, dass die Unterhaltung beendet ist, fügen Sie vor dem Knoten Alle Themen beenden einen Knoten Unterhaltung beenden hinzu.
Viele der Systemthemen verwenden diese Knoten, um zu steuern, wie Konversationen enden oder neu beginnen. Erfahren Sie, wie Sie Systemthemen verwenden.
Tipp
Mit dem Knoten Alle Themen beenden werden globale Variablen weder gelöscht nocht zurückgesetzt. Zum Löschen globaler Variablen verwenden Sie zunächst den Knoten Alle Variablen löschen. Ein Beispiel hierfür finden Sie im Systemthema Reset Conversation in Copilot Studio.