Depurar a execução da tarefa

Quando as tarefas em sua sessão compartilhada não estão progredindo conforme o esperado, este guia ajuda você a identificar a causa e tomar medidas. A maioria dos problemas se enquadra em algumas categorias:

  • Tarefas que estão paralisadas
  • Validação muito rígida ou muito flexível
  • Erros de agente ou ferramenta
  • Comportamento de cognição que parece inesperado

Tarefas travadas no status Novo

Uma tarefa permanece no estado Novo. Causas comuns:

Dependências não atendidas

A tarefa depende de outra tarefa que não esteja em um estado final.

Como verificar: Abra a tarefa e examine o campo Depende . Verifique o status de cada dependência.

Como corrigir:

  • Se a dependência estiver travada, verifique essa tarefa primeiro.
  • Se a dependência não for mais relevante, remova-a do campo Depend on .
  • Se a dependência foi concluída, mas a tarefa ainda mostra o status Novo, o Cognition ainda não está processando a tarefa. Aguarde de 1 a 2 minutos.

Cognition não está em execução

O Mecanismo de Descoberta pode ser interrompido.

Como verificar: verifique se o Mecanismo de Descoberta está em execução em sua sessão compartilhada.

Como corrigir: inicie o Mecanismo de Descoberta. O sistema cognitivo inicia seu ciclo de raciocínio e assume as tarefas que estão prontas.

Observação

O Discovery Engine pode ser interrompido durante as atualizações de serviço. Isso é esperado. Os dados da sessão compartilhada, os resultados da tarefa e o histórico de execução são preservados. Inicie o Mecanismo de Descoberta novamente para retomar.

O Mecanismo de Descoberta não inicia

O modelo de chat necessário para validação de tarefas pode não ser implantado.

Como verificar: verifique se o workspace tem uma implantação de modelo de chat chamada gpt-5-4 (modelo: gpt-5.4).

Como corrigir: implantar o modelo (consulte Criar implantação de modelo de chat) e, em seguida, iniciar o Mecanismo de Descoberta.

A cognição está ocupada com outras tarefas

Se muitas tarefas estiverem em execução ou em validação, a cognição poderá estar aguardando capacidade antes de iniciar novas.

Como verificar: examine quantas tarefas estão atualmente em Status de Execução. Verifique se a cognição está em ciclo de espera observando a atividade da sessão compartilhada.

Como corrigir: aguarde até que algumas tarefas sejam concluídas. O Cognition prioriza as tarefas com base na prioridade e na prontidão da dependência.

Tarefas paradas em status de Execução

Uma tarefa permanece em Execução enquanto um agente está trabalhando nela. Se persistir por muito tempo, algo pode estar errado.

Tempos de execução normais

Antes de assumir que uma tarefa está paralisada, considere o que está acontecendo:

  • Tarefas somente de agente (sem chamadas de ferramenta): geralmente são concluídas em menos de 1 minuto.
  • Tarefas com chamadas de ferramenta: a primeira chamada de ferramenta em uma sessão pode levar de dois a quatro minutos devido ao arranque a frio do supercomputador. As chamadas subsequentes são mais rápidas (menos de 1 minuto).
  • Tarefas com computação pesada: algumas ferramentas executam simulações ou análises em larga escala que levam de 5 a 15 minutos.

A resposta do agente está paralisada

Se uma tarefa tiver sido executada por mais de 15 minutos sem nenhuma atividade de ferramenta, a resposta do modelo subjacente poderá ficar paralisada.

Como verificar: examine o histórico de execução da tarefa para a execução atual. Se a resposta mostrar "em andamento" sem nenhuma nova saída por um longo período, é provável que a resposta esteja travada na camada de modelo.

Como corrigir:

  • Pare e reinicie o Mecanismo de Descoberta. Isso faz com que a cognição reavalie todas as tarefas e tente novamente a que foi paralisada.
  • Se o problema persistir, verifique se a implantação do modelo em seu espaço de trabalho está funcionando corretamente.

Falha na execução da ferramenta

O agente chamou uma ferramenta, mas a ferramenta retornou um erro.

Como verificar: examine o histórico de execução para obter resultados de chamadas de ferramenta. As mensagens de erro das ferramentas normalmente incluem detalhes sobre o que deu errado.

Erros e correções comuns da ferramenta:

