Partilhar via

Compreender códigos de erro

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

Como um criador de agente, se ocorrer um problema ao usar o painel de teste para testar seu agente, você verá uma mensagem que contém 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 diálogo é usado em algumas mensagens de erro para se referir a um tópico.

Código do erro Description
AIModelActionRequestTimeout Houve um erro de timeout relacionado a uma chamada para um modelo do AI Builder.
AsyncResponsePayloadTooLarge Erro relacionado à saída de um conector.
ContentError Erro no conteúdo do tópico.
ConsentimentoNãoFornecidoPeloUsuário Um usuário que interage com um agente rejeitou a solicitação de SSO do agente.
DataLossPreventionViolation Houve uma violação de política de dados.
EnforcementMessageC2 Não havia capacidade pré-paga suficiente disponível.
FlowActionBadRequest Uma solicitação feita a um fluxo de agente foi malformulada.
FlowActionException Ocorreu um erro durante a execução de um fluxo de agente.
FlowActionTimedOut Um fluxo de agente levou mais de 100 segundos para ser executado e atingiu o tempo limite.
ConexãoDoFlowMakerBloqueada Um fluxo de agente invocado com credenciais de criador não autorizadas durante a conexão.
GenAISearchandSummarizeRateLimitReached O limite de uso da IA gerativa foi atingido.
GenAIToolPlannerRateLimitReached O limite de uso para orquestração generativa foi atingido.
InfiniteLoopInBotContent Um nó foi executado muitas vezes.
InvalidContent Conteúdo inválido foi adicionado ao editor de código.
LatestPublishedVersionNotFound Não foi possível recuperar a versão publicada do agente.
OpenAIHate O conteúdo de ódio foi detectado.
OpenAIJailBreak O conteúdo do jailbreak foi detectado.
OpenAIndirectAttack O conteúdo do ataque indireto foi detectado.
OpenAISelfHarm Conteúdo de automutilação foi detectado.
OpenAISexual O conteúdo sexual foi detectado.
OpenAIRateLimitReached O limite de capacidade do agente foi atingido.
OpenAIViolence Conteúdo violento foi detectado.
OutgoingMessageSizeTooBig Uma mensagem enviada por um agente era muito grande para ser processada.
RedirectToDisabledDialog Um tópico foi redirecionado para um tópico desabilitado.
RedirectToNonExistentDialog Um tópico estava redirecionando para outro tópico que não existe mais.
SystemError Ocorreu um erro no sistema no Copilot Studio.
TooMuchDataToHandle A solicitação feita pelo usuário é muito grande para ser processada.

AIModelActionRequestTimeout

Mensagem de erro: a execução do prompt prompt-name atingiu o tempo limite.

Resolução: verifique se a chamada para o modelo do Construtor de IA não excede 100 segundos.

AsyncResponsePayloadTooLarge

Mensagem de erro: a saída retornada do conector era muito grande para ser tratada 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 uma carga útil que é maior do que o agente pode manipular. Para obter mais informações sobre o limite de conteúdo, 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: Essa mensagem é um erro genérico para problemas relacionados ao conteúdo do agente. A mensagem de erro fornece mais detalhes.

Os problemas comuns incluem:

ConsentimentoNãoFornecidoPeloUsuário

Mensagem de erro: nenhum consentimento fornecido para conexão SSO.

Resolução: o usuário que está interagindo com o agente deve verificar a conexão usando o prompt de conexão de logon único do agente.

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

EnforcementMessageC2

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

Resolução: essa mensagem é exibida quando um agente atinge sua capacidade de mensagem ou o medidor pago conforme o uso atinge seu limite. Para resolver o problema, adicione mais capacidade pré-paga ou crie um plano de cobrança pago conforme o uso. O chat do agente deve voltar a funcionar em até cinco minutos. Para obter mais informações, consulte Overage Enforcement.

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 base de todas as variáveis que você passa para o fluxo corresponde ao tipo de parâmetro.

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 se há erros no fluxo.

FlowActionTimedOut

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

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

FlowMakerConnectionBlocked

Mensagem de erro: o fluxo com o nome {FlowName} está usando uma conexão do criador, o que não é permitido. Código de erro: {FlowMakerConnectionBlocked}

Resolução: o administrador impede o uso de credenciais do criador em uma conexão que é invocada do fluxo do agente. Abra o fluxo no Power Automate e compartilhe o fluxo de nuvem usando permissões somente execução.

GenAISearchandSummarizeRateLimitReached

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

Resolução: o agente retorna essa mensagem quando atinge seu limite de IA generativo para pesquisar e resumir fontes. Para obter mais informações, consulte Resolver erros de limitação em agentes.

GenAIToolPlannerRateLimitReached

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

Resolução: o agente retorna essa mensagem quando atinge o limite de orquestração generativo. Para obter mais informações, consulte Resolver erros de limitação em agentes.

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 termina corretamente e se conecta a outros tópicos que terminam corretamente, como o tópico de Escalonar do sistema.

InvalidContent

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

Resolução: abra o editor de código para examinar problemas que afetam o conteúdo.

LatestPublishedVersionNotFound

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

Resolução: Publicar o Agente.

OpenAIHate

Mensagem de erro: o conteúdo foi filtrado devido a restrições de IA responsável.

Uma verificação de IA responsável bloqueia o conteúdo para conteúdo odioso. Conteúdo odioso refere-se a qualquer conteúdo que ataque ou use linguagem discriminatória que se refere a uma pessoa ou grupo de identidade com base em determinados atributos diferenciais desses grupos.

Essa restrição inclui, mas não se limita ao conteúdo sobre:

  • Raça, etnia, nacionalidade
  • Grupos e expressão de identidade de gênero
  • Orientação sexual
  • Religião
  • Aparência pessoal e tamanho do corpo
  • Status de deficiência
  • Assédio e intimidação (bullying)

