La IA muestra «falló la ejecución»: ¿por qué no puede volver a intentarlo sin más?
Un tiempo de espera agotado no prueba que la operación fallara. Cómo comprobar resultados y usar la idempotencia para evitar envíos duplicados.
Le pides a una IA que guarde un artículo. Después de esperar un rato, aparece en pantalla «Tiempo de espera agotado». Respondes: «Inténtalo otra vez».
La segunda vez todo sale bien. Pero, al abrir el panel de administración, encuentras dos borradores con el mismo contenido.
Es un escenario hipotético, pero refleja un problema técnico real: que una herramienta no haya recibido el resultado no significa que la operación no se haya ejecutado en el sistema remoto. Cuando una IA empieza a operar sitios web, llamar a interfaces o crear recursos, esa diferencia afecta directamente al resultado.
El artículo anterior, «¿Cuanto más contexto le damos a la IA, mejores son sus respuestas?», trataba sobre cómo traspasar tareas largas. Este continúa desde ahí: si en el registro del traspaso aparece «falló», ¿la IA que retoma el trabajo debe repetir la operación o comprobar primero qué ocurrió?
Un tiempo de espera agotado solo indica que este extremo no recibió el resultado a tiempo
Guardar un borrador comprende, como mínimo, varios pasos: el cliente envía la solicitud, la plataforma la recibe y procesa, la plataforma devuelve un resultado, y el cliente lo recibe y registra.
El «tiempo de espera agotado» puede producirse en distintos puntos. Si la solicitud nunca llegó, es posible que no se haya creado nada. Pero también puede que el borrador ya se haya guardado y la conexión se haya interrumpido mientras volvía la respuesta. O puede que la solicitud siga procesándose aunque el cliente haya dejado de esperar.
Esas palabras, por sí solas, no permiten distinguir entre los casos.
Al explicar los reintentos seguros, AWS utiliza un ejemplo parecido sobre la creación de una instancia en la nube: si quien hace la llamada no recibe una respuesta, no puede saber si la instancia ya se creó. Reintentar directamente puede producir varias instancias; hace falta comprobar el estado real o contar con la capacidad de idempotencia de la interfaz.[1]
Con las herramientas de IA ocurre lo mismo. Un mensaje de error rojo en la interfaz puede referirse a la comunicación, a la interpretación del resultado o al tiempo de espera, sin describir necesariamente el estado completo de la operación solicitada.
Por eso, prefiero dividir el registro en estas categorías:
| Pruebas disponibles | Qué se puede concluir | Siguiente paso |
|---|---|---|
| La validación local rechazó la solicitud y consta que aún no se había enviado | Esta solicitud no se ejecutó | Corregir los datos y volver a enviarla |
| El sistema remoto devolvió un error y confirmó que no hubo cambios | No se completó el objetivo en este intento | Actuar según la causa del error |
| Se agotó el tiempo de espera o se cortó la conexión, sin conocer el estado remoto | El resultado es desconocido | Consultar si existe un resultado o recuperar la operación según las reglas de la interfaz |
| Se recibió un identificador de objeto, pero aún no se ha consultado | Se obtuvo una confirmación de creación | Consultar el objeto y su estado mediante el identificador |
| Se consultó el objeto y su contenido y estado coinciden con lo esperado | El paso correspondiente está completo | Registrar el resultado y continuar con los pasos siguientes |
Una interfaz concreta puede contemplar estados como el éxito parcial o los trabajos asíncronos; hay que atenerse a su documentación. Lo importante de la tabla es reservar un lugar para «resultado desconocido», sin apresurarse a clasificarlo como fallo.
«Inténtalo otra vez» puede crear un segundo objeto
Leer dos veces un artículo normalmente no genera otro artículo. En cambio, cada llamada repetida a «crear borrador» puede producir un objeto nuevo.
En términos técnicos, «idempotencia» describe una propiedad por la cual repetir una misma operación no causa efectos adicionales sobre el resultado de negocio. Lo que importa aquí es el efecto final; no es necesario que el texto de cada respuesta sea idéntico.[1]
Pero que la IA diga «evitaré los duplicados» no significa que la plataforma ofrezca esa capacidad.
Algunas interfaces admiten claves de idempotencia. Quien llama genera un identificador para una operación concreta y lo reutiliza al reintentarla; así, el servidor puede reconocer que se trata de la misma operación. La documentación de Stripe explica este mecanismo: tras un error de conexión, una clave de idempotencia permite reintentar una solicitud de creación o actualización sin provocar duplicaciones accidentales.[2]
La clave está en reutilizar el mismo identificador para la misma operación. Si se genera una clave nueva en cada intento, el servidor puede interpretarlos como solicitudes distintas. A la inversa, si el usuario quiere crear dos borradores con el mismo contenido, no corresponde fusionarlos por iniciativa propia. AWS también señala que unos parámetros idénticos no siempre implican una intención de negocio idéntica.[1]
Estas garantías tienen, además, un alcance y una duración. En Stripe API v1, por ejemplo, la documentación indica que las claves pueden eliminarse una vez conservadas durante al menos 24 horas; reutilizar una clave eliminada puede dar lugar a una solicitud nueva. También se comparan los parámetros asociados a una misma clave. El tratamiento de los resultados de los reintentos difiere entre v1 y v2, de modo que no se puede tomar el comportamiento de una versión como regla general para todas las interfaces.[2]
Por tanto, lo que hay que confirmar es si esa interfaz concreta admite el mecanismo, a qué operaciones se aplica, cuánto tiempo se conserva el identificador y cómo debe recuperarse la operación tras un error.
Sin una interfaz idempotente, también se puede comprobar primero el resultado
Muchos paneles de administración solo permiten operar desde la web o no documentan públicamente ningún mecanismo contra duplicados. En esos casos, se puede intentar localizar el resultado del intento anterior antes de reintentar.
Si se obtuvo un identificador del borrador, se consulta por ese identificador. Si solo quedó un identificador de tarea, se comprueba su progreso. Solo cuando no se dispone de ninguno de los dos conviene buscar combinando cuenta, título, hora de creación, contenido y estado deseado.
El título por sí solo no basta. Puede haber una versión anterior o revisada del mismo artículo, y también puede que se necesiten dos borradores. Encontrar un objeto con el mismo título es una pista, no una prueba de que sea el que acaba de crearse.
Del mismo modo, que todavía no aparezca en una lista no permite concluir de inmediato que el envío falló. Es posible que la solicitud siga procesándose o que la vista de consulta aún no muestre el resultado más reciente. Hay que esperar o comprobar el estado de la tarea según las indicaciones de la plataforma, en vez de pulsar «Crear» repetidamente.
Hay otro límite fácil de pasar por alto: «consultar primero y crear si no existe» no equivale a una protección estricta contra duplicados. Dos ejecutores pueden consultar al mismo tiempo, no encontrar nada y crear cada uno un objeto. Conviene evitar que varias tareas envíen simultáneamente operaciones sobre el mismo objeto. Si se necesita una garantía a nivel de sistema, hay que recurrir a mecanismos de idempotencia del servidor, restricciones de unicidad u otros diseños de coordinación.
Si al final sigue siendo imposible confirmarlo y no existe una regla fiable para evitar duplicados, es mejor dejar ese paso como «resultado desconocido» e indicar qué se ha consultado. Detenerse ante la incertidumbre es más fácil de resolver que crear un segundo objeto y luego intentar adivinar cuál borrar.
En tareas multiplataforma, hay que registrar el progreso de cada destino
Supongamos que una tarea pide publicar definitivamente un artículo en un sitio web y guardar un borrador tanto en una cuenta pública de WeChat como en Zhihu.
El sitio web ya está listo y el borrador de WeChat se guardó correctamente, pero la conexión se corta al llegar a Zhihu. Volver a ejecutar el proceso completo podría repetir también los dos pasos ya terminados.
Yo separaría el registro de ejecución por destino: para el sitio web, la dirección del artículo y el resultado de la comprobación en línea; para WeChat, el identificador del borrador y el resultado de consultarlo; para Zhihu, lo que se sabe del envío y lo que queda por comprobar. Cada entrada también debería indicar a qué versión del artículo corresponde, para no tomar una confirmación relativa al texto anterior como prueba de que se guardó el nuevo.
«Guardado correctamente» debe referirse, además, a un objetivo concreto. Si el usuario pidió un borrador, se verifica que exista, que el contenido sea correcto y que siga en estado de borrador. Si pidió una publicación pública, se verifica la página pública o el estado de publicación oficial de la plataforma. Un guardado correcto no equivale automáticamente a una publicación correcta.
Lo mejor es guardar estos registros durante la ejecución. Si solo se escribe «todo completado» al final de la tarea, una interrupción a mitad del proceso dejará sin registrar precisamente la información más necesaria para reanudarlo.
Sin embargo, un registro local tampoco ofrece una garantía absoluta: puede producirse una interrupción entre el éxito de la operación remota y la escritura local. Al recuperar la tarea, hay que contrastar el registro con el estado remoto; la ausencia de una línea en el registro local no demuestra que la operación remota no se haya realizado.
Al reanudar la tarea, se pueden dar instrucciones más precisas
Ante una interrupción, se puede indicar lo siguiente:
Lee primero el registro de ejecución existente y comprueba, paso por paso, el estado remoto. Omite los pasos completados y verificados. Para los pasos con tiempo de espera agotado o sin confirmación, consulta primero el resultado; vuelve a enviarlos solo si se confirma que no se ejecutaron o si la interfaz admite expresamente un reintento seguro. Al final, enumera por separado los pasos completados, los fallidos y aquellos cuyo resultado sigue siendo desconocido.
Estas instrucciones aclaran el orden de actuación, pero no son una garantía técnica contra duplicados. La herramienta sigue necesitando poder consultar el estado, el registro de ejecución debe conservarse y las limitaciones de la interfaz siguen vigentes.
Si se está desarrollando una herramienta de IA, se pueden simular específicamente en un entorno de pruebas estos casos: que se pierda la respuesta después de que el sistema remoto guarde el objeto, que el proceso termine antes de recibir la confirmación o que dos ejecutores reanuden la misma tarea al mismo tiempo. Lo importante es comprobar si aparecen objetos de más, si se puede identificar el resultado original y si el informe describe correctamente lo ocurrido. En este artículo no se han realizado esas pruebas de fallos, por lo que tampoco se promete que una herramienta determinada no vaya a repetir operaciones.
Para quien utiliza la herramienta, el cambio más valioso es pequeño: al ver «falló», preguntar primero en qué punto se produjo el fallo. A veces, el paso ya se completó y solo falta comprobarlo.
Referencias
Fecha de consulta de las fuentes: 11 de noviembre de 2026. Los escenarios de borradores, los métodos de registro y el texto de instrucciones de este artículo son ejemplos de diseño; el comportamiento de cada interfaz debe consultarse en la documentación del producto y la versión correspondientes.
- AWS Builders’ Library: Making retries safe with idempotent APIs, análisis de diseño sobre la ausencia de respuesta, los efectos secundarios de los duplicados, los identificadores de solicitud de quien llama, los cambios de parámetros y los plazos de conservación.
- Stripe API Reference: Idempotent requests, explicación de las claves de idempotencia, la validación de parámetros, la eliminación de claves en API v1 y las diferencias de comportamiento entre v1 y v2.
Ilustración conceptual generada con IA, no una fotografía de pruebas ni un diagrama de topología de red.
Discussion
Share a question or your experience. Comments appear after moderation. Your email is never displayed publicly. Comment privacy
Loading comments…