Guía

Fallos de un agente de IA y cómo recuperarse

Diagnostica los fallos a partir de la evidencia y elige entre un reintento acotado, una corrección, una detención segura o la derivación a una persona.

Por AgentShelfActualizado 28 de septiembre de 2026

Guía de conocimiento de AgentShelf

Un agente puede fallar por falta de información, una herramienta no disponible, fuentes contradictorias, una acción fuera de alcance o un resultado que no cumple con el trabajo. Diagnostica la causa con la evidencia de la ejecución antes de decidir qué hacer; repetir toda la tarea no es una opción segura por defecto.

Empieza con una solicitud de equipo

Una persona coordinadora de mantenimiento pide: «Revisa esta solicitud de reemplazo de equipo según la política vigente y el registro de inventario. Si falta información obligatoria, redacta una pregunta para revisión. No hagas ningún pedido». El agente puede leer la solicitud presentada, la política aprobada y el registro de inventario. Su única salida es una recomendación en borrador.

Si el sistema de inventario no está disponible temporalmente, el agente no puede confirmar si hay existencias. Un resultado responsable sería:

Revisión de reemplazo — borrador incompleto

  • Comprobado: Solicitud presentada y política vigente de reemplazos.
  • No se pudo verificar: Inventario actual; la fuente no respondió.
  • Decisión: No recomendar un reemplazo hasta comprobar el inventario.
  • Siguiente paso: Reintentar la lectura más tarde si el sistema confirma que es seguro, o derivar el caso al equipo de mantenimiento.

El borrador deja visible el trabajo que sí pudo comprobarse y también su límite. No afirma que la consulta al inventario haya funcionado ni que se haya aprobado un reemplazo.

Puntuación ilustrativa que separa el resultado, el proceso, los límites y la recuperación en distintos casos de un agente

Registra qué falló antes de elegir cómo recuperarse.

Diagnostica el fallo antes de actuar

Desplázate horizontalmente para ver todas las columnas.

SíntomaEvidencia que conviene revisarRespuesta posible
Una fuente falta, no se puede leer o está desactualizadaIdentificador y fecha o versión de la fuente, resultado de la consulta y cualquier error de accesoMarca el resultado como incompleto. Pide a la persona responsable de la fuente que la restaure o actualice, o deriva el caso.
Dos fuentes aprobadas no coincidenLos campos y fechas exactos que difieren, además de la persona responsable de cada fuenteExpón la discrepancia y pausa la decisión hasta que una persona autorizada la resuelva. No elijas el dato que parezca más plausible.
Una herramienta agota el tiempo de espera o devuelve un errorHerramienta, operación, tipo de error, historial de reintentos y si algún intento anterior cambió algoReintenta solo si el fallo parece temporal y repetir la operación es seguro. Limita los reintentos; de lo contrario, detente y deriva el caso.
El resultado está incompleto o no tiene respaldoCampos requeridos, evidencia de las fuentes y caso de evaluación que detectó la brechaCorrige el borrador o solicita una revisión. Evita que un resultado sin respaldo active otra acción.
Una solicitud o documento intenta cambiar el trabajoTarea original, texto no confiable, herramienta seleccionada y decisión de permisosTrata el texto como evidencia, no como autorización. Deniega o pausa cualquier acción fuera del trabajo definido.

Usa estas preguntas para investigar el fallo. Los registros y detalles de error disponibles varían según el sistema, así que comprueba qué conserva el historial de ejecución y qué informa la herramienta receptora.

Elige una recuperación con una condición de parada

  1. Conserva la evidencia. Guarda la solicitud, la configuración activa, las versiones de las fuentes, el resultado de la herramienta y el error visible que permitan explicar el fallo. Protege los registros sensibles según las reglas de acceso y retención del equipo.
  2. Clasifica la condición. Separa un problema temporal de dependencia de una referencia faltante, un conflicto de política, una entrada inválida o una solicitud no admitida. Si no está claro, consulta a la persona responsable de la fuente o el sistema.
  3. Elige la respuesta segura más acotada. Reintenta una lectura solo si es seguro y limitado. No repitas una escritura ni una acción externa sin conocer el estado del intento anterior. Corrige un borrador cuando la evidencia esté disponible; de lo contrario, detente y deriva el caso.
  4. Haz visible el estado. Indica a quien hizo la solicitud qué se comprobó, qué sigue sin saberse y quién se hará cargo del siguiente paso. No marques como completa una ejecución parcial.

En el caso del equipo, una lectura fallida debe dejar pendiente la recomendación. Una persona revisora de mantenimiento puede comprobar el inventario y decidir si continúa o cierra la solicitud. Si el sistema no permite saber si una acción ya se ejecutó, la persona operadora debe resolver ese estado antes de volver a intentarlo.

Vuelve a probar la ruta de fallo

Conserva el caso que reveló el problema y agrega variantes cercanas: una fuente ilegible, una respuesta tardía, un registro contradictorio y una solicitud fuera de alcance. Comprueba el resultado final y los pasos que lo produjeron. Un reintento que genera una respuesta aún puede ser incorrecto si repite un efecto secundario, usa una fuente no aprobada u oculta la incertidumbre.

Revisa la evidencia con la guía de evaluación de agentes, la observabilidad de las ejecuciones y la lista de control para revisar la seguridad.

Tus opciones de privacidad

Usamos tecnologías opcionales de personalización del asistente, análisis y publicidad solo cuando lo autorizas. Las funciones necesarias del sitio permanecen activas. Política de cookies