Execução de uma tarefa de depuração

Quando as tarefas na sua sessão partilhada não progridem como esperado, este guia ajuda-o a identificar a causa e a agir. A maioria das questões enquadra-se em algumas categorias:

  • Tarefas que ficam presas
  • Validação demasiado rígida ou demasiado flexível
  • Erros de agente ou ferramenta
  • Comportamento cognitivo que parece inesperado

Tarefas presas em Novo estado

Uma tarefa permanece em New State. Causas comuns:

Dependências não satisfeitas

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

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

Como resolver:

  • Se a dependência estiver presa, depure essa mesma tarefa primeiro.
  • Se a dependência já não for relevante, remova-a do campo Depende de .
  • Se a dependência foi concluída mas a tarefa ainda mostrar Novo, a cognição ainda não está a trabalhar na tarefa. Espera 1-2 minutos.

A cognição não está a funcionar

O Motor de Descoberta pode ser parado.

Como verificar: Verifique se o Motor de Descoberta está a correr na sua sessão partilhada.

Como resolver: Inicia o Discovery Engine. A cognição inicia o seu ciclo de raciocínio e assume tarefas que estão prontas.

Observação

O Discovery Engine pode parar durante as atualizações de serviço. Isso é esperado. Os seus dados partilhados de sessão, resultados de tarefas e histórico de execução são preservados. Inicie novamente o Motor de Descoberta para recomeçar.

O Discovery Engine não arranca

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

Como verificar: Verifique se o seu espaço de trabalho tem um modelo de implementação de chat chamado gpt-5-4 (model: gpt-5.4).

Como resolver: Implemente o modelo (veja Criar implementação de modelo de chat), depois inicie o Discovery Engine.

A cognição está ocupada com outras tarefas

Se muitas tarefas estão em execução ou em validação, a cognição pode estar à espera de capacidade antes de começar novas.

Como verificar: Veja quantas tarefas estão atualmente em estado de Execução. Verifica se a cognição está num ciclo de espera olhando para a atividade da sessão partilhada.

Como resolver: Espere que algumas tarefas terminem. A cognição prioriza tarefas com base na prioridade e na prontidão das dependências.

Tarefas presas em estado de Execução

Uma tarefa fica em Execução enquanto um agente está a trabalhar nela. Se persistir durante um tempo invulgarmente longo, algo pode estar errado.

Tempos normais de execução

Antes de assumir que uma tarefa está bloqueada, considere o que está a acontecer:

  • Tarefas apenas para agentes (sem chamadas de ferramentas): Normalmente concluídas em menos de 1 minuto.
  • Tarefas com chamadas de ferramenta: A primeira chamada de ferramenta numa sessão pode demorar entre 2 a 4 minutos devido ao arranque a frio do supercomputador. As chamadas seguintes são mais rápidas (menos de 1 minuto).
  • Tarefas com cálculo intenso: Algumas ferramentas executam simulações ou análises em grande escala que demoram entre 5 a 15 minutos.

A resposta do agente está parada

Se uma tarefa estiver a executar há mais de 15 minutos sem qualquer atividade da ferramenta, a resposta do modelo subjacente pode estar bloqueada.

Como verificar: Veja o histórico de execução da tarefa para a execução atual. Se a resposta mostrar "em progresso" sem nova saída durante um período prolongado, é provável que a resposta fique parada na camada do modelo.

Como resolver:

  • Pára e reinicia o Discovery Engine. Isto faz com que a cognição reavalie todas as tarefas e tente novamente a que está parada.
  • Se o problema persistir, verifique se a implementação do modelo no seu espaço de trabalho está saudável.

Falha na execução da ferramenta

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

Como verificar: Veja o histórico de execução dos resultados das chamadas de ferramentas. As mensagens de erro das ferramentas normalmente incluem detalhes sobre o que correu mal.

Erros e correções comuns nas ferramentas:

