Compreender códigos de erro

Artigo
12/09/2024

Quando um agente encontra um problema durante uma conversa, ele responde com uma mensagem que inclui um código de erro para o problema específico encontrado. Os usuários do agente devem informar este código de erro ao seu administrador.

Como criador de agente, se ocorrer um problema ao usar o painel de teste para testar seu agente, você poderá ver uma mensagem com mais contexto sobre o problema, além do código de erro. Como alternativa, você pode usar o painel Verificador de tópico para validar seu agente.

Lista de erros

Observação

O termo caixa de diálogo usado em algumas mensagens de erro refere-se a um tópico.

Código de erro	Descrição
Erro de conteúdo	Há um erro no conteúdo do tópico.
Prevenção de Perda de DadosViolação	Ocorreu uma violação da política de prevenção contra perda de dados.
Exceção de ação de fluxo	Ocorreu um erro ao executar um fluxo da nuvem.
FluxoAçãoSolicitaçãoRuim	Uma solicitação feita para um fluxo da nuvem foi malformada.
FluxoAçãoTempoEsgotado	Um fluxo da nuvem levou mais de 100 segundos para ser executado e atingiu o tempo limite.
Conteúdo inválido	Conteúdo inválido foi adicionado ao editor de código.
InfiniteLoopInBotContent	Um nó foi executado muitas vezes.
ÚltimaVersãoPublicadaNãoEncontrada	Não foi possível recuperar a versão publicada do agente.
Redirecionar para caixa de diálogo desabilitada	Um tópico está redirecionando para um tópico desativado.
Redirecionar para caixa de diálogo não existente	Um tópico está redirecionando para outro tópico que não existe mais.
Erro de sistema	Ocorreu um erro de sistema em Copilot Studio.

ContentError

Mensagem de erro: Este erro produz mensagens dinâmicas com base no contexto do erro.

Resolução: Este é um erro geral para problemas relacionados ao conteúdo do seu agente. Consulte a mensagem de erro para obter mais detalhes.

Os problemas comuns incluem:

Um nó tem propriedades necessárias ausentes.
Um YAML inválido foi adicionado com o editor de código.
Uma fórmula do Power Fx contém um erro.

DataLossPreventionViolation

Mensagem de erro: "Este ambiente exige que os usuários efetuem login antes de poderem usar o agente. Vá para Gerenciar > Segurança > Autenticação e selecione a opção para solicitar que os usuários façam login."

Resolução:

As políticas de prevenção contra perda de dados (DLP) do seu ambiente exigem que os usuários façam login. Consulte Adicionar autenticação de usuário com o tópico do sistema de Entrada.
Um ou mais conectores usados no agente não estão no mesmo grupo de dados. Consulte Copilot Studioconectores.
Um ou mais conectores usados no agente estão bloqueados pelo administrador do locatário.

FlowActionException

Mensagens de erro:

"Nenhuma saída foi recebida do fluxo {FlowName} ({FlowId}), embora a saída fosse esperada conforme a definição de agente."
"O parâmetro de saída com o nome {ItemKey} no fluxo {FlowName} ({FlowId}) está ausente nos dados de resposta. Atualize o fluxo ou certifique-se de que o fluxo retorne esse valor."
"O parâmetro de saída com o nome {ItemKey} no fluxo {FlowName} ({FlowId}) está ausente no esquema de saída. Atualize o fluxo."

Resolução:Verifique se há erros no fluxo.

FlowActionBadRequest

Mensagens de erro:

"O parâmetro com nome {KeyName} no fluxo {FlowName} ({FlowId}) foi declarado ser do tipo {ItemTypeKind}. Não há suporte a esse tipo ao invocar o Power Automate. No momento, há suporte somente a Texto, Booliano e Números."
"O parâmetro com o nome {ItemKey} no fluxo {FlowName} ({FlowId}) está ausente na ação 'Fluxo de Chamadas'".
"O parâmetro com nome {KeyName} no fluxo {FlowName} ({FlowId}) avaliado para o tipo {ResolveType}. Tipo esperado {ExpectedType}."
"Houve falha na execução do fluxo {FlowName} ({FlowId}) com o código de resposta {ResponseCode}. Código de erro: {FlowErrorCode}."

Resolução: Verifique se o tipo base de quaisquer variáveis que você passa para o fluxo corresponde ao tipo do parâmetro.

FlowActionTimedOut

Mensagem de erro: "O fluxo com id {FlowId} expirou. Código de erro: {FlowErrorCode}"

