Déboguer l’exécution de la tâche

Lorsque les tâches de votre session partagée ne progressent pas comme prévu, ce guide vous aide à identifier la cause et à prendre des mesures. La plupart des problèmes se trouvent dans quelques catégories :

  • Tâches bloquées
  • Validation trop stricte ou trop lâche
  • Erreurs de l’agent ou de l’outil
  • Comportement cognitif qui semble inattendu

Tâches bloquées dans l’état Nouveau

Une tâche reste dans l’état Nouveau. Causes courantes :

Dépendances non satisfaites

La tâche dépend d’une autre tâche qui n’est pas dans un état final.

Comment vérifier : ouvrez la tâche et examinez le champ Dépend de. Vérifiez l’état de chaque dépendance.

Guide pratique pour résoudre les problèmes suivants :

  • Si la dépendance est bloquée, déboguez d’abord cette tâche.
  • Si la dépendance n’est plus pertinente, supprimez-la du champ Depends on .
  • Si la dépendance s’est terminée mais que la tâche s’affiche toujours comme Nouveau, cela signifie que Cognition ne fonctionne pas encore sur la tâche. Attendez 1 à 2 minutes.

Cognition ne fonctionne pas

Le moteur de découverte est peut-être à l’arrêt.

Comment vérifier : vérifiez que le moteur de découverte s’exécute dans votre session partagée.

Guide pratique pour résoudre les problèmes suivants : démarrez le moteur de découverte. Cognition démarre sa boucle de raisonnement et récupère les tâches prêtes.

Note

Le moteur de découverte peut s’arrêter pendant les mises à niveau de service. Ceci est attendu. Vos données de session partagées, les résultats des tâches et l’historique d’exécution sont conservés. Redémarrez le moteur de découverte pour reprendre.

Le moteur de découverte ne démarre pas

Le modèle de conversation requis pour la validation des tâches peut ne pas être déployé.

Comment vérifier : vérifiez que votre espace de travail dispose d’un déploiement de modèle de conversation nommé gpt-5-4 (modèle : gpt-5.4).

Guide pratique pour résoudre les problèmes suivants : déployer le modèle (voir Créer un déploiement de modèle de conversation), puis démarrer le moteur de découverte.

La cognition est occupée avec d’autres tâches

Si de nombreuses tâches s'exécutent ou sont en cours de validation, la cognition peut attendre que des ressources soient disponibles avant de commencer de nouvelles tâches.

Comment vérifier : examinez le nombre de tâches actuellement en cours d’exécution. Vérifiez si la cognition est dans un cycle d’attente en examinant l’activité de session partagée.

Guide pratique pour corriger : attendez que certaines tâches se terminent. La cognition hiérarchise les tâches en fonction de la priorité et de la préparation à la dépendance.

Tâches bloquées dans l’état d’exécution

Une tâche reste en cours d’exécution pendant qu’un agent travaille dessus. S’il persiste pendant une période inhabituellement longue, quelque chose peut être incorrect.

Temps d’exécution normaux

Avant de supposer qu’une tâche est bloquée, tenez compte de ce qui se passe :

  • Tâches uniquement de l’agent (aucun appel d’outil) : se termine généralement en moins de 1 minute.
  • Tâches avec appels d’outils : l’appel d’un premier outil dans une session peut prendre 2 à 4 minutes en raison d’un démarrage froid de supercalculateur. Les appels suivants sont plus rapides (moins de 1 minute).
  • Tâches avec calcul lourd : certains outils exécutent des simulations ou une analyse à grande échelle qui prennent 5 à 15 minutes.

La réponse de l’agent est bloquée

Si une tâche s’exécute depuis plus de 15 minutes sans activité d’outil, la réponse du modèle sous-jacente peut être bloquée.

Comment vérifier : examinez l’historique d’exécution de la tâche pour l’exécution actuelle. Si la réponse indique « en cours » sans nouvelle sortie pendant une période prolongée, la réponse est probablement bloquée au niveau de la couche modèle.

Guide pratique pour résoudre les problèmes suivants :

  • Arrêtez et redémarrez le moteur de découverte. Cela entraîne la cognition à réévaluer toutes les tâches et à réessayer celle qui est en attente.
  • Si le problème persiste, vérifiez si le déploiement du modèle dans votre espace de travail est sain.

Échec de l’exécution de l’outil

L’agent a appelé un outil, mais l’outil a retourné une erreur.

Guide pratique pour vérifier : examinez l’historique d’exécution des résultats des appels d’outil. Les messages d’erreur provenant d’outils incluent généralement des détails sur ce qui s’est passé.

Erreurs et correctifs courants de l’outil :