Erro Causa provável Corrigir
"Execução da ferramenta falhada" sem registos O nó do supercomputador não conseguiu iniciar (SKU de VM restrito, limite de quota excedido) Verifique a configuração do seu pool de nós e a disponibilidade do SKU de VM
Tempo limite de ligação à API externa Restrições de rede na sub-rede do supercomputador Verifique se os endpoints necessários são acessíveis a partir do pool de nós. Ver Gerir Pools de Supercomputadores e Nodos
Erro de autenticação (403) Atribuição de funções em falta para o espaço de trabalho ou identidade do supercomputador Verifique se a identidade gerida tem os papéis exigidos em contas de armazenamento, registos de contentores e outros recursos
Falha ao descarregar a imagem do contentor ACR não é acessível a partir do supercomputador, ou a imagem não existe Verifique as regras da rede ACR e verifique se a imagem é enviada

Tarefas que alternam entre Em execução e Incompleto

Quando uma tarefa passa repetidamente de Executar para Incompleta e vice-versa, a cognição está a tentar novamente porque o resultado não cumpre os requisitos de validação.

Os requisitos de validação são demasiado rigorosos

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

Como verificar: Leia os comentários de validação sobre a tarefa. Cada tentativa inclui comentários que explicam quais os requisitos que foram aprovados e quais foram reprovados.

Como resolver:

  • Ajustar os requisitos de validação para serem alcançáveis com os agentes e ferramentas disponíveis.
  • Reformule os requisitos para se focar no que mais importa, em vez de exigir detalhes exaustivos.
  • Consulte Relação de confiança e padrões básicos de sessão partilhada para orientações sobre como calibrar a validação.

O agente não é capaz da tarefa

O agente designado pode não ter as ferramentas ou instruções certas para o tipo de trabalho que a tarefa exige.

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

Como resolver:

  • Se um agente diferente for mais apropriado, adicione um comentário à tarefa especificando qual agente usar e porquê (por exemplo, "Use molToolkit para esta tarefa. Requer RDKit para validação SMILES"). A cognição lê comentários ao selecionar agentes.
  • Se não existir um agente adequado, pode ser necessário criar ou configurar um. Ver conceitos de Agente de Descoberta.

A descrição da tarefa é ambígua

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

Como verificar: Leia o resultado do agente e compare com o que realmente queria. Se o resultado aborda a descrição literalmente mas falha a sua intenção, a descrição precisa de mais contexto.

Como corrigir: Atualize a descrição da tarefa com detalhes mais específicos sobre o que está a procurar, depois altere o estado para "Novo".

Tarefas assinaladas como Necessitam de Atenção do Utilizador

Quando a cognição assinala uma tarefa, significa que a cognição tentou várias abordagens e não conseguiu produzir um resultado que passe validação.

Como diagnosticar:

  1. Verifique o histórico de execuções: Quantas execuções foram realizadas? Que abordagens foram tentadas?
  2. Leia comentários de validação: Que requisitos específicos falharam em cada tentativa?
  3. Veja o resultado mais recente: É o que precisa, ou não?

Opções para resolver:

  • Aceitar o resultado: Se o resultado mais recente for suficientemente bom, atualize os requisitos de validação e marque a tarefa como Concluída.
  • Dê orientações: Adicione um comentário a explicar o que falta ou que abordagem tentar. Reverter o estado para Novo.
  • Divide a tarefa: Se a tarefa for demasiado complexa para um único agente, decompõe-a em tarefas menores.
  • Guia de seleção de agentes: Se o agente atual não tiver as capacidades certas, adicione um comentário especificando qual agente usar e por que, depois defina o estado novamente como Novo.
  • Remover a tarefa: Se a tarefa já não for relevante, defina o seu estado para Removido para que a cognição avance.

Questões cognitivas e comportamentais

O aquecimento cognitivo demora muito tempo

Quando inicia o Discovery Engine, a cognição passa por um período de aquecimento onde constrói contexto ao rever todas as tarefas e planear a sua abordagem. O aquecimento normalmente demora entre 30 a 90 segundos e envolve vários ciclos internos de raciocínio antes de começar a primeira tarefa.

Isto é um comportamento normal. Não pare e volte a ligar o Discovery Engine durante o aquecimento, pois cada reinício desencadeia um novo período de aquecimento.

