Inzicht krijgen in foutcodes

Artikel
01/08/2025

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

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

Foutenlijst

Opmerking

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

Foutcode	Omschrijving
ContentError	De inhoud van het onderwerp bevat een fout.
DataLossPreventionViolation	Er was een schending van gegevensverliespreventie.
FlowActionException	Er is een fout opgetreden bij het uitvoeren van een cloudstroom.
FlowActionBadRequest	Een verzoek gedaan aan een cloudstroom was onjuist.
FlowActionTimedOut	Een cloudstroom duurde meer dan 100 seconden met een time-out tot gevolg.
InvalidContent	Er is ongeldige inhoud toegevoegd aan de code-editor.
InfiniteLoopInBotContent	Een knooppunt is te vaak uitgevoerd.
LatestPublishedVersionNotFound	De gepubliceerde versie van de agent kan niet worden opgehaald.
RedirectToDisabledDialog	Een onderwerp wordt omgeleid naar een uitgeschakeld onderwerp.
RedirectToNonExistentDialog	Een onderwerp wordt omgeleid naar een ander onderwerp dat niet meer bestaat.
SystemError	Er is een systeemfout opgetreden in Copilot Studio.

ContentError

Foutmelding: deze fout produceert dynamische berichten op basis van de context van de fout.

Oplossing: 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 zich aanmelden voordat ze de 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 in de agent worden gebruikt, bevinden zich niet in dezelfde gegevensgroep. Lees Copilot Studioconnectors.
Een of meer connectoren die in de agent worden gebruikt, zijn geblokkeerd door de tenantbeheerder.

FlowActionException

Foutberichten:

"Er is geen uitvoer ontvangen van stroom {FlowName} ({FlowId}), ook al werd uitvoer verwacht volgens de agentdefinitie."
"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."

Oplossing:controleer de stroom op fouten.

FlowActionBadRequest

Foutberichten:

"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}."

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

FlowActionTimedOut

Foutmelding: "Er is een time-out opgetreden voor de stroom met id {FlowId}. Foutcode: {FlowErrorCode}"

Oplossing:controleer de stroom op fouten om inzicht te krijgen in waarom het langer dan 100 seconden duurde voordat de cloudstroom 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 de cloudstroom kan blijven draaien nadat een resultaat naar de agent is verzonden, plaatst u deze acties na de stap 'Waarde(n) retourneren aan Copilot Studio' in uw cloudstroom.

InvalidContent

Foutmelding: "Er zijn in totaal {TotalComponents} onderdelen aanwezig in de 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 het onderwerp correct eindigt en dat koppelingen naar andere onderwerpen correct eindigen, zoals het systeemonderwerp Escaleren.

LatestPublishedVersionNotFound

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

Oplossing:publiceer de agent.

RedirectToDisabledDialog

Foutmelding: "De dialoog met Id {DialogId} is uitgeschakeld in de definitie. Schakel de dialoog in voordat u deze gebruikt."

Oplossing:schakel het onderwerp opnieuw in of verwijder het knooppunt voor doorsturen.

RedirectToNonExistentDialog

Foutmelding: "De dialoog 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 sturen of verwijder het knooppunt voor doorsturen.

SystemError

Foutmelding: deze fout geeft geen foutbericht.

Oplossing:neem contact op met klantondersteuning.

Error	Botrespons	Oplossing
2000	"De gebruiker zit vast in een oneindige lus. Controleer of `{Topic Name}` een logische conclusie bereikt."	Zorg ervoor dat het onderwerp correct eindigt of dat wordt gelinkt naar andere onderwerpen die correct eindigen, zoals het systeemonderwerp Escaleren.
2001	"De botinhoud is ongeldig."	Controleer het 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 stroom op fouten en zoek naar mislukte uitvoeringen in de uitvoeringsgeschiedenis van de stroom.
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 om een nieuwe bot te configureren. 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	"Als u deze bot wilt gebruiken, publiceert u hem in Copilot Studio."	Als u deze bot wilt gebruiken, publiceert u hem in Copilot Studio.
2010	"We kunnen uw botinhoud niet ophalen."	Inhoud kan niet worden gevonden omdat deze is verwijderd. Zie Agenten maken en verwijderen om een nieuwe agent te configureren. 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 binnen 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 voor meer informatie over het verplichten van gebruikers om zich aan te melden Gebruikersverificatie configureren.
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 het onderwerp opnieuw in of verwijder het knooppunt voor doorsturen.
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 naar door te sturen of verwijder het knooppunt voor doorsturen.
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 klantondersteuning voor nadere details.
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