Error Cause probable Réparer
Échec de l’exécution de l’outil sans aucun fichier de log Le nœud supercomputer n’a pas pu démarrer (référence SKU de machine virtuelle restreinte, quota dépassé) Vérifier la configuration de votre pool de nœuds et la disponibilité de la référence SKU de machine virtuelle
Expiration de temps de connexion à l’API externe Restrictions réseau sur le sous-réseau de supercomputer Vérifiez que les points de terminaison requis sont accessibles à partir du pool de nœuds. Voir Gérer les supercomputers et les pools de nœuds
Erreur d’authentification (403) Assignation de rôle manquante pour l’identité de l’espace de travail ou du supercalculateur Vérifiez que l’identité managée a les rôles requis sur les comptes de stockage, les registres de conteneurs et d’autres ressources
Échec d’extraction de l’image de conteneur ACR non accessible à partir d’un supercalculateur, ou l’image n’existe pas Vérifier les règles réseau ACR et s’assurer que l’image est envoyée (push)

Tâches alternant entre Exécution et Incomplet

Lorsqu’une tâche passe à plusieurs reprises de l’état En cours d’exécution à l’état Incomplet, et inversement, cela signifie que Cognition effectue une nouvelle tentative car le résultat ne satisfait pas aux exigences de validation.

Les exigences de validation sont trop strictes

L’agent produit des résultats raisonnables, mais ils ne correspondent pas précisément à la demande des critères de validation.

Guide pratique pour vérifier : lire les commentaires de validation sur la tâche. Chaque tentative inclut des commentaires expliquant quelles exigences ont été satisfaites et lesquelles ont échoué.

Guide pratique pour résoudre les problèmes suivants :

  • Ajustez les exigences de validation pour qu’elles soient réalisables avec les agents et outils disponibles.
  • Réécrire les exigences pour se concentrer sur ce qui importe le plus au lieu d’exiger des détails exhaustifs.
  • Consultez Relation de confiance et modèles de session partagée de base pour obtenir des conseils sur le calibrage de la validation.

L’agent n’est pas capable de la tâche

L’agent affecté n’a peut-être pas les bons outils ou instructions pour le type de travail requis par la tâche.

Comment vérifier : identifiez quel agent a été assigné par Cognition. Vérifiez si l’agent dispose des outils nécessaires pour la tâche. Comparez le résumé des fonctionnalités de l’agent avec les exigences de tâche.

Guide pratique pour résoudre les problèmes suivants :

  • Si un autre agent serait plus approprié, ajoutez un commentaire à la tâche spécifiant l’agent à utiliser et pourquoi (par exemple, « Utiliser molToolkit pour cette tâche. Il nécessite la validation RDKit pour SMILES »). La cognition lit les commentaires lors de la sélection d’agents.
  • Si aucun agent approprié n’existe, vous devrez peut-être en créer ou en configurer un. Consultez Concepts des agents Discovery.

La description de la tâche est ambiguë

Si la description de la tâche ne donne pas suffisamment de contexte à l’agent, l’agent peut produire des résultats techniquement valides, mais manquer le point.

Comment vérifier : lisez le résultat de l’agent et comparez-le à ce que vous vouliez réellement. Si le résultat traite littéralement la description, mais manque votre intention, la description a besoin d’un plus grand contexte.

Guide pratique pour corriger : Mettez à jour la description de la tâche avec des détails plus spécifiques sur ce que vous recherchez, puis définissez l’état sur Nouveau.

Tâches marquées comme ayant besoin d’attention de l’utilisateur

Lorsque la cognition signale une tâche, cela signifie que la cognition a essayé plusieurs approches et n’a pas pu produire un résultat qui réussit la validation.

Comment diagnostiquer :

  1. Vérifier l’historique des exécutions : combien d’exécutions ont été tentées ? Quelles approches ont été tentées ?
  2. Lire les commentaires de validation : Quelles exigences spécifiques ont échoué lors de chaque tentative ?
  3. Passez en revue le dernier résultat : Est-ce que cela correspond à vos besoins, ou pas ?

Options de résolution :

  • Acceptez le résultat : si le résultat le plus récent est suffisant, mettez à jour les exigences de validation et marquez la tâche Terminée.
  • Fournissez des conseils : ajoutez un commentaire expliquant ce qui manque ou quelle approche essayer. Rétablissez l’état à Nouveau.
  • Décomposez la tâche : si la tâche est trop complexe pour un seul agent, décomposez-la en tâches enfants plus petites.
  • Sélection de l’agent de guide : si l’agent actuel n’a pas les fonctionnalités appropriées, ajoutez un commentaire spécifiant l’agent à utiliser et pourquoi, puis définissez l’état sur Nouveau.
  • Supprimer la tâche : si la tâche n’est plus pertinente, définissez son état sur Removed afin que la cognition se déplace.

Problèmes liés au comportement cognitif

L’échauffement de la cognition prend beaucoup de temps

Lorsque vous démarrez le moteur de découverte pour la première fois, la cognition passe par une période de préchauffe où elle génère le contexte en examinant toutes les tâches et en planifiant son approche. La préchauffe prend généralement 30 à 90 secondes et implique plusieurs cycles de raisonnement interne avant le début de la première tâche.