A cognição continua à espera em vez de funcionar

Se a cognição parecer estar num ciclo de espera (verificando repetidamente o estado da tarefa sem iniciar novo trabalho), pode bloquear outras tarefas em estados ativos.

Como verificar: Procure tarefas em estado de Execução ou Validação que estejam lá há muito tempo. O estado da tarefa pode estar a impedir a cognição de avançar.

Como resolver: Resolve primeiro as tarefas bloqueadas. Quando os bloqueadores desaparecem, a cognição retoma o funcionamento normal.

A cognição atribui o agente errado

A Cognição seleciona os agentes com base na sua avaliação das capacidades dos agentes e dos requisitos da tarefa. Por vezes, pode escolher um agente que não tem as ferramentas certas para o trabalho.

Como verificar: Olhe para o agente atribuído à tarefa e compare o seu resumo de capacidades com o que a tarefa precisa.

Como resolver:

  • Adicione um comentário à tarefa especificando qual agente usar (por exemplo, "Esta tarefa requer paperAnalyzer. Precisa de capacidades de pesquisa de literatura"). Cognition lê os comentários ao selecionar agentes na próxima tentativa.
  • Se isto acontecer repetidamente, verifique se os seus agentes têm resumos claros e descritivos das capacidades para que a cognição possa fazer melhores escolhas.

A cognição cria demasiadas subtarefas

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

Como resolver:

  • Remove subtarefas que não são úteis definindo o seu estado para Removido.
  • Adicione um comentário à tarefa principal para orientar a cognição a focar em áreas específicas.
  • Use o padrão de exploração guiada em vez de autonomia total para dar limites cognitivos.

Não consigo visualizar ficheiros de saída

As tarefas aparecem como Concluídas e os resultados mencionam saídas de ficheiros, mas vês erros de acesso ao clicar em ligações de ficheiros.

Porque é que isto acontece: Os agentes criam ficheiros usando a identidade gerida da plataforma. Quando visualizas ficheiros no VS Code, o navegador usa a tua identidade para aceder diretamente ao armazenamento de blobs. São dois caminhos de acesso distintos.

Três coisas devem estar definidas para que possa visualizar ficheiros:

Verificar O que é preciso Quem arranja isto
Network O seu IP (ou VPN) deve ser permitido pelo firewall da conta de armazenamento Administradores
CORS A conta de armazenamento deve permitir pedidos de vscode.dev e *.vscode-cdn.net Administradores
Permissões A sua conta precisa do Storage Blob Data Reader na conta de armazenamento Administradores

Se algum destes estiver em falta, verá um erro ao clicar nos links dos ficheiros, mesmo que os ficheiros tenham sido criados com sucesso.

Como resolver: Contacte o seu administrador com o nome da conta de armazenamento (visível nas propriedades do contentor de armazenamento) e peça para verificar os três itens. Consulte Armazenamento de Blobs do Azure em Microsoft Discovery para os requisitos completos de configuração.

Observação

As sessões partilhadas continuam a funcionar corretamente independentemente do seu acesso aos ficheiros. Os agentes podem ler e escrever ficheiros, a cognição pode validar o conteúdo dos ficheiros, e os resultados das tarefas captam a saída de texto. O problema de acesso só afeta a sua capacidade de ver ficheiros diretamente.

Verificação da saúde da sessão partilhada

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

  • Contar as tarefas por estado: Quantas são Completas vs. Novas, Vs. Em Execução vs. Necessitam de Atenção do Utilizador?
  • Identificar bloqueadores: Existem tarefas em Execução ou Que Precisam de Atenção do Utilizador que estejam a atrasar outros trabalhos?
  • Verifica o estado cognitivo: O Motor de Descoberta está a funcionar? A cognição está a circular ativamente?
  • Rever atividade recente: Alguma coisa mudou nos últimos 30 minutos? Se não, algo pode ficar bloqueado.

Se precisar de ajuda para interpretar o estado partilhado da sessão, o histórico de execução de tarefas individuais fornece a informação mais detalhada sobre o que aconteceu e porquê.