Inzicht krijgen in foutcodes

Artikel
12/09/2024

Wanneer een agent tijdens een gesprek een probleem tegenkomt, reageert deze met een bericht met een foutcode voor het specifieke probleem dat is opgetreden. Gebruikers van agent moeten deze foutcode doorgeven aan hun Beheerder.

Als maker van agent kunt u, als er een probleem optreedt wanneer u het testvenster gebruikt om uw agent te testen, naast de foutcode een bericht met meer context over het probleem zien. U kunt ook het paneel Onderwerpcontrole gebruiken om uw agent te valideren.

Foutenlijst

Notitie

De term dialoog die in sommige foutmeldingen wordt gebruikt, verwijst naar een onderwerp.

Foutcode	Omschrijving
Inhoudsfout	De inhoud van het onderwerp bevat een fout.
DataLossPreventionViolation	Er was een schending van gegevensverliespreventie.
FlowActionUitzondering	Er is een fout opgetreden bij het uitvoeren van een cloudstroom.
FlowActionSlechteAanvraag	Een verzoek gedaan aan een cloudstroom was onjuist.
FlowActionTimedOut	Een cloudstroom duurde meer dan 100 seconden met een time-out tot gevolg.
Ongeldigeinhoud	Er is ongeldige inhoud toegevoegd aan de code-editor.
InfiniteLoopInBotContent	Een knooppunt is te vaak uitgevoerd.
LaatsteGepubliceerdeVersieNietGevonden	De gepubliceerde versie van agent kan niet worden opgehaald.
Doorverwijzen naar uitgeschakelde dialoog	Een onderwerp wordt omgeleid naar een uitgeschakeld onderwerp.
Omleiden naar niet-bestaand dialoogvenster	Een onderwerp wordt omgeleid naar een ander onderwerp dat niet meer bestaat.
Systeemfout	Er is een systeemfout opgetreden in Copilot Studio.

ContentError

Foutmelding: Deze fout genereert dynamische berichten op basis van de context van de fout.

Resolutie: Dit is een algemene fout voor problemen met betrekking tot de inhoud van uw agent. Raadpleeg het foutbericht voor nadere details.

Dit zijn enkele veel voorkomende problemen:

Vereiste eigenschappen ontbreken in een knooppunt.
Er is ongeldige YAML toegevoegd met de code-editor.
Een Power Fx-formule bevat een fout.

DataLossPreventionViolation

Foutmelding: "Voor deze omgeving moeten gebruikers inloggen voordat ze agent kunnen gebruiken. Ga naar Beheren > Beveiliging > Verificatie en selecteer de optie om gebruikers te verplichten zich aan te melden."

Oplossing:

Het DLP-beleid (Data Loss Prevention) van uw omgeving vereist dat gebruikers zich aanmelden. Zie Gebruikersverificatie toevoegen met het systeemonderwerp Aanmelden.
Een of meer connectoren die worden gebruikt in agent, bevinden zich niet in dezelfde gegevensgroep. Lees Copilot Studioconnectors.
Een of meer connectoren die worden gebruikt in agent worden geblokkeerd door de tenant Beheerder.

FlowActionException

Foutmeldingen:

"Er is geen uitvoer ontvangen van stroom {FlowName} ({FlowId}), ook al werd er uitvoer verwacht volgens de definitie van agent."
"De uitvoerparameter met naam {ItemKey} in stroom {FlowName} ({FlowId}) ontbreekt in de responsgegevens. Vernieuw de stroom of zorg ervoor dat de stroom deze waarde retourneert."
"De uitvoerparameter met naam {ItemKey} in stroom {FlowName} ({FlowId}) ontbreekt in de uitvoerschema. Vernieuw de stroom."

Resolutie:Controleer de stroom op fouten.

FlowActionBadRequest

Foutmeldingen:

"De parameter met naam {KeyName} in stroom {FlowName} ({FlowId}) wordt verklaard van het type {ItemTypeKind} te zijn. Dit type wordt niet ondersteund bij het aanroepen van Power Automate. Momenteel worden alleen Tekst, Booleaanse waarden en Getallen ondersteund."
"De parameter met naam {ItemKey} in stroom {FlowName} ({FlowId}) ontbreekt in de actie 'Gegevensoproepstroom'."
"De parameter met naam {KeyName} in stroom {FlowName} ({FlowId}) is geëvalueerd als het type {ResolveType}, verwacht type {ExpectedType}."
"De stroom {FlowName} ({FlowId}) kon niet worden uitgevoerd met responscode {ResponseCode}, foutcode: {FlowErrorCode}."

Resolutie: Controleer of het basistype van alle variabelen die u aan de flow doorgeeft, overeenkomt met het type van de parameter.

FlowActionTimedOut

Foutmelding: "De stroom met id {FlowId} is verlopen. Foutcode: {FlowErrorCode}"

