Freigeben über

Grundlegendes zu Fehlercodes

  • Artikel

Wenn ein Agent während einer Unterhaltung auf ein Problem stößt, antwortet er mit einer Nachricht, die einen Fehlercode für das spezifische Problem enthält, mit dem er es zu tun hat. Benutzende des Agenten sollten diesen Fehlercode an ihre Fachkraft für die Administration weitergeben.

Wenn ein Problem auftritt, während Sie den Testbereich zum Testen Ihres Agenten verwenden, können Sie als Agenterstellender 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 Agenten kann nicht abgerufen werden.
OutgoingMessageSizeTooBig Ein Agent hat eine Nachricht gesendet, die zu groß zum Verarbeiten ist.
OpenAIRateLimitReached Die Kapazitätsgrenze des Agenten wurde erreicht.
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: Diese Nachricht ist ein allgemeiner Fehler für Probleme im Zusammenhang mit dem Inhalt Ihres Agenten. Weitere Details 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.

OutgoingMessageSizeTooBig

Fehlermeldung: „Größe der ausgehenden Nachricht zu groß.“

Lösung: Überprüfen Sie Ihre Knoten, um sicherzustellen, dass keiner davon eine Variable verwendet, die eine große Textmenge enthält, z. B. eine statische JSON.stringify()-Methode. Wenn diese Art von Methode verwendet wird oder eine andere Variable verwendet wird, die eine große Textmenge enthält, ändern Sie den Knoten so, dass nur der Teil des Texts übergeben wird, der erforderlich ist. Wenn Sie beispielsweise eine adaptive Karte verwenden, um Daten an ein anderes Thema zu übergeben, aktualisieren Sie die Variable so, dass nur die benötigte Eigenschaft übergeben wird.

Weitere Informationen finden Sie unter Grenzwerte für die maximale Größe von Kanaldatennachrichten bei der Verwendung von Copilot Studio in Omnichannel.

OpenAIRateLimitReached

Fehlermeldung: Ein Fehler ist aufgetreten.

Lösung: Die maximale Anzahl der generativen Antworten wurde erreicht. Überprüfen Sie Ihre Nachrichtenkapazität und öffnen Sie eine Supportanfrage, um Ihre Ratenbegrenzung für generative Antworten zu erhöhen.

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.