Partilhar via

Compreender códigos de erro

  • Artigo

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.

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
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.
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.
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.
OutgoingMessageSizeTooBig Uma mensagem enviada por um agente é 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 de sistema no 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. Para obter mais detalhes, consulte a mensagem de erro.

Os problemas comuns incluem:

DataLossPreventionViolation

Mensagem de erro: "Este ambiente exige que os usuários entrem antes de 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:

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 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}. Este tipo não tem suporte ao chamar 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 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} 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 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 a ser executada após o envio de um resultado ao agente, execute essas ações após a etapa 'Retornar valores para o Copilot Studio' em seu fluxo da nuvem.

InvalidContent

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

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

InfiniteLoopInBotContent

Mensagem de erro: "A ação {DialogId}.{TriggerId}.{ActionId} foi executada mais de {MaxTurnCount} vezes seguidas. 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 o tópico termine corretamente e leve para outros tópicos que terminam corretamente, como o tópico do sistema Escalar.

LatestPublishedVersionNotFound

Mensagem de erro: "Não foi 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 seus 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 esse tipo de método estiver sendo usado, ou se outra variável que contém um grande volume de texto estiver sendo usada, modifique o nó para passar apenas a parte do texto necessária. Por exemplo, se você estiver usando um Cartão Adaptável para 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 número máximo de respostas generativas foi atingido. 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: "O Diálogo com a ID {DialogId} está desabilitado 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: "O Diálogo com a 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 ao qual redirecionar ou remova o nó de redirecionamento.

SystemError

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

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