Freigeben über

Grundlegendes zu Fehlercodes

  • Artikel

Wenn ein Agent während einer Konversation auf ein Problem stößt, antwortet er mit einer Nachricht, die einen Fehlercode für das spezifische Problem enthält, auf das er gestoßen ist. Benutzer des Agents sollten diesen Fehlercode an ihren Administrator weitergeben.

Wenn als Agentenentwickler ein Problem auftritt, während Sie den Testbereich zum Testen Ihres Agents verwenden, können Sie zusätzlich zum Fehlercode eine Meldung mit mehr Kontext zum Problem sehen. Alternativ können Sie den Bereich Themenprüfung verwenden, um Ihren Agent zuvalidieren.

Fehlerliste

Anmerkung

Der in einigen Fehlermeldungen verwendete Begriff Dialog bezieht sich auf ein Thema.

Fehlercode Beschreibung
ContentError Es gibt einen Fehler im Thema-Inhalt.
DataLossPreventionViolation Es ist ein Verstoß gegen Richtlinie zur Verhinderung von Datenverlust aufgetreten.
FlowActionException Fehler bei Cloud-Flow-Ausführung aufgetreten.
FlowActionBadRequest Eine an einen Cloud-Flow gestellte Anforderung war nicht wohlgeformt.
FlowActionTimedOut Die Ausführung eines Cloud-Flows dauerte mehr als 100 Sekunden und es kam zu einer Zeitüberschreitung.
InvalidContent Ungültiger Inhalt wurde zum Code-Editor hinzugefügt.
InfiniteLoopInBotContent Ein Knoten wurde zu oft ausgeführt.
LatestPublishedVersionNotFound Die veröffentlichte Version des Agents kann nicht abgerufen werden.
RedirectToDisabledDialog Ein Thema wird umgeleitet an ein deaktiviertes Thema.
RedirectToNonExistentDialog Ein Thema leitet weiter zu einem anderen Thema, das nicht mehr existiert.
SystemError Ein Systemfehler ist aufgetreten in Copilot Studio.

ContentError

Fehlermeldung: Dieser Fehler erzeugt dynamische Nachrichten basierend auf dem Kontext des Fehlers.

Lösung: Dies ist ein allgemeiner Fehler für Probleme im Zusammenhang mit dem Inhalt Ihres Agenten. Weitere Einzelheiten finden Sie in der Fehlermeldung.

Hierzu zählen folgende gängige Probleme:

  • Einem Knoten fehlen erforderliche Eigenschaften.
  • Mit dem Code-Editor wurde eine ungültige YAML-Datei hinzugefügt.
  • Eine Power Fx-Formel enthält einen Fehler.

DataLossPreventionViolation

Fehlermeldung: In dieser Umgebung müssen sich Benutzer anmelden, bevor sie den Agent verwenden können. Gehen Sie zu „Verwalten > Sicherheit > Authentifizierung“ und wählen Sie die Option, Benutzer zur Anmeldung aufzufordern.“

Lösung:

FlowActionException

Fehlermeldungen:

  • Es wurde keine Ausgabe von Flow {FlowName} ({FlowId}) empfangen, obwohl die Ausgabe gemäß der Agentendefinition erwartet wurde.
  • „Der Ausgabeparameter mit Name {ItemKey} auf Flow {FlowName} ({FlowId}) fehlt in den Antwortdaten. Aaktualisieren Sie den Flow, oder stellen Sie sicher, dass der Flow diesen Wert zurückgibt.“
  • „Der Ausgabeparameter mit Name {ItemKey} auf Flow {FlowName} ({FlowId}) fehlt im Ausgabeschema. Aktualisieren Sie den Flow.“

Auflösung:Prüfen Sie den Flow auf Fehler.

FlowActionBadRequest

Fehlermeldungen:

  • „Der Parameter mit dem Namen {KeyName} auf Flow {FlowName} ({FlowId}) wird als vom Typ {ItemTypeKind} deklariert. Dieser Typ wird beim Aufrufen von Power Automate nicht unterstützt. Derzeit werden nur Text, Boolean und Zahlen unterstützt.“
  • „Der Ausgabeparameter mit Name {ItemKey} auf Flow {FlowName} ({FlowId}) fehlt in der 'Flow aufrufen'-Aktion.“
  • „Der Parameter mit dem Namen {KeyName} im Flow {FlowName} ({FlowId}) wurde zum Typ {ResolveType} ausgewertet, erwarteter Typ {ExpectedType}.“
  • „Der Flow {FlowName} ({FlowId}) konnte nicht mit Antwortcode {ResponseCode} ausgeführt werden, Fehlercode: {FlowErrorCode}.“

Auflösung: Überprüfen Sie, ob der Basistyp aller Variablen, die Sie an den Flow übergeben, mit dem Typ des Parameters übereinstimmen.

FlowActionTimedOut

Fehlermeldung: Der Flow mit ID {FlowId} ist abgelaufen. Fehlercode: {FlowErrorCode}

Lösung:Überprüfen Sie den Cloud-Flow auf Fehler, um zu verstehen, warum die Ausführung des Cloud-Flows mehr als 100 Sekunden dauerte, bevor er an Ihren Agent zurückkehrte. Versuchen Sie, die Abfrage und die Daten, die Sie vom Backend-System zurückgeben, zu optimieren. Wenn ein Teil der Cloud-Flow-Logik weiterhin ausgeführt werden kann, nachdem ein Ergebnis an den Agent gesendet wurde, platzieren Sie diese Aktionen nach dem Schritt Werte zurückgeben an Copilot Studio in Ihrem Cloud-Flow.

InvalidContent

Fehlermeldung: Im Agent sind insgesamt {TotalComponents} Komponenten vorhanden, aber keine ist gültig.

Auflösung:Öffnen Sie den Code-Editor, um Probleme mit dem Inhalt zu überprüfen.

InfiniteLoopInBotContent

Fehlermeldung: „Aktion {DialogId}.{TriggerId}.{ActionId} wurde mehr als {MaxTurnCount} mal hintereinander ausgeführt. Dies zeigt einen Zyklus in der Ausführung des Dialogs an, und daher wird die Dialogausführung beendet.“

Auflösung: Stellen Sie sicher, dass das Thema richtig endet oder auf andere Themen verlinkt, die richtig enden, so wie das Systemthema Eskalieren.

LatestPublishedVersionNotFound

Fehlermeldung: Die neueste veröffentlichte Version des Agents kann nicht abgerufen werden.

Lösung:Veröffentlichen Sie den Agenten.

RedirectToDisabledDialog

Fehlermeldung: „Der Dialog mit ID {DialogId} ist in der Definition deaktiviert. Aktivieren Sie den Dialog, bevor Sie ihn verwenden.“

Lösung:Aktivieren Sie das Thema erneut oder entfernen Sie den Umleitungsknoten.

RedirectToNonExistentDialog

Fehlermeldung: „Der Dialog mit ID {DialogId} wurde in der Definition nciht gefunden. Bitte überprüfen Sie, ob der Dialog vorhanden ist und ob die ID korrekt ist.“

Auflösung:Erstellen Sie ein neues Thema, zu dem Sie umleiten möchten, oder entfernen Sie den Umleitungsknoten.

SystemError

Fehlermeldung: Dieser Fehler erzeugt keine Fehlermeldung.

Lösung:Wenden Sie sich an den Kundensupport.