Saltar al contenido principal

Base de datos

Todos los datos persistentes viven en una única base de datos relacional, seleccionada con DB_URL en backend/.env:

BackendDB_URLNotas
SQLite (predeterminado)sqlite:///a2flow.dbArchivo local sin configuración
PostgreSQLpostgresql://user:password@host:5432/a2flowLo usa la pila de Docker Compose

El sufijo del controlador asíncrono (aiosqlite / asyncpg) se añade automáticamente. Los cambios de esquema se gestionan como migraciones versionadas de Alembic y se aplican automáticamente al arrancar: volver a desplegar la aplicación (reiniciar un contenedor) es lo que ejecuta las migraciones pendientes, así que no hace falta ningún paso de migración aparte.

La base de datos es también lo que coordina un backend con varias réplicas: una ejecución del agente mantiene un bloqueo consultivo de PostgreSQL mientras dura su flujo SSE, de modo que dos réplicas nunca dirigen a la vez la misma conversación. Consulta Escalado horizontal para saber qué protege esto y qué restricción impone al agrupamiento de conexiones.

Qué contiene​

TablaContiene
usersLos usuarios de la aplicación y los roles que se les han concedido; consulta Usuarios y grupos
auth_sessionsLas sesiones de inicio de sesión del lado del servidor
login_failuresLos inicios de sesión fallidos recientes, que se cuentan para bloquear una cuenta ante intentos repetidos de adivinar la contraseña; las filas de más de un día se eliminan
impersonation_eventsEl registro de auditoría de las sesiones de suplantación
agent_skillsLas definiciones de skills de agente y el repositorio del que se clona cada una
mcp_serversLos servidores MCP registrados y cómo llegar a ellos
knowledge_bases, knowledge_sources, knowledge_pagesLas bases de conocimiento: los documentos subidos y las URL registradas de cada una, y las páginas redactadas a partir de ellos
secretsLos conjuntos de credenciales con nombre, cifrados localmente o referenciados en Vault
workflowsLas definiciones de flujos de trabajo y su estado en el ciclo de vida
workflow_task_templatesLa lista de tareas diseñada de antemano de un flujo de trabajo
workflow_published_versionsEl diseño congelado al publicar, con el que se ejecuta un flujo de trabajo modificado
workflow_executionsUna fila por ejecución, con los metadatos del flujo de trabajo y de la skill capturados al ejecutar
workflow_tasksLas tareas individuales de una ejecución, copiadas de las plantillas
workflow_task_tool_bindingsLas herramientas MCP vinculadas a una tarea
message_metaDatos por mensaje de los dos chats compartidos: quién envió un mensaje y qué tarea estaba en curso

Eliminar un flujo de trabajo elimina en cascada sus plantillas, pero conserva intactas sus ejecuciones pasadas: una ejecución es un registro de lo que ocurrió, no parte del diseño del que procede.