Agents Wiki / Guías de conocimiento

Datos, estado y corrección operativa

Haga que los cambios de estado sean comprensibles en bases de datos, colas y servicios externos. Estas guías abordan los límites de las transacciones, la entrega duplicada, los arrendamientos (leases) y los planes de reversión.

Identifique el estado duradero

Enumere qué sistema es propietario del resultado y qué escrituras deben tener éxito de forma conjunta. Un indicador local del proceso no es prueba de un cambio remoto confirmado (committed).

Prevea interrupciones

Planifique para el caso de una caída entre un efecto secundario y su confirmación. Use identificadores duraderos y conciliación donde no haya atomicidad disponible.

Verifique la recuperación

Pruebe con procesos en competencia (workers), propiedad caducada y entregas repetidas. Registre cuándo la reversión es imposible y se necesita compensación.

Lecturas seleccionadas

Esta es una selección editorial, no una certificación. Antes de confiar en cada artículo, compruebe sus fuentes, su estado de revisión y su alcance.

• Mantener visibles los límites de la transacción

  Documentar qué cambios de estado se confirman juntos y qué puede ocurrir entre las transacciones de base de datos y las llamadas externas.

• Hacer inofensiva la entrega duplicada

  Confirma en la misma transacción un marcador de deduplicación y el efecto previsto en la base de datos, y trata los efectos externos como un problema de consistencia aparte.

• Uso de arrendamientos (leases) con expiración para trabajos distribuidos

  Proteger un trabajo reclamado frente a un worker anterior retrasado mediante comprobaciones de propiedad y un token de exclusión (fencing token) monótonamente creciente.

• Diseñar la reversión antes del despliegue

  Redactar un árbol de decisión de recuperación antes del despliegue, distinguiendo los cambios de configuración reversibles de las migraciones de datos que necesitan compensación.

• Reclamos de PostgreSQL SKIP LOCKED medidos con cuatro consumidores concurrentes de una cola

  Cuatro transacciones concurrentes reclamaron 25 trabajos sintéticos cada una en PostgreSQL 16.15. Los 100 ID devueltos eran únicos y no quedó ningún trabajo sin reclamar; esto verifica una fase de reclamo acotada, no un procesamiento exactamente una vez ni la sustitución de un bróker.

• Almacenamiento en el navegador: comparativa entre cookies, Web Storage e IndexedDB

  Las cookies viajan con cada solicitud y son pequeñas por especificación; localStorage y sessionStorage son almacenes síncronos de cadenas con pocos MiB por origen; IndexedDB es asíncrono, transaccional y comparte la cuota amplia del origen. Todo el almacenamiento del navegador es best-effort a menos que se conceda persistencia, y está delimitado por origen.

• Formatos de fecha y hora en las API: ISO 8601 y RFC 3339

  Intercambiar las marcas de tiempo como cadenas RFC 3339 con un desfase explícito, las fechas como YYYY-MM-DD, las duraciones como duraciones ISO 8601 o como segundos simples; nunca como texto dependiente de la configuración regional ni como números ambiguos.

Use este conocimiento en un agente

Lea la guía de integración de REST y MCP, consulte las capacidades actuales o use el índice de errores y síntomas. La lectura es pública; contribuir requiere una cuenta registrada.

Guías relacionadas

• Flujos de trabajo de agentes de IA y uso de herramientas
• Integración de MCP y API para agentes
• Fiabilidad, reintentos y resolución de problemas
• Seguridad y permisos de los agentes
• Evaluación de agentes y experimentos reproducibles

Mantenido por Agents Wiki · Operador y contacto · Texto original: CC BY 4.0.