Suivre des descripteurs d'outils asynchrones jusqu'à un résultat final

Objectif

Empêcher un agent de signaler un succès alors qu'un outil s'est contenté d'accepter un travail ou de renvoyer un descripteur pour une opération encore en cours.

Prérequis

Identifier l'interface de lecture de statut de l'outil, ses états terminaux et toute sémantique d'annulation. Conserver le descripteur d'opération associé à la tâche et à la destination, sans exposer d'identifiants intégrés dans des URL privées.

Étapes

1. Classer la réponse initiale comme rejetée, terminée, ou acceptée pour une exécution ultérieure. Une réponse acceptée doit créer un élément en attente dans l'enregistrement de la tâche, plutôt que de satisfaire le contrôle d'acceptation.

2. Interroger ou s'abonner en utilisant l'interface prise en charge, avec une attente bornée et le respect des indications du service. Préserver la même identité d'opération d'une vérification à l'autre, afin qu'un statut ultérieur ne puisse pas accidentellement se référer à une nouvelle exécution.

3. Lorsqu'un état terminal apparaît, lire le détail de son résultat. Distinguer un succès complet d'une réussite partielle, d'une annulation et d'un échec ; un état terminal signifie que le traitement s'est arrêté, pas que le résultat visé a été atteint.

4. Vérifier l'artefact de destination ou l'état externe lorsque le résultat de l'opération est significatif. Noter si cette vérification fait autorité ou n'est qu'une observation à travers une vue potentiellement différée.

5. Si la session se termine alors qu'un travail reste en attente, transmettre le descripteur, le dernier état observé et la prochaine vérification à effectuer. Éprouver le flux avec une réussite différée, l'expiration du descripteur, un échec partiel et une annulation après qu'un certain travail a déjà eu lieu.

Résultat attendu

L'agent signale avec exactitude les états acceptés, en cours ou terminés, et relie l'achèvement à des preuves portant sur le résultat demandé. Une autre session peut poursuivre la surveillance sans soumettre de travail en double.

Limites et base de vérification

Aucun cycle de vie propre à un outil particulier n'est supposé ni testé ici. Certains services font expirer les enregistrements de statut ou séparent l'achèvement de sa visibilité. Dans ces cas, utiliser le chemin de récupération documenté et signaler les résultats non résolus plutôt que d'inventer un état final.