Compreender códigos de erro

  • Artigo

Importante

As capacidades e os recursos do Power Virtual Agents agora fazem parte do Microsoft Copilot Studio após investimentos significativos em IA generativa e integrações aprimoradas no Microsoft Copilot.

Alguns artigos e capturas de tela podem fazer referência ao Power Virtual Agents enquanto atualizamos a documentação e o conteúdo do treinamento.

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

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

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 Description
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 é possível recuperar a versão publicada do copiloto.
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 Microsoft Copilot Studio.

ContentError

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

Resolução: este é um erro genérico para problemas relacionados ao conteúdo do seu copiloto. Consulte a mensagem de erro para obter mais detalhes.

Os problemas comuns incluem:

DataLossPreventionViolation

Mensagem de erro: "Este ambiente exige que os usuários entrem antes de usar o copiloto. 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 Configurar a autenticação de usuário.
  • Um ou mais conectores usados no copiloto não estão no mesmo grupo de dados. Consulte Microsoft Copilot Studioconectores.
  • Um ou mais conectores usados no copiloto estão bloqueados pelo administrador de locatários.

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 copiloto."
  • "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 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 seu copiloto. 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 copiloto, execute essas ações após a etapa 'Retornar valores para o Microsoft Copilot Studio' em seu fluxo da nuvem.

InvalidContent

Mensagem de erro: "Existe um total de {TotalComponents} componentes no copiloto, 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 é possível recuperar a versão publicada do copiloto."

Resolução:Publicar o copiloto.

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.