Freigeben über


Grundlegendes zu Fehlercodes

Wenn ein Agent während einer Konversation auf ein Problem stößt, antwortet es mit einer Nachricht, die einen Fehlercode für das spezifische aufgetretene Problem enthält. Benutzer von Agent sollten diesen Fehlercode an ihr Administrator weitergeben.

Wenn als Agent-Hersteller beim Verwenden des Testbereichs zum Testen Ihres Agent ein Problem auftritt, wird Ihnen neben dem Fehlercode auch eine Meldung mit mehr Kontext zum Problem angezeigt. Alternativ können Sie das Themenprüfung Panel verwenden, um Ihr Agent zu validieren.

Fehlerliste

Anmerkung

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

Fehlercode Beschreibung
Inhaltsfehler 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.
FlowActionTimeout Die Ausführung eines Cloud-Flows dauerte mehr als 100 Sekunden und es kam zu einer Zeitüberschreitung.
Ungültiger Inhalt Ungültiger Inhalt wurde zum Code-Editor hinzugefügt.
InfiniteLoopInBotContent Ein Knoten wurde zu oft ausgeführt.
LetzteveröffentlichteVersionnichtgefunden Die veröffentlichte Version von Agent kann nicht abgerufen werden.
Umleitung zu deaktiviertem Dialog Ein Thema wird umgeleitet an ein deaktiviertes Thema.
Umleitung zu Nicht-ExistentDialog Ein Thema leitet weiter zu einem anderen Thema, das nicht mehr existiert.
Systemfehler In Copilot Studio ist ein Systemfehler aufgetreten.

ContentError

Fehlermeldung: Dieser Fehler erzeugt dynamische Meldungen basierend auf dem Fehlerkontext.

Lösung: Dies ist ein Sammelfehler für Probleme im Zusammenhang mit dem Inhalt Ihres Agent. 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: „Dieses Umgebung erfordert, dass sich Benutzer anmelden, bevor sie Agent verwenden können.“ Gehen Sie zu „Verwalten > Sicherheit > Authentifizierung“ und wählen Sie die Option, Benutzer zur Anmeldung aufzufordern.“

Auflösung:

FlowActionException

Fehlermeldungen:

  • „Vom Flow {FlowName} ({FlowId}) wurde keine Ausgabe empfangen, obwohl gemäß der Definition von Agent eine Ausgabe 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.“

Lösung:Überprüfen Sie den Ablauf 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}.“

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

FlowActionTimedOut

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

Lösung: Überprüfen Sie den Ablauf auf Fehler, um zu verstehen, warum die Ausführung von Cloud-Flow mehr als 100 Sekunden dauerte, bevor es zu Ihrem 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 weiter ausgeführt werden kann, nachdem ein Ergebnis an Agent gesendet wurde, platzieren Sie diese Aktionen nach den „Werte zurückgeben an Copilot Studio“ Schritt in Ihrem Cloud-Flow.

InvalidContent

Fehlermeldung: „Insgesamt sind {TotalComponents} Komponenten im Agent vorhanden, aber keine ist gültig.“

Lö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.“

Lösung: Stellen Sie sicher, dass Thema ordnungsgemäß endet und auf andere Themen verweist, die ordnungsgemäß enden, wie etwa Eskalation Systemthema.

LatestPublishedVersionNotFound

Fehlermeldung: „Die neueste veröffentlichte Version von Agent konnte nicht abgerufen werden.“

Lösung:Veröffentlichen Sie Agent.

RedirectToDisabledDialog

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

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

RedirectToNonExistentDialog

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

Lösung:Erstellen Sie ein neues Thema zur Weiterleitung oder entfernen Sie den Weiterleitungsknoten.

SystemError

Fehlermeldung: Dieser Fehler erzeugt keine Fehlermeldung.

Lösung:Wenden Sie sich an den Kundendienst.