Oplossing:Controleer de flow op fouten om te begrijpen waarom cloudstroom meer dan 100 seconden nodig had om uit te voeren voordat deze terugkeerde naar uw agent. Probeer de query en de gegevens die u retourneert vanuit het backend-systeem te optimaliseren. Als een deel van de logica van cloudstroom kan blijven worden uitgevoerd nadat een resultaat naar agent is verzonden, plaatst u deze acties na de 'Waarden retourneren naar Copilot Studio' stap in uw cloudstroom.

InvalidContent

Foutmelding: "Er zijn in totaal {TotalComponents} componenten aanwezig in agent, maar geen enkele is geldig."

Oplossing:Open de code-editor om problemen met de inhoud te bekijken.

InfiniteLoopInBotContent

Foutmelding: "Actie {DialogId}.{TriggerId}.{ActionId} is meer dan {MaxTurnCount} keer achter elkaar uitgevoerd. Dit duidt op een cyclus in uitvoering van de dialoog en daarom zal de dialooguitvoering worden beëindigd."

Oplossing: Zorg ervoor dat onderwerp correct eindigt en dat er links zijn naar andere onderwerpen die correct eindigen, zoals de Escalate systeemonderwerp.

LatestPublishedVersionNotFound

Foutmelding: "Kan de laatst gepubliceerde versie van agent niet ophalen."

Resolutie:Publiceer de agent.

RedirectToDisabledDialog

Foutmelding: "Het dialoogvenster met id {DialogId} is uitgeschakeld in de definitie. Schakel de dialoog in voordat u deze gebruikt."

Oplossing:Schakel onderwerp opnieuw in of verwijder het omleidingsknooppunt.

RedirectToNonExistentDialog

Foutmelding: "Het dialoogvenster met id {DialogId} is niet gevonden in de definitie. Controleer of de dialoog aanwezig is en of de id correct is."

Oplossing:Maak een nieuwe onderwerp om naar door te verwijzen, of verwijder het doorverwijzingsknooppunt.

SystemError

Foutmelding: Deze fout genereert geen foutmelding.

Resolutie:Neem contact op met de klantenservice.

