Compreender códigos de erro

2025-07-01

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 fornecer esse código de erro ao seu administrador.

Como criador de agentes, se ocorrer um problema quando você estiver usando o painel de teste para testar o 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.

Observação

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

Código de erro	Description
AsyncResponsePayloadTooLarge	Há um erro relacionado à saída de um conector.
ContentError	Há um erro no conteúdo do tópico.
DataLossPreventionViolation	Ocorreu uma violação da política de prevenção contra perda de dados.
EnforcementMessageC2	Não havia capacidade pré-paga suficiente disponível.
FlowActionException	Ocorreu um erro ao executar um fluxo da nuvem.
FlowActionBadRequest	Uma solicitação feita para um fluxo da nuvem foi malformada.
FlowActionTimedOut	Um fluxo da nuvem levou mais de 100 segundos para ser executado e atingiu o tempo limite.
GenAISearchandSummarizeRateLimitReached	O limite de uso da IA gerativa foi atingido.
GenAIToolPlannerRateLimitReached	O limite de uso para orquestração generativa foi atingido.
InvalidContent	Conteúdo inválido foi adicionado ao editor de código.
InfiniteLoopInBotContent	Um nó foi executado muitas vezes.
LatestPublishedVersionNotFound	Não foi possível recuperar a versão publicada do agente.
TamanhoDaMensagemDeSaídaMuitoGrande	Uma mensagem enviada por um agente é muito grande para ser processada.
MuitaDadosParaLidar	A solicitação feita pelo usuário é muito grande para ser processada.
OpenAIRateLimitReached	O limite de capacidade do agente foi atingido.
RedirectToDisabledDialog	Um tópico está redirecionando para um tópico desativado.
RedirectToNonExistentDialog	Um tópico está redirecionando para outro tópico que não existe mais.
SystemError	Ocorreu um erro no sistema no Copilot Studio.

AsyncResponsePayloadTooLarge

Mensagem de erro: A saída retornada do conector era muito grande para ser manipulada pelo agente. Tente reduzir seu tamanho utilizando filtros de conector disponíveis ou limitando o número de saídas de ação configuradas.

Resolução: um dos conectores em tempo real do agente está retornando um conteúdo maior do que o agente consegue processar. Para obter mais informações sobre o limite de carga, consulte os limites de aplicativo Web do Copilot Studio.

ContentError

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

Resolução: esta mensagem é um erro genérico para problemas relacionados ao conteúdo do agente. A mensagem de erro fornece 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: Esse ambiente exige que os usuários entrem antes que possam usar o agente. Vá para Gerenciar > Autenticação de Segurança > e selecione a opção que exige que os usuários entrem.

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 Conectores do Copilot Studio.
Um ou mais conectores usados no agente foram bloqueados pelo administrador do locatário.

EnforcementMessageC2

Mensagem de erro: Este agente está indisponível no momento. Ele atingiu seu limite de uso. Tente novamente mais tarde.

Resolução: Esta mensagem é retornada quando um agente atinge a capacidade de mensagem ou o medidor de pagamento conforme o uso atinge o limite. Adicione mais capacidade pré-paga ou crie um plano de cobrança pago conforme o uso. Dentro de 5 minutos, o chat do agente funcionará novamente. Para obter mais informações, acesse Overage Enforcement.

FlowActionException

Mensagens de erro:

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

Resolução:verifique o fluxo em busca de erros.

FlowActionBadRequest

Mensagens de erro:

O parâmetro com o nome {KeyName} no fluxo {FlowName} ({FlowId}) é declarado como do tipo {ItemTypeKind}. Este tipo não é compatível durante a invocação do Power Automate. Atualmente, há suporte apenas para Texto, Booleano 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 chamado {KeyName} no fluxo {FlowName} ({FlowId}) foi avaliado como do tipo {ResolveType}, sendo o tipo esperado {ExpectedType}.
O fluxo {FlowName} ({FlowId}) não foi executado com o código de resposta {ResponseCode}, código de erro: {FlowErrorCode}.

Resolução: verifique se o tipo básico de todas as variáveis que você passa para o fluxo correspondem ao tipo do parâmetro.

FlowActionTimedOut

Mensagem de erro: O fluxo com id {FlowId} atingiu o tempo limite. Código de erro: {FlowErrorCode}

Resolução:verifique o fluxo em busca de erros para compreender por que o fluxo da nuvem demorou mais de 100 segundos para ser executado antes de retornar ao agente. Tente otimizar a consulta e os dados retornados do sistema de back-end. Se parte da lógica do fluxo de nuvem puder continuar sendo executada após o envio de um resultado ao agente, execute essas ações após a etapa "Retornar valor(es) para o Copilot Studio" em seu fluxo da nuvem.

GenAISearchandSummarizeRateLimitReached

Mensagem de erro: O limite de uso para pesquisa e resumo foi atingido. Tente novamente mais tarde.

Resolução: Essa mensagem é retornada quando o agente atinge seu limite de IA generativo para pesquisar e resumir fontes.

GenAIToolPlannerRateLimitReached