Resolução:Verifique se há erros no fluxo para entender por que o fluxo da nuvem levou mais de 100 segundos para ser executado antes de retornar ao seu agente. Tente otimizar a consulta e os dados retornados do sistema de back-end. Se parte da lógica do fluxo da nuvem puder continuar a ser executada depois que um resultado for enviado ao agente, coloque essas ações após 'Retornar valores para Copilot Studio' etapa no seu fluxo da nuvem.

InvalidContent

Mensagem de erro: "Existem um total de {TotalComponents} componentes no agente, mas nenhum é válido."

Resolução:Abra o editor de código para revisar problemas com o conteúdo.

InfiniteLoopInBotContent

Mensagem de erro: "Ação {DialogId}.{TriggerId}.{ActionId} foi executada mais de {MaxTurnCount} vezes consecutivas. Isso indica um ciclo na execução do diálogo e, portanto, a execução do diálogo será encerrada."

Resolução: Certifique-se de que tópico termine corretamente e tenha links para outros tópicos que terminem corretamente, como o Escalate tópico do sistema.

LatestPublishedVersionNotFound

Mensagem de erro: "Não foi possível recuperar a última versão publicada do agente."

Resolução:Publicar o agente.

RedirectToDisabledDialog

Mensagem de erro: "O diálogo com Id {DialogId} está desabilitado na definição. Habilite o Diálogo antes de usá-lo."

Resolução:Reative o tópico ou remova o nó de redirecionamento.

RedirectToNonExistentDialog

Mensagem de erro: "O diálogo com Id {DialogId} não foi encontrado na definição. Verifique se o Diálogo está presente e se a ID está correta."

Resolução:Crie um novo tópico para redirecionar ou remova o nó de redirecionamento.

SystemError

Mensagem de erro: Este erro não produz uma mensagem de erro.

Resolução:Entre em contato com o suporte ao cliente.

