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ê receberá uma mensagem que contém o código de erro e mais contexto sobre o problema. Como alternativa, você pode usar o painel verificador de tópicos para validar a configuração do 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
AIModelActionBadRequest Há uma incompatibilidade entre os tipos de ação de prompt.
AIModelActionRequestTimeout Há um erro de tempo limite relacionado a uma chamada para um modelo do AI Builder.
AsyncResponsePayloadTooLarge Há um erro relacionado à saída de um conector.
AuthenticationNotConfigured A autenticação é necessária, mas não foi configurada.
ConnectedAgentAuthMismatch Há uma incompatibilidade de autenticação entre o orquestrador e o subagente.
ConnectedAgentBotNotFound Um subagente em uma configuração de orquestração multiagente não foi encontrado.
ConnectedAgentBotNotPublished Um subagente em uma configuração de orquestração de vários agentes não foi publicado.
EncadeamentoDeAgentesConectadosNãoSuportado Não há suporte para encadeamento de agentes em múltiplos níveis.
ConnectedAgentGptComponentNotFound Um agente conectado não tem descrições ou instruções.
ConnectorPowerFxError Há um erro na avaliação da expressão Power Fx em ações no conector.
ContentError Há um 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.
ConversationStateTooLarge O estado de conversa excede os limites de tamanho.
DataLossPreventionViolation Há uma violação de política de dados.
EnforcementMessageC2 Não há capacidade pré-paga suficiente disponível.
FlowActionBadRequest Uma solicitação feita a um fluxo de agente é malformada.
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.

AIModelActionBadRequest

Mensagens de erro:

  • A saída do prompt foi avaliada como {ActualType}, mas era esperada {ExpectedType}.

  • O parâmetro {ParameterName} de entrada para prompt {PromptName} está ausente.

  • O parâmetro {ParameterName} de entrada para prompt {PromptName} está em branco, mas é necessário.

  • Esperado: {ExpectedType}. Atual: {ActualType}.

Resolução: Esse erro ocorrerá se uma ação de prompt receber entrada incorreta ou retornar tipos de saída inesperados. Para resolver o problema, execute uma das seguintes ações, com base no erro:

  • Incompatibilidade de tipos: Verifique a configuração do prompt para verificar se o esquema de saída corresponde ao tipo de variável esperado.
  • Entrada necessária ausente: Verifique se todas as entradas necessárias estão conectadas a variáveis que têm valores.
  • Valor necessário em branco: Verifique se a variável tem um valor antes de você chamar o prompt.

Para obter mais informações, consulte Criar uma ação de prompt.

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.

AutenticaçãoNãoConfigurada

Mensagens de erro:

  • A autenticação não está configurada para esse bot.

  • O bot requer entrada, mas não está configurado para autenticação. Atualize o método de autenticação para o bot.

  • Não há suporte para autenticação integrada no canal {channel}.

Resolução: Esse erro ocorre se o agente usa ações ou recursos que exigem autenticação do usuário, mas a autenticação não está configurada. Para resolver o problema:

  1. Em seu agente, vá para Configurações > Segurança > Autenticação.
  2. Selecione um método de autenticação apropriado: autenticar com a Microsoft para usuários do Microsoft 365 ou autenticar manualmente para provedores OAuth personalizados.
  3. Se o erro mencionar um canal específico, verifique se o canal dá suporte ao método de autenticação que você está usando. Alguns canais não dão suporte à autenticação integrada.

Para obter mais informações, consulte Configurar a autenticação do usuário.

Falha de Autenticação do Agente Conectado

Mensagem de erro: Seu agente conectado com o nome {AgentSchemaName} do esquema tem uma incompatibilidade de autenticação com o agente principal.

Resolução: O agente do orquestrador e o subagente conectado têm configurações de autenticação diferentes. Para que a orquestração de vários agentes funcione, ambos os agentes devem usar configurações de autenticação compatíveis. Para resolver o problema:

  1. Abra ambos os agentes e vá para Configurações Segurança Autenticação.
  2. Verifique se ambos os agentes usam o mesmo método de autenticação (por exemplo, ambos usam Autenticar com a Microsoft).
  3. Se você estiver usando a autenticação manual, verifique se ambos os agentes estão configurados para usar o mesmo provedor E configurações do OAuth.

As seguintes regras de compatibilidade de autenticação se aplicam:

  • Se o agente conectado não tiver nenhuma autenticação configurada, qualquer autenticação de orquestrador será aceitável.
  • Se o agente conectado exigir autenticação, o orquestrador deverá usar o mesmo método de autenticação.
  • A autenticação manual (OAuth2 genérico) no orquestrador não é compatível com agentes conectados que exigem autenticação. Ambos os agentes devem usar a mesma configuração de autenticação manual ou o agente conectado não deve ter nenhum requisito de autenticação.

Para obter mais informações, consulte Configurar a autenticação do usuário e usar agentes como ações em outros agentes (versão prévia).

ConnectedAgentBotNotFound

Mensagem de erro: Agente conectado com o nome do esquema {AgentSchemaName} não encontrado.