Error	Botrespons	Oplossing
2000	"De gebruiker zit vast in een oneindige lus. Controleer of `{Topic Name}` een logische conclusie bereikt."	Zorg ervoor dat onderwerp correct eindigt, of dat er links zijn naar andere onderwerpen die correct eindigen, zoals de Escalate systeemonderwerp.
2001	"De botinhoud is ongeldig."	Controleer de onderwerp op fouten.
2002	"Er is een probleem opgetreden met CDS."	Er is een probleem opgetreden bij het openen van Dataverse. Controleer uw configuratie op fouten. Probeer het anders later opnieuw, want er kan een serviceprobleem zijn.
2003	"Er is een probleem met `{Flow Name}` in `{Topic Name}`. Controleer uw inhoud."	Controleer de flow op fouten en zoek naar mislukte runs in de flow-rungeschiedenis.
2004	"Er is een probleem met `{Skill Name}` in `{Topic Name}`. Controleer uw inhoud."	Er is een probleem opgetreden met uw vaardigheid. Controleer zowel de vaardigheid als het onderwerp op fouten.
2005	"Er is een probleem opgetreden." Controleer uw inhoud."	Er is een probleem opgetreden met uw Power Automate-stroomsjabloon. Controleer de stroom op fouten.
2006	"We hebben uw bot niet gevonden."	Uw bot is niet worden gevonden omdat de bot of zijn omgeving is verwijderd. Zie Agenten maken en verwijderen voor het configureren van een nieuwe bot. Zie Werken met Power Platform-omgevingen om een nieuwe omgeving te configureren.
2007	"De bot bevat te veel inhoud om te kunnen werken."	Verkort de berichtlengte of het aantal onderwerpen en probeer het vervolgens opnieuw. Lees meer over inhoudslimieten.
2008	"We hebben het token van de gebruiker niet gevonden."	Controleer de autorisatieconfiguratie van uw bot op fouten.
2009	"Om deze bot te gebruiken, publiceer je deze in Copilot Studio."	Om bot te gebruiken, publiceer je deze in Copilot Studio.
2010	"We kunnen uw botinhoud niet ophalen."	Inhoud kan niet worden gevonden omdat deze is verwijderd. Zie Agenten maken en verwijderen voor het configureren van een nieuwe agent. Zie Werken met Power Platform-omgevingen om een nieuwe omgeving te configureren.
2011	"We hebben `{Skill Name}` in `{Topic Name}` niet gevonden. Controleer uw inhoud."	Vaardigheid kan niet worden gevonden omdat deze is verwijderd. Zie Een Bot Framework-vaardigheid configureren als u een nieuwe vaardigheid wilt maken.
2012	"We hebben `{Flow Name}` in `{Topic Name}` niet gevonden. Controleer uw inhoud."	Uw Power Automate-stroom kan niet worden gevonden omdat deze is verwijderd. Zie Een nieuwe stroom maken om een nieuwe stroom te maken.
2014	"De vertaalservice reageert niet."	Probeer het later nogmaals. Neem contact op met de klantondersteuning als het probleem zich blijft voordoen.
2015	"U bent niet gemachtigd om `{Skill Name}` aan te roepen. Controleer de vaardigheid en het gebruik ervan op eventuele problemen."	Controleer de configuratie van uw vaardigheid en zorg ervoor dat uw bot is toegevoegd aan de acceptatielijst van de vaardigheid.
2016	"Uw bot is helaas niet gevonden."	Er was een probleem met een Azure Bot-servicekanaal. Het kanaal is mogelijk verwijderd of onjuist geconfigureerd.
2017	"We hebben helaas geen toegang kunnen krijgen tot uw bot."	Er was geen toegang mogelijk tot het Azure Bot-servicekanaal. Controleer de kanaalconfiguratie op verificatieproblemen.
2018	"De gebruiker typt te snel."	U hebt te snel berichten verzonden. Lees meer over quota en limieten daarbinnen Copilot Studio.
2019	"We hebben uw omgeving niet gevonden. Deze is mogelijk verwijderd."	Uw omgeving is verwijderd. Zie Werken met Power Platform-omgevingen om een nieuwe omgeving te configureren.
2020	"Er is iets gebeurd en `{Flow Name}` werkt niet in `{Topic Name}`. Probeer het later nogmaals. Als het probleem zich blijft voordoen, controleert u de instellingen en uitvoeringsgeschiedenis van uw stroom."	Uw Power Automate-stroom werkt niet. Probeer het later nogmaals. Als het probleem aanhoudt, controleert u de stroom op fouten.
2021	"Het aantal dialoogvensters dat in de huidige weergave wordt uitgevoerd, overschrijdt het maximum van `{Dialog Limit}`."	Het maximale aantal onderwerpen bedraagt standaard 50. Verminder het aantal onderwerpen en probeer het vervolgens opnieuw.
2022	"De bot heeft meer dan `{Message Limit}` berichten verzonden."	Beperk het aantal berichten per keer tot minder dan 30.
2023	"Er is een probleem opgetreden bij het uitvoeren van uw Composer-dialoogvenster."	Controleer het Composer-dialoogvenster op fouten.
2024	"Deze omgeving vereist dat gebruikers zich aanmelden voordat zij de bot kunnen gebruiken. Ga naar Beheren > Beveiliging > Verificatie en selecteer de optie om gebruikers te verplichten zich aan te melden."	Het DLP-beleid (Data Loss Prevention) van uw omgeving vereist dat de gebruiker zich aanmeldt. Zie gebruikersverificatie configureren voor meer informatie over hoe u gebruikers kunt verplichten om in te loggen.
2025	"Het onderwerp `{Topic Name}` heeft een of meer lege knooppunten. Controleer uw inhoud."	Voeg inhoud toe aan lege knooppunten of verwijder ze uit het onderwerp.
2025	"`{Topic Name}` wordt omgeleid naar een onderwerp dat is uitgeschakeld. Ga terug naar `{Topic Name}` en controleer uw inhoud."	Uw onderwerp wordt omgeleid naar een ander onderwerp dat is uitgeschakeld. Schakel onderwerp opnieuw in of verwijder het omleidingsknooppunt.
2025	"Het onderwerp dat u probeert door te sturen, bestaat niet meer. Ga terug naar `{Topic Name}` en controleer uw inhoud."	Het onderwerp dat u probeert door te sturen bestaat niet meer. Maak een nieuwe onderwerp om door te verwijzen naar of verwijder de doorverwijzingsknoop.
2026	"Er is een probleem opgetreden met de Power Automate-stroom. Controleer uw inhoud."	Controleer de stroom op fouten.
2030	" Controleer Power Automate-uitvoeringsgeschiedenis van stromen en zorg ervoor dat de stroom met succes is uitgevoerd."
2101	"Het gesprek van de gebruiker met de bot was te lang of het bericht van de gebruiker was te lang."	Probeer het gesprek met de bot opnieuw te starten of een korter bericht te gebruiken.
2102	"De gebruiker heeft een bericht gestuurd dat te groot is om te verwerken."	U hebt een bericht gestuurd dat te groot is om te verwerken. Kort uw bericht in en probeer het opnieuw.
3000	"Onverwachte fout"	Er is een systeemfout opgetreden. Neem contact op met de klantenservice voor meer informatie.
3001	"Power Automate is nu niet beschikbaar voor uw stroom `{Flow Name}`. Probeer het later nogmaals."	Power Automate reageert niet. Start het gesprek met uw bot opnieuw en probeer het nogmaals. Neem, als het probleem zich blijft voordoen, contact op met de klantondersteuning.
3002	"Er is iets gebeurd in Power Automate en uw aanvraag voor uw stroom `{Flow Name}` is niet geaccepteerd. Probeer het later nogmaals."	Er is een fout opgetreden in Power Automate en de aanvraag voor uw stroom is niet geaccepteerd. Het heeft mogelijk meer dan twee minuten geduurd voordat uw stroom reageerde.
3003	"Er is een netwerkprobleem bij de verbinding met uw stroom `{Flow Name}`. Probeer het later opnieuw."	Probeer het later nogmaals. Neem contact op met de klantondersteuning als het probleem zich blijft voordoen.

Delen via