Error	Resposta do bot	Resolução
2000	"O usuário fica preso em um loop infinito. Certifique-se de que `{Topic Name}` chega a uma conclusão lógica."	Certifique-se de que tópico termine corretamente ou que haja links para outros tópicos que terminem corretamente, como o Escalate tópico do sistema.
2001	"O conteúdo do bot é inválido."	Verifique se há erros no tópico.
2002	"Ocorreu um problema com o CDS."	Houve um problema ao acessar o Dataverse. Verifique se existem erros na sua configuração. Caso contrário, tente novamente mais tarde, pois pode haver um problema de serviço.
2003	"Há um problema com `{Flow Name}` em `{Topic Name}`. Verifique seu conteúdo."	Verifique se há erros no fluxo e procure por execuções com falha no histórico de execução do fluxo.
2004	"Há um problema com `{Skill Name}` em `{Topic Name}`. Verifique seu conteúdo."	Ocorreu um problema com a sua habilidade. Verifique se existem erros na habilidade e no tópico.
2005	"Encontramos um problema. Verifique seu conteúdo."	Houve um problema com o seu modelo de fluxo do Power Automate. Verifique se há erros no fluxo.
2006	"Não foi possível encontrar o bot."	Não foi possível encontrar seu bot porque o bot ou seu ambiente foi excluído. Para configurar um novo bot, consulte Criar e excluir agentes. Para configurar um novo ambiente, consulte Trabalhar com ambientes do Power Platform.
2007	"O bot contém muito conteúdo para funcionar."	Reduza o tamanho das mensagens ou o número de tópicos e tente novamente. Leia mais sobre limites de conteúdo.
2008	"Não foi possível localizar o token do usuário."	Verifique se existem erros na configuração de autorização do seu bot.
2009	"Para usar este bot, publique-o em Copilot Studio."	Para usar este bot, publique-o em Copilot Studio.
2010	"Não é possível recuperar o conteúdo do bot."	O conteúdo não foi encontrado porque foi excluído. Para configurar um novo agente, consulte Criar e excluir agentes. Para configurar um novo ambiente, consulte Trabalhar com ambientes do Power Platform.
2011	"Não foi possível encontrar o `{Skill Name}` em `{Topic Name}`. Verifique seu conteúdo."	A habilidade não foi encontrada porque foi excluída. Para criar uma nova habilidade, consulte Configurar uma habilidade do Bot Framework.
2012	"Não foi possível encontrar o `{Flow Name}` em `{Topic Name}`. Verifique seu conteúdo."	Seu fluxo do Power Automate não foi encontrado porque foi excluído. Para criar um novo fluxo, consulte Criar um fluxo.
2014	"O serviço de tradução não respondeu."	Tente novamente mais tarde. Se o problema persistir, contate o suporte da Microsoft.
2015	"Você não está autorizado a chamar `{Skill Name}`. Verifique se há problemas na habilidade e seu uso."	Verifique a configuração da sua habilidade e certifique-se de que seu bot tenha sido adicionado à lista de permissões da habilidade.
2016	"Não foi possível encontrar o bot."	Houve um problema com um Canal do serviço de bot do Azure. O canal pode ter sido excluído ou configurado incorretamente.
2017	"Não foi possível acessar o bot."	Não foi possível acessar o Canal do serviço de bot do Azure. Verifique se há problemas de autenticação na configuração do canal.
2018	"O usuário está digitando muito rápido."	Você enviou mensagens muito rápido. Leia mais sobre cotas e limites dentro Copilot Studio.
2019	"Não foi possível encontrar o seu ambiente. Talvez ele tenha sido excluído."	Seu ambiente foi excluído. Para configurar um novo ambiente, consulte Trabalhar com ambientes do Power Platform.
2020	"Algo aconteceu e `{Flow Name}` não está funcionando em `{Topic Name}`. Tente novamente mais tarde. Se o problema persistir, verifique a configuração do seu fluxo e o histórico de execução."	O fluxo do Power Automate não está funcionando. Tente novamente mais tarde. Se o problema persistir, verifique se existem erros no fluxo.
2021	"O número de caixas de diálogo executadas na ativação atual excede o máximo de `{Dialog Limit}`."	Por padrão, o número máximo de tópicos é 50. Reduza o número de tópicos e tente novamente.
2022	"O bot enviou mais de `{Message Limit}` mensagens nessa rodada."	Limite as mensagens por rodada a menos de 30.
2023	"Ocorreu um problema ao executar seu diálogo do Composer."	Verifique se há erros na caixa de diálogo do Compositor.
2024	"Este ambiente exige que os usuários façam login antes de usar o bot. Vá para Gerenciar > Segurança > Autenticação e selecione a opção para solicitar que os usuários façam login."	As políticas de prevenção contra perda de dados (DLP) do seu ambiente exigem que o usuário faça login. Para saber como exigir que os usuários efetuem login, consulte Configurar autenticação do usuário.
2025	"Há um ou mais nós vazios em um tópico `{Topic Name}`. Verifique seu conteúdo."	Adicione conteúdo aos nós vazios ou remova-os do tópico.
2025	"`{Topic Name}` está redirecionando para um tópico que foi desativado. Retorne ao `{Topic Name}` e verifique seu conteúdo."	Seu tópico está redirecionando para um tópico que foi desativado. Reative o tópico ou remova o nó de redirecionamento.
2025	"O tópico para o qual você está tentando redirecionar não existe mais. Retorne ao `{Topic Name}` e verifique seu conteúdo."	O tópico para o qual você está tentando redirecionar não existe mais. Crie um novo tópico para redirecionar ou remova o nó de redirecionamento.
2026	"Ocorreu um problema com o fluxo do Power Automate. Verifique seu conteúdo."	Verifique se há erros no fluxo.
2030	" Verificar o histórico de execução do fluxo do Power Automate e garantir que o fluxo tenha sido executado com êxito."
2101	"A conversa do usuário com o bot foi muito longa ou a mensagem do usuário foi muito longa."	Tente reiniciar a conversa com o bot ou usar uma mensagem mais curta.
2102	"O usuário enviou uma mensagem grande demais para ser processada."	Você enviou uma mensagem grande demais para ser processada. Encurte sua mensagem e tente novamente.
3000	"Erro Inesperado"	Ocorreu um erro do sistema. Entre em contato com o suporte ao cliente para obter mais detalhes.
3001	"O Power Automate não está disponível para seu fluxo `{Flow Name}` agora. Tente novamente mais tarde."	O Power Automate não está respondendo. Reinicie a conversa com seu bot e tente novamente. Se o problema persistir, contate o suporte da Microsoft.
3002	"Ocorreu um problema no Power Automate, e sua solicitação para o fluxo `{Flow Name}` não foi aceita. Tente novamente mais tarde."	Ocorreu um erro no Power Automate, e sua solicitação para o fluxo não foi aceita. Seu fluxo pode ter levado mais de 2 minutos para responder.
3003	"Há um problema de rede na conexão com seu fluxo `{Flow Name}`. Tente novamente mais tarde."	Tente novamente mais tarde. Se o problema persistir, contate o suporte da Microsoft.

Partilhar via