Resolução: Esse erro ocorrerá na orquestração de vários agentes se o agente do orquestrador não conseguir encontrar um subagente conectado. Para resolver o problema:

  1. Verifique se o agente conectado está no mesmo ambiente que o agente orquestrador.
  2. Verifique se o nome do esquema do agente conectado está escrito corretamente na configuração do orquestrador.
  3. Verifique se você tem permissões de acesso para o agente conectado.
  4. Se o agente conectado tiver sido criado recentemente, aguarde alguns minutos e tente novamente.

Para obter mais informações, consulte Usar agentes como ações em outros agentes (versão prévia).

ConnectedAgentBotNotPublished

Mensagem de erro: O agente conectado com o nome {AgentSchemaName} do esquema precisa ser publicado para ser invocado.

Resolução: O subagente conectado deve ser publicado antes que o agente orquestrador possa invocá-lo. Para resolver o problema:

  1. Abra o agente conectado no Copilot Studio.
  2. Publicar o agente.
  3. Volte ao agente de orquestração e teste novamente.

Para obter mais informações, consulte Usar agentes como ações em outros agentes (versão prévia).

EncadeamentoDeAgenteConectadoNãoSuportado

Mensagem de erro: Encadeamento de agente detectado. Seu agente não pode ser conectado ao agente com o nome {AgentSchemaName} do esquema, pois ele já tem um agente conectado.

Resolução: Não há suporte para encadeamento de agentes de múltiplos níveis. Um agente de orquestrador pode se conectar a sub-agentes, mas esses sub-agentes não podem ter seus próprios agentes conectados. Para resolver o problema:

  1. Examine a arquitetura do agente e nivele a hierarquia.
  2. Mova a funcionalidade de agentes profundamente aninhados para o orquestrador ou agentes conectados de primeiro nível.
  3. Considere usar tópicos ou ações em vez de agentes conectados adicionais.

Para obter mais informações, consulte Usar agentes como ações em outros agentes (versão prévia).

ConnectedAgentGptComponentNotFound

Mensagem de erro: Nenhum componente GPT encontrado para o agente conectado com o nome {AgentSchemaName}do esquema.

Resolução: O agente conectado não tem uma descrição ou instruções necessárias que permitem que ele seja invocado por um agente de orquestrador. Para resolver o problema:

  1. Abra o agente conectado no Copilot Studio.
  2. Vá para a página visão geral do agente.
  3. Verifique se o agente tem uma descrição e instruções claras configuradas.
  4. Depois de fazer alterações, publique o agente conectado.
  5. Retorne ao agente do orquestrador e teste novamente.

Para obter mais informações, consulte Usar agentes como ações de outros agentes (prévia).

ConnectorPowerFxError

Mensagem de erro: Falha na avaliação de expressão do Power Fx: {ErrorDetails}

Resolução: Uma expressão do Power Fx usada em uma ação de conector não foi avaliada corretamente. Para resolver o problema:

  1. Abra o tópico que contém a ação do conector.
  2. Examine as expressões do Power Fx nos parâmetros de entrada da ação.
  3. Teste as expressões usando dados de exemplo para determinar o problema.
  4. Use os indicadores de erro da barra de fórmulas para localizar problemas específicos.

As causas mais comuns incluem:

  • Erros de sintaxe.
  • Incompatibilidades de tipo, como comparar texto com números sem conversão.
  • Valores nulos ou em branco. Para tratamento, use funções como IsBlank(), Coalesce()ou IfError().
  • Uso inválido de função.

Para obter mais informações, consulte Usar o Power Fx no 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

ConversationStateTooLarge

Mensagem de erro: O tamanho do estado da conversa excede o limite máximo permitido.

Resolução: A conversa acumula muitos dados em seu estado, excedendo os limites de tamanho permitidos. Para resolver o problema:

  1. Reduza os dados variáveis examinando seus tópicos e reduzindo a quantidade de dados armazenados em variáveis durante a conversa.
  2. Desmarque variáveis não utilizados definindo-as como em branco se elas não forem mais necessárias.
  3. Simplifique os fluxos de conversa dividindo conversas complexas em interações menores e mais focadas.
  4. Evite armazenar grandes objetos JSON, matrizes ou blocos de texto em variáveis de conversa.

Para evitar esse erro:

  • Use variáveis somente para dados que precisam persistir entre tópicos.
  • Considere usar fluxos do Power Automate para armazenar e recuperar dados grandes de fontes externas em vez de mantê-los no estado de conversa.

Para obter mais informações, consulte cotas e limites do Copilot Studio.

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 será exibida se um agente atingir sua capacidade de mensagens ou se o medidor de pagamento conforme o uso atingir 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 retornará essa mensagem se atingir 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 retornará essa mensagem se atingir 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 considerado odioso. Conteúdo odioso refere-se a qualquer conteúdo que ataque ou use linguagem discriminatória contra 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 de base fornecidos pelo usuário para obter controle malicioso do sistema:

  • 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úrbios alimentares
  • 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 o conteúdo considerado 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 de violência sexual.

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 gerativas. 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.

Uma verificação de IA responsável bloqueou o conteúdo considerado violento. 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