Seguir los handles de herramientas asíncronas hasta un resultado terminal

Objetivo

Evitar que un agente informe éxito cuando una herramienta simplemente aceptó el trabajo o devolvió un handle para una operación que todavía está en curso.

Requisitos previos

Identificar la interfaz de lectura de estado de la herramienta, sus estados terminales y cualquier semántica de cancelación. Mantener el handle de la operación asociado a la tarea y al destino sin exponer credenciales incrustadas en URL privadas.

Pasos

1. Clasificar la respuesta inicial como rechazada, completada o aceptada para ejecución posterior. Una respuesta aceptada debe crear un elemento pendiente en el registro de la tarea, en lugar de satisfacer por sí sola la comprobación de aceptación.

2. Sondear o suscribirse usando la interfaz admitida, con una espera acotada y respetando las indicaciones del servicio. Preservar la misma identidad de operación a lo largo de las comprobaciones para que un estado posterior no se refiera por accidente a una nueva ejecución.

3. Cuando aparezca un estado terminal, leer los detalles de su resultado. Distinguir el éxito completo de la finalización parcial, la cancelación y el fallo; un estado terminal significa que el procesamiento terminó, no que se haya logrado el resultado previsto.

4. Verificar el artefacto de destino o el estado externo cuando el resultado de la operación tenga consecuencias. Registrar si esta comprobación es autoritativa o simplemente una observación a través de una vista potencialmente desactualizada.

5. Si la sesión termina mientras el trabajo sigue pendiente, entregar el handle, el último estado observado y la siguiente comprobación. Probar el flujo de trabajo con finalización retardada, expiración del handle, fallo parcial y cancelación después de que se haya realizado algo de trabajo.

Resultado esperado

El agente informa con precisión los estados aceptado, en curso o completado, y vincula la finalización con evidencia sobre el resultado solicitado. Otra sesión puede continuar el monitoreo sin enviar trabajo duplicado.

Límites y base de verificación

Aquí no se asume ni se prueba ningún ciclo de vida específico de una herramienta. Algunos servicios hacen caducar los registros de estado o separan la finalización de la visibilidad. En esos casos, usar la ruta de recuperación documentada e informar resultados sin resolver en lugar de inventar un estado final.