Resolução: para evitar essa situação, reforce as diretrizes de IA responsáveis junto com os usuários do agente. Você também pode atualizar as políticas de moderação de conteúdo do agente.

OpenAIJailBreak

Mensagem de erro: o conteúdo foi filtrado devido a restrições de IA responsável.

Uma verificação de segurança bloqueia o conteúdo de uma tentativa de jailbreak. Uma tentativa de jailbreak é um ataque em que o comando do usuário ignora os comandos do sistema e tenta alterar o comportamento previsto do agente. Esses ataques incluem tentativas de alterar as regras do sistema, inserindo uma simulação de conversa para confundir o modelo, o role-play e os ataques de codificação. Para obter mais informações, consulte Prompt Shields no Azure AI Content Safety.

Resolução: para evitar essa situação, reforce as diretrizes de IA responsáveis junto com os usuários do agente. Você também pode atualizar as políticas de moderação de conteúdo do agente.

OpenAIndirectAttack

Mensagem de erro: o conteúdo foi filtrado devido a restrições de IA responsável.

Um ataque foi detectado a partir de informações que não são fornecidas diretamente pelo autor do agente ou pelo usuário, como documentos externos. Os invasores tentam inserir instruções em dados fornecidos pelo usuário para obter o controle do sistema de forma maliciosa:

  • Manipulando o conteúdo
  • Intrusão
  • Exfiltração não autorizada de dados ou remoção de dados de um sistema
  • Bloqueando as funcionalidades do sistema
  • Fraude
  • Executando um código e infectando outros sistemas

Para obter mais informações, consulte Prompt Shields para obter documentos.

Resolução: se você estiver testando e não pretender que o teste seja um ataque, verifique se as instruções estão alinhadas com o que você deseja que o agente possa fazer. Caso contrário, reforce as diretrizes de uso responsável da IA juntamente com os usuários do agente para evitar essa situação.

OpenAISelfHarm

Mensagem de erro: o conteúdo foi filtrado devido a restrições de IA responsável.

Uma verificação de IA responsável bloqueou o conteúdo relacionado à automutilação. O termo automutilação refere-se à linguagem relacionada a ações físicas que se destinam a ferir, machucar, danificar o corpo ou tirar a própria vida propositalmente.

Essa restrição inclui, mas não se limita ao conteúdo sobre:

  • Distúrbio alimentar
  • Bullying e intimidação

Resolução: para evitar essa situação, reforce as diretrizes de IA responsáveis junto com os usuários do agente. Você também pode atualizar as políticas de moderação de conteúdo do agente.

OpenAISexual

Mensagem de erro: o conteúdo foi filtrado devido a restrições de IA responsável.

Uma verificação de IA responsável bloqueou conteúdo sexual. O conteúdo sexual descreve a linguagem relacionada a órgãos anatômicos e genitais, relacionamentos românticos, atos sexuais e atos retratados em termos eróticos ou afetuosos, incluindo aqueles retratados como uma agressão ou um ato violento sexual forçado contra a vontade.

Essa restrição inclui, mas não se limita ao conteúdo sobre:

  • Conteúdo vulgar
  • Prostituição
  • Nudez e pornografia
  • Abuso
  • Exploração, abuso e aliciamento infantil

Resolução: para evitar essa situação, reforce as diretrizes de IA responsáveis junto com os usuários do agente. Você também pode atualizar as políticas de moderação de conteúdo do agente.

OpenAIRateLimitReached

Mensagem de erro: ocorreu um erro.

Resolução: seu agente atingiu o número máximo de respostas generativas. Examine a capacidade da mensagem e examine as informações em Resolver erros de limitação em agentes.

OpenAIViolence

Mensagem de erro: o conteúdo foi filtrado devido a restrições de IA responsável.

Um sistema de IA responsável bloqueou o conteúdo devido a violência. O conteúdo violento descreve a linguagem relacionada a ações físicas destinadas a ferir, ferir, danificar ou matar alguém ou algo assim. Também descreve armas, armas de fogo e entidades relacionadas.

Essa restrição inclui, mas não se limita ao conteúdo sobre:

  • Armas
  • Bullying e intimidação
  • Extremismo terrorista e violento
  • Perseguição

Resolução: para evitar essa situação, reforce as diretrizes de IA responsáveis junto com os usuários do agente. Você também pode atualizar as políticas de moderação de conteúdo do agente.

OutgoingMessageSizeTooBig

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

Resolução: dependendo do canal usado para transferir arquivos, como Direct Line ou Facebook, você poderá receber a seguinte mensagem de erro: "O comprimento do conteúdo da solicitação excedeu o limite de 262.144 bytes". Esses limites são impostos pelo canal, não pelo Copilot Studio.

Nesse cenário, considere algumas opções. Uma opção é fornecer um link para o recurso como um anexo da Internet. Outra opção é examinar seus nós para garantir que nenhum deles use uma variável que contenha um grande volume de texto, como um JSON.stringify() método estático. Se você usar esse método ou uma variável que contenha um grande volume de texto, modifique o nó para passar apenas a parte do texto necessária. Por exemplo, se você usar 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.

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: Reative 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 para o qual redirecionar ou remova o nó de redirecionamento.

SystemError

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

Resolução: contate o suporte ao cliente.

TooMuchDataToHandle

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: esse erro indica que a solicitação enviada ao OpenAI excede o tamanho máximo de solicitação permitido. A solicitação inclui a entrada do usuário, a saída de ações anteriores, as ferramentas que foram chamadas e o histórico da conversa. Examine as ferramentas que você usa. Se for possível, restrinja a saída para 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.

  • Last updated on