Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Quando um agente alimentado pelo chicote GitHub Copilot não consegue completar uma curva, as abas Preview, Test e Evaluate mostram uma mensagem de erro junto com um código de erro curto. O código de erro identifica a causa para que você possa decidir se tenta novamente, altera sua entrada ou entra em contato com seu administrador.
Note
Os recursos deste artigo são usados por agentes ou fluxos de trabalho alimentados pelo GitHub Copilot.
A cobrança por uso se aplica ao uso, criação, teste e avaliação de agentes. Essas ações podem consumir Créditos do Copilot. Saiba mais em Gerenciar os custos de agentes viabilizados pelo GitHub Copilot harness.
Onde você vê códigos de erro
Códigos de erro aparecem em vários lugares em agentes alimentados pelo chicote GitHub Copilot:
- A aba Prévia: quando uma conversa de teste falha, a resposta do agente que falhou mostra a mensagem de erro com o código de erro.
- A tabela de histórico de Prévia: a coluna Erro exibe o código de erro para qualquer conversa com status de Falhada . Saiba mais em Gerenciar conversas de prévia (prévia).
- O rastreamento de Atividade: uma etapa falhada no rastreio lista o código de erro junto com a etapa que o produziu. Saiba mais em Use o rastreamento de atividade para depurar seu agente (prévia).
- Avaliar resultados: casos de teste fracassados incluem o código de erro nos detalhes da execução. Saiba mais em Avaliar um agente (prévia).
Resumo do código de erro
A tabela a seguir resume cada código de erro, se tentar novamente geralmente ajuda e se o próximo passo é seu (o criador), o usuário final ou seu administrador.
| Error code | Meaning | Retentar geralmente ajuda | Action owner |
|---|---|---|---|
| CONTENT_FILTERED | Uma política de segurança de conteúdo bloqueou o pedido ou resposta. | Não, com a mesma entrada | End user |
| CONTEXT_LENGTH_EXCEEDED | O pedido era grande demais para o modelo. | Não, com a mesma entrada | Maker |
| CONVERSATION_BUSY | Uma mensagem anterior ainda está sendo processada para a mesma conversa. | Sim, depois que o turno anterior termina | End user |
| CROSS_GEO_NOT_ALLOWED | As configurações de residência de dados do seu inquilino impedem que a solicitação seja processada. | No | Administradores |
| DEPLOYMENT_NOT_FOUND | A implantação do modelo de IA configurada não foi localizada. | No | Administrador ou fabricante |
| MODEL_CONSENT_DENIED | O modelo de IA selecionado não está ativado para sua organização. | No | Administradores |
| QUOTA_EXCEEDED | A cota de serviços de IA da sua organização está esgotada. | Sim, depois de uma espera maior | Administradores |
| RATE_LIMIT_REACHED | O serviço de IA está temporariamente ocupado. | Sim, depois de uma breve espera | End user |
| SYSTEM_ERROR | Ocorreu um erro inesperado que exige investigação. | Às vezes; Tente novamente antes de escalar a situação | Support |
O restante deste artigo descreve cada código em detalhes.
CONTENT_FILTERED
Uma política de segurança de conteúdo bloqueou o pedido ou resposta.
O que normalmente significa
As políticas de segurança de conteúdo da Microsoft abrangem categorias como ódio, violência, conteúdo sexual, automutilação, tentativas de fuga e ataques indiretos. Tanto o pedido do usuário quanto a resposta do agente acionaram uma dessas categorias.
O que fazer
- Reformule o pedido para evitar o conteúdo sinalizado.
- Para agentes que frequentemente encontram esse erro em entradas legítimas, refine as Instruções na aba Build para esclarecer o escopo pretendido do agente. Saiba mais em Configurar identidade do agente e instruções (prévia).
- O agente não revela qual categoria foi acionada para evitar vazamento de informações. Se precisar investigar um caso específico, entre em contato com seu administrador com o ID de conversa do rastreamento de atividade.
CONTEXT_LENGTH_EXCEEDED
A solicitação ultrapassou o tamanho máximo de entrada do modelo de IA.
O que normalmente significa
O tamanho combinado das instruções do agente, do histórico de conversas, das definições das ferramentas e de qualquer resultado de ferramenta é maior do que o modelo pode processar em uma única turnada. Conversas longas e grande quantidade de ferramentas são as causas mais comuns.
O que fazer
- Encurta as Instruções do agente na aba Build .
- Reduza o número de ferramentas associadas ao agente. Saiba mais em Gerenciar ferramentas para um agente (prévia).
- Comece uma nova conversa de pré-visualização para limpar o histórico de conversas. Saiba mais em Gerenciar conversas de prévia (prévia).
- Escolha um modelo com uma janela de contexto maior. Saiba mais em Selecione um modelo de agente (prévia).
CONVERSATION_BUSY
Uma mensagem anterior na mesma conversa ainda está sendo processada.
O que normalmente significa
O agente processa um turno de cada vez dentro de uma única conversa. Se você enviar uma segunda mensagem antes do turno anterior terminar, a nova mensagem não pode começar até que o agente complete o turno em andamento.
O que fazer
- Espere a resposta anterior terminar e então envie a nova mensagem.
- Se você enviou a segunda mensagem acidentalmente (por exemplo, clicando duas vezes em Enviar), não tome nenhuma atitude. A duplicata é rejeitada e o turno original continua.
- Se o agente parecer travado em um turno anterior, inicie uma nova conversa. Saiba mais em Gerenciar conversas de prévia (prévia).
CROSS_GEO_NOT_ALLOWED
As configurações de residência de dados do seu inquilino não permitem processar a solicitação em outra região.
O que normalmente significa
A política da sua organização exige que os dados permaneçam dentro de uma região específica, e não há implantação interna do modelo solicitado disponível para seu locatário.
O que fazer
- Entre em contato com seu administrador para qualquer um dos dois:
- Permitir a movimentação de dados entre regiões para serviços de IA em configurações de inquilino, ou
- Forneça uma implantação do modelo dentro da região.
- Como maker, mude o modelo do agente para um que esteja implantado na sua região. Saiba mais em Selecione um modelo de agente (prévia).
DEPLOYMENT_NOT_FOUND
A implantação do modelo de IA configurado não pode ser encontrada.
O que normalmente significa
O modelo que seu agente está configurado para usar foi aposentado, removido ou está indisponível no seu ambiente. Esse comportamento pode ocorrer após um modelo ser obsoleto ou após uma mudança na configuração do tenant.
O que fazer
- Na aba Build , abra o seletor de modelos e selecione um modelo disponível. Saiba mais em Selecione um modelo de agente (prévia).
- Se um modelo previamente disponível desapareceu, entre em contato com seu administrador para verificar a implantação do modelo no seu ambiente.
MODEL_CONSENT_DENIED
O modelo de IA que seu agente usa não está ativado para seu locatário ou ambiente.
O que normalmente significa
Alguns modelos exigem consentimento explícito no nível do inquilino ou do ambiente antes que os agentes possam usá-los. Se o consentimento não for concedido, o agente não pode ligar para a modelo.
O que fazer
- Entre em contato com seu administrador para ativar o modelo necessário nas configurações do Copilot Studio.
- Se seu agente estiver configurado com um modelo de backup, o agente tenta automaticamente com esse plano de retorno. Nesse caso, nenhuma ação é necessária.
- Se você não precisar desse modelo específico, mude o modelo na aba Build. Saiba mais em Selecionar um modelo de agente (prévia).
QUOTA_EXCEEDED
Sua organização superou sua cota para o serviço de IA.
O que normalmente significa
Diferente de , que é um limite de rajadas de curta duração, QUOTA_EXCEEDED indica que sua organização atingiu RATE_LIMIT_REACHEDuma cota de uso de maior duração. Essas cotas normalmente acompanham tokens ou requisições ao longo de um período de faturamento.
O que fazer
- Aguarde e tente novamente mais tarde. As cotas normalmente são reiniciadas em um cronograma fixo.
- Entre em contato com seu administrador para revisar a cota de serviços de IA da organização e solicitar um aumento, se necessário.
- Para trabalhos de desenvolvimento contínuos, agende grandes execuções de avaliação fora dos horários de pico.
RATE_LIMIT_REACHED
O serviço de IA está temporariamente ocupado e rejeitou o pedido.
O que normalmente significa
A demanda pelo serviço de IA disparou, ou sua organização enviou muitos pedidos em pouco tempo. Esse comportamento é transitório.
O que fazer
- aguarde alguns segundos e tente novamente.
- Para testes no Avaliar, reexecute os casos de teste que falharam.
- Se o erro acontecer repetidamente, entre em contato com seu administrador para revisar a capacidade.
SYSTEM_ERROR
Ocorreu um erro inesperado que não corresponde a nenhum dos códigos mais específicos.
O que normalmente significa
SYSTEM_ERROR é um acúmulo para problemas de infraestrutura transitórias, falhas internas inesperadas ou condições que exigem investigação de engenharia. Novas categorias de erro também podem surgir até SYSTEM_ERROR que recebam um código dedicado em uma versão futura.
O que fazer
- Tente a solicitação novamente. O problema pode ser transitório.
- Se o erro persistir, capture o ID da conversa do rastreamento de atividade e o horário da falha, e então entre em contato com o suporte.
- Se o problema afetar vários usuários ao mesmo tempo, peça ao seu administrador para verificar o painel de saúde do serviço do Microsoft 365.
Comando bloqueado por segurança
Quando um agente usa uma ferramenta que executa comandos (por exemplo, um interpretador de código ou uma ferramenta shell), o Copilot Studio aplica verificações de segurança antes de cada comando ser executado. Se um comando corresponder a um padrão inseguro, o comando não é executado e o agente informa que a operação foi bloqueada. Por exemplo, uma operação destrutiva no sistema de arquivos, uma mudança na configuração da rede ou outra ação fora do escopo pretendido da ferramenta. O bloqueio aparece como uma etapa no rastreamento de atividade com uma mensagem de que o comando foi negado.
O que fazer
- Usuários finais: tentem uma frase diferente que evite a operação bloqueada, ou pedir ao agente que alcance o mesmo objetivo por meio de um passo mais seguro.
- Criadores: na aba Build , revise a descrição da ferramenta e as instruções do agente para que ele fique dentro do escopo que você espera. Saiba mais em Configurar identidade do agente e instruções (prévia).
- Se uma operação legítima for bloqueada repetidamente, capture o ID da conversa do rastreamento de atividade e entre em contato com seu administrador.
Forward compatibility
A lista de códigos de erro pode crescer em versões futuras. Se você construir automação ou dashboards sobre códigos de erro (por exemplo, no processamento de resultados de avaliação), trate qualquer código desconhecido da mesma forma que SYSTEM_ERROR: mostrar uma mensagem genérica e permitir retentativas.