Erro Causa provável Corrigir
A execução da ferramenta falhou e não gerou logs O nó do supercomputador não pôde ser iniciado (SKU da VM restrita, cota excedida) Verifique a configuração do seu pool de nós e a disponibilidade da SKU da VM
Tempo limite de conexão com a API externa Restrições de rede na sub-rede do supercomputador Verifique se os pontos de extremidade necessários estão acessíveis a partir do pool de nós. Consulte Gerenciar pools de supercomputadores e nós
Erro de autenticação (403) Ausência de atribuição de função para a identidade do espaço de trabalho ou do supercomputador Verifique se a identidade gerenciada tem as funções necessárias em contas de armazenamento, registros de contêiner e outros recursos
Falha na extração de imagem de contêiner O ACR não é acessível do supercomputador ou a imagem não existe Verifique as regras de rede do ACR e verifique se a imagem foi enviada por push

Tarefas alternando entre execução e incompleto

Quando uma tarefa alterna repetidamente entre os status Executando e Incompleto, o Cognition está tentando novamente porque o resultado não atende aos requisitos de validação.

Os requisitos de validação são muito rígidos

O agente produz resultados razoáveis, mas eles não correspondem precisamente ao que os critérios de validação exigem.

Como verificar: leia os comentários de validação na tarefa. Cada tentativa inclui comentários explicando quais requisitos foram aprovados e quais falharam.

Como corrigir:

O agente não é capaz da tarefa

O agente atribuído pode não ter as ferramentas ou instruções certas para o tipo de trabalho necessário para a tarefa.

Como verificar: veja a qual cognição do agente foi atribuída. Verifique se o agente tem as ferramentas necessárias para a tarefa. Compare o resumo da funcionalidade do agente com os requisitos da tarefa.

Como corrigir:

  • Se um agente diferente for mais apropriado, adicione um comentário à tarefa especificando qual agente usar e por quê (por exemplo, "Use o molToolkit para esta tarefa. Ele requer o RDKit para validação SMILES"). A Cognição lê comentários ao selecionar agentes.
  • Se nenhum agente adequado existir, talvez seja necessário criar ou configurar um. Consulte os conceitos do Discovery Agent.

A descrição da tarefa é ambígua

Se a descrição da tarefa não der ao agente contexto suficiente, o agente poderá produzir resultados tecnicamente válidos, mas que perdem o ponto.

Como verificar: leia o resultado do agente e compare-o com o que você realmente queria. Se o resultado seguir a descrição literalmente, mas não transmitir sua intenção, a descrição necessita de mais contexto.

Como corrigir: atualize a descrição da tarefa com detalhes mais específicos sobre o que você está procurando e defina o status de volta como Novo.

Tarefas sinalizadas como Precisa de Atenção do Usuário

Quando a cognição sinaliza uma tarefa, significa que a cognição tentou várias abordagens e não pôde produzir um resultado que passe pela validação.

Como diagnosticar:

  1. Verificar o histórico de execução: quantas execuções foram tentadas? Quais abordagens foram tentadas?
  2. Ler comentários de validação: Quais requisitos específicos falharam em cada tentativa?
  3. Revise o resultado mais recente: é o que você precisa ou está incorreto?

Opções para resolver:

  • Aceite o resultado: se o resultado mais recente for bom o suficiente, atualize os requisitos de validação e marque a tarefa Concluída.
  • Forneça orientação: adicione um comentário explicando o que está faltando ou qual abordagem tentar. Defina o status novamente como Novo.
  • Divida a tarefa: se a tarefa for muito complexa para um único agente, decomponha-a em tarefas menores.
  • Seleção do agente de guia: se o agente atual não tiver as funcionalidades certas, adicione um comentário especificando qual agente usar e por que, em seguida, defina o status de volta como Novo.
  • Remova a tarefa: se a tarefa não for mais relevante, defina seu status como Removido para que a cognição avance.

Problemas de comportamento de cognição

O aquecimento cognitivo leva muito tempo.

Quando você inicia o Mecanismo de Descoberta pela primeira vez, a cognição passa por um período de aquecimento em que ele cria contexto examinando todas as tarefas e planejando sua abordagem. O aquecimento normalmente leva de 30 a 90 segundos e envolve vários ciclos de raciocínio internos antes do início da primeira tarefa.