Mensagem de erro: O limite de uso para orquestração gerativa foi atingido. Tente novamente mais tarde.

Resolução: Essa mensagem é retornada quando o agente atinge o limite de orquestração generativo.

Conteúdo Inválido

Mensagem de erro: Um total de componentes {TotalComponents} existe no agente, mas nenhum é válido.

Resolução:abra o editor de códigos para analisar os problemas no conteúdo.

InfiniteLoopInBotContent

Mensagem de erro: Ação {DialogId}. {TriggerId}. {ActionId} foi executado mais do que {MaxTurnCount} vezes em uma linha. Isso indica um ciclo na execução do diálogo e, por isso, a execução do diálogo será encerrada.

Resolução: verifique se o tópico é encerrado devidamente e leva para outros tópicos que terminem corretamente, como o tópico do sistema Escalar.

ÚltimaVersãoPublicadaNãoEncontrada

Mensagem de erro: Não é possível recuperar a versão mais recente publicada do agente.

Resolução:publique o agente.

OutgoingMessageSizeTooBig

Mensagem de erro: Tamanho da mensagem de saída muito grande.

Resolução: revise os nós para garantir que nenhum deles esteja usando uma variável que contenha um grande volume de texto, como um método estático JSON.stringify(). Se você usar esse método ou uma variável que contenha um grande volume de texto, modifique o nó para só passar a parte do texto necessária. Por exemplo, se você usar um Adaptive Card a fim de passar dados para outro tópico, atualize a variável para passar apenas a propriedade necessária.

Para obter mais informações, consulte Limites máximos de tamanho de mensagem de dados de canal ao usar o Copilot Studio no Omnicanal.

OpenAIRateLimitReached

Mensagem de erro: ocorreu um erro.

Resolução: o agente atingiu o número máximo de respostas generativas. Revise sua capacidade de mensagem e abra uma solicitação de suporte para aumentar seu limite de taxa de respostas generativas.

RedirectToDisabledDialog

Mensagem de erro: A caixa de diálogo com id {DialogId} está desabilitada na definição. Habilite o diálogo antes de usá-lo.

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

RedirectToNonExistentDialog

Mensagem de erro: A caixa de diálogo com a ID {DialogId} não foi encontrada na definição. Verifique se a janela de diálogo está presente e se o ID está correto.

Resolução:crie um novo tópico ao qual redirecionar ou remova o nó de redirecionamento.

Erro do Sistema

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

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

MuitoDadoParaGerenciar

Mensagem de erro: A solicitação está resultando em muitos dados para lidar, avalie a quantidade de dados que estão sendo retornados por suas ações.

Resolução: isso indica que a solicitação que está sendo enviada para o OpenAI está excedendo o tamanho máximo de solicitação permitido. Há inúmeras coisas que compõem a solicitação, inclusive a entrada do usuário, a saída de ações anteriores, as ferramentas chamadas e o histórico de conversas. Analise as ferramentas que você está usando e, sempre que possível, reduza o escopo de sua saída a apenas os campos necessários. Para obter mais informações, consulte Criar um fluxo do Power Automate e chamar um fluxo do Power Automate como uma ação.

Erro	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 o tópico termina corretamente ou leva o usuário para outros tópicos que terminam corretamente, tais como o tópico do sistema Escalonar.
2001	"O conteúdo do bot é inválido."	Verifique o tópico em busca de erros.
2002	"Ocorreu um problema com o CDS."	Houve um problema no acesso ao 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 o fluxo em busca de erros e procure execuções com falha no histórico da execução de fluxo.
2004	"Há um problema com `{Skill Name}` em `{Topic Name}`. Verifique seu conteúdo."	Ocorreu um problema com a sua habilidade. Verifique [a habilidade][8] e o tópico em busca de erros.
2005	"Encontramos um problema. Verifique seu conteúdo."	Houve um problema no modelo de fluxo do Power Automate. Verifique o fluxo em busca de erros.
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 agente, 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 no Copilot Studio."	Para usar este bot, publique-o no 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."	O 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 de 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 do 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.
2024	"Este ambiente exige que os usuários façam login antes de usar o bot. Acesse Gerenciar > Segurança > Autenticação e selecione a opção que exige que os usuários entrem."	As políticas de DLP (prevenção contra perda de dados) do seu ambiente exigem que os usuários entrem. Para ver como solicitar que os usuários façam login, consulte Configurar a 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 outro 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 ao qual redirecionar para ou remova o nó de redirecionamento.
2026	"Ocorreu um problema com no fluxo do Power Automate. Verifique seu conteúdo."	Verifique o fluxo em busca de erros.
2030	"Verifique o histórico da execução de fluxo do Power Automate e verifique se o fluxo foi executado com êxito."
2100(Somente Teams)	"O usuário está digitando muito rápido."	As interações com o bot são limitadas para mitigar o spam. Tente novamente digitando mais devagar.
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 atendimento ao cliente para obter mais detalhes.
3001	"O Power Automate não está disponível para o 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 a solicitação para o fluxo `{Flow Name}` não foi aceita. Tente novamente mais tarde."	Ocorreu um erro no Power Automate, e a 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.