Il s’agit d’un comportement normal. N’arrêtez pas et redémarrez le moteur de découverte pendant le préchauffement, car chaque redémarrage déclenche une nouvelle période de préchauffement.

La cognition continue d’attendre au lieu de travailler

Si la cognition semble être dans une boucle d’attente (vérification répétée de l’état de la tâche sans démarrer de nouveau travail), elle peut bloquer d’autres tâches dans des états actifs.

Comment vérifier : recherchez des tâches en cours d'exécution ou de validation qui y sont depuis longtemps. L’état de la tâche peut empêcher la cognition d’avancer.

Guide pratique pour résoudre les problèmes : résolvez d’abord les tâches bloquées. Une fois les bloqueurs effacés, la cognition reprend l’opération normale.

La cognition attribue le mauvais agent

La cognition sélectionne les agents en fonction de son évaluation des fonctionnalités de l’agent et des exigences de tâche. Parfois, il peut choisir un agent qui n’a pas les bons outils pour le travail.

Guide pratique pour vérifier : examinez l’agent affecté de la tâche et comparez son résumé des fonctionnalités à ce dont la tâche a besoin.

Guide pratique pour résoudre les problèmes suivants :

  • Ajoutez un commentaire à la tâche spécifiant l’agent à utiliser (par exemple, « Cette tâche nécessite paperAnalyzer. Il a besoin de fonctionnalités de recherche de littérature »). Cognition lit les commentaires lorsqu’il sélectionne les agents lors de la tentative suivante.
  • Si cela se produit à plusieurs reprises, vérifiez que vos agents ont des résumés de capacités claires et descriptives afin que la cognition puisse améliorer les sélections.

La cognition crée trop de tâches subordonnées

La cognition peut décomposer de vastes objectifs en plus de sous-tâches que nécessaire.

Guide pratique pour résoudre les problèmes suivants :

  • Supprimez les tâches subordonnées qui ne sont pas utiles en définissant leur état sur Removed.
  • Ajoutez un commentaire à la tâche parente pour guider Cognition et l’amener à se concentrer sur des domaines spécifiques.
  • Utilisez le modèle d’exploration guidée au lieu d’une autonomie totale pour donner des limites cognitives.

Impossible d’afficher les fichiers de sortie

Les tâches apparaissent comme étant terminées et les résultats mentionnent des sorties de fichier, mais vous rencontrez des erreurs d'accès lorsque vous cliquez sur les liens de fichier.

Pourquoi cela se produit : les agents créent des fichiers à l’aide de l’identité managée de la plateforme. Lorsque vous affichez des fichiers dans VS Code, le navigateur utilise votre identité pour accéder directement au stockage Blob. Il s’agit de deux chemins d’accès distincts.

Trois éléments doivent être en place pour vous permettre d’afficher les fichiers :

Vérifier De quoi ai-je besoin ? Qui le répare
Réseau Votre adresse IP (ou VPN) doit être autorisée par le pare-feu du compte de stockage Administrator
CORS Le compte de stockage doit autoriser les demandes depuis vscode.dev et *.vscode-cdn.net Administrator
Permissions Votre compte doit disposer du rôle Lecteur des données blob du stockage sur le compte de stockage Administrator

Si l’un de ces éléments est manquant, une erreur s’affiche lorsque vous cliquez sur des liens de fichier, même si les fichiers ont été créés avec succès.

Guide pratique pour corriger : contactez votre administrateur avec le nom du compte de stockage (visible dans les propriétés du conteneur de stockage) et demandez-lui de vérifier les trois éléments. Consultez Stockage Blob Azure dans Microsoft Découverte pour connaître les exigences de configuration complètes.

Note

Les sessions partagées continuent de fonctionner correctement, quel que soit l’accès à votre fichier. Les agents peuvent lire et écrire des fichiers, la cognition peut valider le contenu du fichier et les résultats des tâches capturent la sortie de texte. Le problème d’accès affecte uniquement votre capacité à afficher les fichiers directement.

Vérification de l’état de la session partagée

Pour une évaluation rapide de l’état de votre session partagée :

  • Compter les tâches par état : combien sont terminées, nouvelles, en cours d'exécution, nécessitant l'attention de l'utilisateur ?
  • Identifier les bloqueurs : Existe-t-il des tâches en cours d'exécution ou nécessitant une attention de l'utilisateur qui bloquent d'autres travaux ?
  • Vérifier l’état de la cognition : Le moteur de découverte est-il en cours d’exécution ? La cognition est-elle en cycle actif ?
  • Passer en revue l’activité récente : quelque chose a-t-il changé au cours des 30 dernières minutes ? Si ce n’est pas le cas, quelque chose peut être bloqué.

Si vous avez besoin d’aide pour interpréter l’état de session partagée, l’historique d’exécution sur les tâches individuelles fournit les informations les plus détaillées sur ce qui s’est passé et pourquoi.

Contenu connexe

  • Dernière mise à jour :