Esse é um comportamento normal. Não pare e inicie o Mecanismo de Descoberta novamente durante o aquecimento, pois cada reinicialização dispara um novo período de aquecimento.

A cognição continua esperando em vez de funcionar

Se a cognição parecer estar em um loop de espera (verificando repetidamente o status da tarefa sem iniciar um novo trabalho), ela poderá bloquear outras tarefas em estados ativos.

Como verificar: procure por tarefas com status Em execução ou Em validação que estão lá há muito tempo. O estado da tarefa pode estar impedindo que a cognição avance.

Como corrigir: resolva as tarefas paralisadas primeiro. Depois que os bloqueadores estiverem limpos, a cognição retomará a operação normal.

A cognição atribui o agente errado

A Cognition seleciona agentes com base na avaliação dos recursos do agente e dos requisitos de tarefa. Ocasionalmente, ele pode escolher um agente que não tenha as ferramentas certas para o trabalho.

Como verificar: examine o agente atribuído da tarefa e compare seu resumo de funcionalidade com o que a tarefa precisa.

Como corrigir:

  • Adicione um comentário à tarefa que especifica qual agente usar (por exemplo, "Essa tarefa requer paperAnalyzer. Ele precisa de recursos de pesquisa de literatura"). O Cognition lê os comentários ao selecionar agentes na próxima tentativa.
  • Se isso acontecer repetidamente, verifique se seus agentes têm resumos claros e descritivos de capacidades para que o sistema de cognição possa fazer seleções mais adequadas.

A cognição cria muitas subtarefas

A cognição pode decompor objetivos amplos em mais subtarefas do que o necessário.

Como corrigir:

  • Remova subtarefas que não são úteis definindo seu status como Removido.
  • Adicione um comentário à tarefa principal, orientando o Cognition a se concentrar em áreas específicas.
  • Use o padrão de exploração guiado em vez de total autonomia para dar limites de cognição.

Não é possível exibir arquivos de saída

As tarefas aparecem como Concluídas e os resultados mencionam saídas de arquivos, mas você vê erros de acesso ao clicar nos links dos arquivos.

Por que isso acontece: os agentes criam arquivos usando a identidade gerenciada da plataforma. Quando você exibe arquivos no VS Code, o navegador usa sua identidade para acessar o armazenamento de blobs diretamente. Esses são dois caminhos de acesso separados.

Três coisas devem estar em vigor para que você exiba arquivos:

Verificação Requisitos Quem corrige isso?
Network Seu IP (ou VPN) deve ser permitido pelo firewall da conta de armazenamento Administradores
CORS A conta de armazenamento deve permitir solicitações de vscode.dev e *.vscode-cdn.net Administradores
Permissões Sua conta precisa de Storage Blob Data Reader na conta de armazenamento. Administradores

Se algum deles estiver ausente, você verá um erro ao clicar em links de arquivo, mesmo que os arquivos tenham sido criados com êxito.

Como corrigir: contate o administrador com o nome da conta de armazenamento (visível nas propriedades do contêiner de armazenamento) e peça para verificar os três itens. Consulte Armazenamento de Blobs do Azure no Microsoft Discovery para obter os requisitos completos de configuração.

Observação

As sessões compartilhadas continuam funcionando corretamente, independentemente do acesso ao arquivo. Os agentes podem ler e gravar arquivos, a cognição pode validar o conteúdo do arquivo e os resultados da tarefa capturam a saída de texto. O problema de acesso afeta apenas sua capacidade de exibir arquivos diretamente.

Verificando a saúde da sessão compartilhada

Para obter uma avaliação rápida do estado da sessão compartilhada:

  • Conte as tarefas por status: quantas estão Concluídas, Novas, Em Execução ou Precisando da Atenção do Usuário?
  • Identifique os bloqueadores: existem tarefas em Execução ou Precisando da Atenção do Usuário que estão impedindo outros trabalhos?
  • Verificar o estado de cognição: o Mecanismo de Descoberta está em execução? A cognição está em um ciclo ativo?
  • Revise a atividade recente: Alguma coisa mudou nos últimos 30 minutos? Se não, algo pode estar parado.

Se você precisar de ajuda para interpretar o estado da sessão compartilhada, o histórico de execução em tarefas individuais fornecerá as informações mais detalhadas sobre o que aconteceu e por quê.

Conteúdo relacionado

  • Última atualização em