Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Quando um agente alimentado pelo arnês GitHub Copilot não consegue completar um turno, os separadores Pré-visualização, Teste e Avaliação mostram uma mensagem de erro juntamente com um pequeno código de erro. O código de erro identifica a causa para que possa decidir se tenta novamente, altera a sua entrada ou contacta o seu administrador.
Note
As funcionalidades deste artigo são utilizadas por agentes ou fluxos de trabalho suportados pela estrutura do GitHub Copilot.
A faturação baseada no uso aplica-se à utilização, construção, teste e avaliação de agentes. Estas ações podem consumir Créditos Copilot. Saiba mais em Gerir custos para agentes alimentados pelo harness GitHub Copilot.
Onde vê códigos de erro
Os códigos de erro aparecem em vários locais em agentes alimentados pelo GitHub Copilot:
- O separador Pré-visualização : quando uma conversa de teste falha, a resposta falhada do agente mostra a mensagem de erro com o código de erro.
- A tabela de histórico de Pré-visualização : a coluna Erro mostra o código de erro para qualquer conversa com estado de Falhada . Saiba mais em Gerir conversas de pré-visualização (pré-visualização).
- O rastreio de Atividade: um passo falhado no rastreio lista o código de erro juntamente com o passo que o produziu. Saiba mais em Use o rastreio de atividade para depurar o seu agente (pré-visualização).
- Avaliar resultados: casos de teste falhados incluem o código de erro nos detalhes da execução. Saiba mais em Avaliar um agente (pré-visualização).
Resumo do código de erro
A tabela seguinte resume cada código de erro, se tentar novamente costuma ajudar, e se o passo seguinte é seu (o criador), o utilizador final ou o seu administrador.
| Error code | Meaning | Retentar normalmente ajuda | Action owner |
|---|---|---|---|
| CONTENT_FILTERED | Uma política de segurança de conteúdos bloqueou o pedido ou resposta. | Não, com a mesma entrada | End user |
| CONTEXT_LENGTH_EXCEEDED | O pedido era demasiado grande para o modelo. | Não, com a mesma entrada | Maker |
| CONVERSATION_BUSY | Uma mensagem anterior ainda está a ser processada para a mesma conversa. | Sim, depois do turno anterior terminar | End user |
| CROSS_GEO_NOT_ALLOWED | As definições de residência de dados do seu inquilino impedem que o pedido seja processado. | No | Administradores |
| DEPLOYMENT_NOT_FOUND | A implementaçã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 a sua organização. | No | Administradores |
| QUOTA_EXCEEDED | A quota de serviços de IA da sua organização está esgotada. | Sim, depois de uma espera mais longa | Administradores |
| RATE_LIMIT_REACHED | O serviço de IA está temporariamente ocupado. | Sim, depois de uma curta espera | End user |
| SYSTEM_ERROR | Ocorreu um erro inesperado que exige investigação. | Às vezes; Tente novamente antes de escalar | Support |
O resto deste artigo descreve cada código em detalhe.
CONTENT_FILTERED
Uma política de segurança de conteúdos bloqueou o pedido ou resposta.
O que normalmente significa
As políticas de segurança de conteúdos da Microsoft abrangem categorias como ódio, violência, conteúdo sexual, autoagressão, tentativas de fuga e ataques indiretos. Ou o pedido do utilizador ou a resposta do agente desencadeavam uma destas categorias.
O que fazer
- Reformule o pedido para evitar o conteúdo sinalizado.
- Para agentes que frequentemente encontram este erro em entradas legítimas, refine as Instruções no separador Build para clarificar o âmbito pretendido do agente. Saiba mais em Configurar identidade do agente e instruções (pré-visualização).
- O agente não revela qual a categoria que foi ativada, para evitar fugas de informação. Se precisar de investigar um caso específico, contacte o seu administrador com o ID de conversa do rastreio de atividade.
CONTEXT_LENGTH_EXCEEDED
O pedido excedeu 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 da ferramenta e de quaisquer resultados de ferramenta é maior do que o modelo pode processar numa única vez. Conversas longas e um grande número de ferramentas são as causas mais comuns.
O que fazer
- Reduza as instruções do agente no separador Build .
- Reduza o número de ferramentas associadas ao agente. Saiba mais em Gerir ferramentas para um agente (pré-visualização).
- Inicie uma nova conversa de pré-visualização para limpar o histórico da conversa. Saiba mais em Gerir conversas de pré-visualização (pré-visualização).
- Escolha um modelo com uma janela de contexto maior. Saiba mais em Selecionar um modelo de agente (pré-visualização).
CONVERSATION_BUSY
Uma mensagem anterior na mesma conversa ainda está a ser processada.
O que normalmente significa
O agente processa um turno de cada vez numa única conversa. Se enviares uma segunda mensagem antes do turno anterior terminar, a nova mensagem não pode começar até o agente completar o turno em curso.
O que fazer
- Espere que a resposta anterior termine e depois envie a nova mensagem.
- Se enviaste a segunda mensagem por engano (por exemplo, ao clicar dois vezes em Enviar), não tomes qualquer atitude. O duplicado é rejeitado e o turno original continua.
- Se o agente parecer preso num turno anterior, inicie uma nova conversa. Saiba mais em Gerir conversas de pré-visualização (pré-visualização).
CROSS_GEO_NOT_ALLOWED
As definições de residência de dados do seu inquilino não permitem processar o pedido noutra 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 existe qualquer implementação dentro da região do modelo solicitado disponível para o seu inquilino.
O que fazer
- Contacte o seu administrador para um:
- Permitir a movimentação de dados entre regiões para serviços de IA em contextos de inquilino, ou
- Forneça uma implementação do modelo dentro da região.
- Como criador, muda o modelo do agente para um que seja implementado na tua região. Saiba mais em Selecionar um modelo de agente (pré-visualização).
DEPLOYMENT_NOT_FOUND
A implementação do modelo de IA configurada não é encontrada.
O que normalmente significa
O modelo que o seu agente está configurado para usar foi retirado, removido ou está indisponível no seu ambiente. Este comportamento pode ocorrer depois de um modelo ser obsoleto ou após uma alteração na configuração do tenente.
O que fazer
- No separador Build , abra o seletor de modelos e selecione um modelo disponível. Saiba mais em Selecionar um modelo de agente (pré-visualização).
- Se um modelo previamente disponível desapareceu, contacte o seu administrador para verificar a implementação do modelo no seu ambiente.
MODEL_CONSENT_DENIED
O modelo de IA que o seu agente usa não está ativado para o seu inquilino ou ambiente.
O que normalmente significa
Alguns modelos exigem consentimento explícito ao nível do inquilino ou do ambiente antes de os agentes poderem utilizá-los. Se o consentimento não for concedido, o agente não pode chamar a modelo.
O que fazer
- Contacte o seu administrador para ativar o modelo necessário nas definições do Copilot Studio.
- Se o seu agente estiver configurado com um modelo de recurso, o agente tenta automaticamente novamente com o plano B. Nesse caso, não é necessária qualquer ação.
- Se não precisar deste modelo específico, altere o modelo no separador Build . Saiba mais em Selecionar um modelo de agente (pré-visualização).
QUOTA_EXCEEDED
A sua organização ultrapassou a sua quota para o serviço de IA.
O que normalmente significa
Ao contrário de , que é um limite de rajadas de curta duração, QUOTA_EXCEEDED indica que a sua organização atingiu RATE_LIMIT_REACHEDuma quota de utilização de maior duração. Estas quotas normalmente acompanham tokens ou pedidos ao longo de um período de faturação.
O que fazer
- Aguarde e tente novamente mais tarde. As quotas normalmente são reiniciadas num calendário fixo.
- Contacte o seu administrador para rever a quota de serviços de IA da organização e solicite um aumento, se necessário.
- Para trabalhos de desenvolvimento contínuos, agenda grandes sessões de avaliação fora das horas de ponta.
RATE_LIMIT_REACHED
O serviço de IA está temporariamente ocupado e rejeitou o pedido.
O que normalmente significa
A procura pelo serviço de IA disparou, ou a sua organização enviou muitos pedidos num curto espaço de tempo. Este comportamento é transitório.
O que fazer
- Espere alguns segundos e tente novamente.
- Para as execuções de teste no Evaluate, reexecute os casos de teste falhados.
- Se o erro acontecer repetidamente, contacte o seu administrador para rever 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 afluente para problemas de infraestrutura transitórios, falhas internas inesperadas ou condições que necessitam de investigação de engenharia. Novas categorias de erro também podem surgir até SYSTEM_ERROR receberem um código dedicado numa versão futura.
O que fazer
- Tente fazer a solicitação novamente. O problema pode ser transitório.
- Se o erro persistir, capture o ID da conversa do rastreio de atividade e a hora da falha, e depois contacte o suporte.
- Se o problema afetar muitos utilizadores ao mesmo tempo, peça ao seu administrador para verificar o painel de saúde do serviço Microsoft 365.
Comando bloqueado por segurança
Quando um agente utiliza 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 reporta que a operação foi bloqueada. Por exemplo, uma operação destrutiva do sistema de ficheiros, uma alteração na configuração da rede ou outra ação fora do âmbito pretendido da ferramenta. O bloqueio aparece como um passo no rastreio de atividade com uma mensagem a indicar que o comando foi negado.
O que fazer
- Utilizadores finais: experimentem uma formulação diferente que evite a operação bloqueada, ou peçam ao agente que cumpra o mesmo objetivo através de um passo mais seguro.
- Criadores: no separador Build , reveja a descrição da ferramenta e as instruções do agente para que o agente fique dentro do âmbito que espera. Saiba mais em Configurar identidade do agente e instruções (pré-visualização).
- Se uma operação legítima for bloqueada repetidamente, capture o ID da conversa do rastreio de atividade e contacte o seu administrador.
Forward compatibility
A lista de códigos de erro pode crescer em futuras versões. Se construir automação ou dashboards por cima de 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.