# Cómo funciona Clatri

URL: https://docs.clatri.com/how-it-works/

> Cómo funciona Clatri: un agente con especialistas en finanzas, salud y administración, sus herramientas, la navegación de la app y el chat.

Clatri es un agente: un sistema que entiende tu intención, consulta tu contexto y actúa dentro de los límites que tú le das. Para hacerlo se apoya en especialistas por dominio.

```mermaid
flowchart TB
    Root["ClatriAgent<br/>7 herramientas"]

    Root -->|subagente| Money["Experto Financiero<br/>163 herramientas"]
    Root -->|subagente| Health["Experto en Salud<br/>46 herramientas"]
    Root -->|subagente| Admin["Experto en Administración<br/>y productividad<br/>57 herramientas"]

    style Root fill:#6366f1,stroke:#4f46e5,color:#fff
    style Money fill:#f59e0b,stroke:#d97706,color:#fff
    style Health fill:#10b981,stroke:#059669,color:#fff
    style Admin fill:#3b82f6,stroke:#2563eb,color:#fff
```

**254 herramientas distintas en total.** Cada una opera sobre datos reales con controles de acceso, entidades, permisos compartidos y reglas de seguridad que limitan qué puede ver y qué puede editar el agente.

### El agente raíz: ClatriAgent

Es el orquestador. Recibe tu mensaje, entiende qué quieres hacer y decide qué especialista debe intervenir. Si tu solicitud mezcla varios contextos, coordina la respuesta y la acción final.

Se encarga de:
- **Entidades**: tu contexto personal, familiar, profesional o empresarial.
- **Memoria conversacional**: continuidad entre mensajes y decisiones previas, consultada bajo demanda con `buscar_memoria`.
- **Documentación del producto**: respuestas sobre qué hace Clatri y cómo funciona cada feature, consultada con `buscar_documentacion`.
- **Documentos y adjuntos**: archivos que subes para que otros especialistas los analicen.
- **Web search**: cuando hace falta contrastar datos cambiantes en internet.
- **Preferencias del agente**: cómo quieres que te responda y te ayude.

### Experto Financiero

Es el especialista más grande de Clatri, y no por accidente: detrás de la conversación hay un sistema contable de verdad. Todo lo que registras aterriza en el mismo lugar.

- **Plan de cuentas** — la **única** taxonomía contable de Clatri. Cada gasto e ingreso se registra contra una **cuenta** del plan, no contra una etiqueta suelta. Es lo que hace que los informes cuadren entre sí en vez de contar tres historias distintas. Ver [Plan de cuentas](https://docs.clatri.com/finance/chart-of-accounts/)
- **Cuentas bancarias** multi-moneda con balances y movimientos obtenidos por integración bancaria cuando está disponible, por extractos subidos por ti o por registro directo en el chat
- **Tarjetas** de crédito y débito, con deuda por divisa en tarjetas de crédito
- **Gastos e ingresos** contra una cuenta del **Plan de cuentas**, con recibos, notas y contraparte
- **Contabilidad de devengo** — cada movimiento lleva **dos fechas**: cuándo se ganó o se causó, y cuándo se cobró o se pagó. Una misma factura alimenta así dos informes honestos en vez de forzarte a elegir cuál mentira prefieres. Ver [Contabilidad de devengo](https://docs.clatri.com/finance/accrual/)
- **Informes canónicos** — **Estado de resultados**, **Flujo de caja**, **Balance general**, **Saldos por mes**, **Por cobrar y pagar**. Los tres estados financieros salen del mismo libro mayor: son la misma contabilidad vista por tres lentes. Ver [Informes](https://docs.clatri.com/finance/reports/)
- **Para asignar** — los movimientos que mueven plata sin ser ni ingreso ni gasto: transferencias, pagos de deuda, aportes a ahorros y a inversiones. Los conectas con su destino real para que la caja no los cuente dos veces. Ver [Para asignar](https://docs.clatri.com/finance/assign/)
- **Presupuestos por cuenta**, con la opción de acumular las subcuentas bajo una cuenta padre. Ver [Presupuestos](https://docs.clatri.com/finance/budgets/)
- **Saldos** — saldos prepagados (recargas de un monedero, un plan, un crédito comprado por adelantado). Recargar mueve caja sin ser un gasto; consumir reconoce el gasto sin volver a mover caja. Ver [Saldos](https://docs.clatri.com/finance/balances/)
- **Mis negocios** y **líneas de negocio** — negocios dentro de una entidad, con su resultado derivado de lo que etiquetas en ellos. Ver [Mis negocios](https://docs.clatri.com/finance/business/)
- **Proyectos** — agrupan **ingresos y gastos** de una actividad puntual que termina (un viaje, un evento, un cliente) y muestran el **neto**, no solo lo que gastaste
- **Ventas, facturas y cotizaciones** con **catálogo** de productos y servicios, e inventario opcional cuando lo necesitas
- **Obligaciones** — deudas por pagar y por cobrar con intereses (simple/compuesto). Ver [Obligaciones](https://docs.clatri.com/finance/obligations/)
- **Ahorros** (bolsillos dentro de cuentas) con metas y transferencias
- **Inversiones** — CDTs, fondos, acciones, cripto, bonos con eventos (contribuciones, dividendos, retiros). Ver [Inversiones](https://docs.clatri.com/finance/investments/)
- **Activos** — inmuebles, vehículos, bienes
- **Transferencias** entre cuentas y portafolios
- **Pagos recurrentes** de ingreso o gasto, como suscripciones, servicios o cobros periódicos
- **Dominios web** con proveedor, vencimiento y costo de renovación
- **Contrapartes** — contactos vinculados a tus transacciones (*"¿cuánto gasté en mamá este mes?"*)
- **Registro en lote** — puedes dictar varias transacciones de golpe y el agente las registra todas

**Extractos e integración bancaria.** El mismo especialista importa extractos bancarios y de tarjeta: analiza el documento, cruza los movimientos contra lo que ya tienes registrado, prepara una revisión guiada y te deja confirmar, corregir o descartar cada línea **antes** de que entre a tus libros. Nada se registra a tus espaldas. Ver [Extractos](https://docs.clatri.com/finance/statements/) y [Conexión bancaria](https://docs.clatri.com/finance/open-banking/).

### Experto en Salud

Gestiona tu información de salud con especial cuidado sobre privacidad y contexto:

- **Condiciones** crónicas y de estilo de vida (diabetes, hipertensión, dieta keto, programa fitness)
- **Episodios** — enfermedades temporales y brotes de condiciones crónicas
- **Prescripciones y medicamentos** con horarios de toma y recordatorios. Los medicamentos siempre pertenecen a una prescripción
- **Documentos médicos** — historias clínicas, resultados de laboratorio, autorizaciones
- **Actividades de salud** — síntomas, citas médicas, vacunas, mediciones puntuales
- **Métricas corporales** — peso, presión arterial, glucosa, temperatura con seguimiento histórico
- **Ciclo menstrual** — registro de períodos con predicciones, síntomas y flujo

Cuando subes un documento médico, puede ayudarte a organizarlo, resumirlo y convertirlo en seguimiento útil dentro de la app.

### Experto en Administración y productividad

Es tu centro de administración personal con un workspace documental, tableros kanban, listas y libreta unificada de contactos:

- **Spaces** — workspaces de alto nivel (Trabajo, Personal, Contenido…) con ícono, nombre y un cuerpo editable estilo documento
- **Páginas** anidadas dentro de un Space (o dentro de otra página), con editor de bloques: párrafos, encabezados, listas, to-dos, citas, divisores, código, imágenes, tablas y tarjetas inline que referencian a otras páginas y tableros
- **Tableros** — vista kanban con columnas embebible dentro de una página o colgando directamente de un Space; tarjetas con drag-and-drop entre columnas
- **Tareas** con estado, prioridad, fecha límite, responsable y descripción editable; pueden vivir sueltas, dentro de una página, dentro de una columna de tablero, o como sub-tarea de otra tarea
- **Hábitos** con frecuencia personalizable (diaria, semanal, días específicos), seguimiento de rachas y grid de contribución 12-semanas estilo GitHub
- **Calendario** con eventos, alarmas, recordatorios y recurrencia
- **Contactos** — libreta unificada compartida con Money (el mismo contacto aparece como contraparte de gastos en Money y como responsable de una tarea en Administración sin duplicarse)

El agente de Administración gestiona todo lo anterior por chat: crea, edita, mueve y borra spaces, páginas, tableros, columnas, tareas, listas, recordatorios, hábitos, eventos de calendario y contactos. La UI sigue siendo el camino preferido cuando quieres ver y manipular visualmente (drag-and-drop en tableros, editor de bloques, grid de hábitos).

---

## La interfaz

### Navegación

La app se organiza en pestañas desde la barra o pestaña de navegación:

- **Money** — tu dashboard financiero
- **Administración** — productividad personal o corporativa (Spaces, páginas, tableros, tareas, hábitos, calendario, contactos)
- **Health** — seguimiento de salud (solo en entidades personales)
- **Ajustes** — configuración, suscripción, exportación de datos

El **chat con Clatri** se abre desde el botón central en pantalla completa. Sea cual sea la pantalla en la que estés, el agente recibe automáticamente el contexto de lo que estás viendo — qué cuenta tienes abierta, qué tarea estás editando, qué Space estás explorando — y puede actuar sobre eso sin que tengas que dárselo de la mano.

### Dashboards

Cada dominio tiene su propio dashboard como pantalla principal.

**Money** abre con el **balance total**, que trae dos controles arriba. Uno es el **selector de periodo** (semana, mes, año). El otro es más interesante: un **conmutador de lente** entre **"Ganado y gastado"** — lo que se causó en el periodo, aunque todavía no lo hayas cobrado ni pagado — y **"Entradas y salidas"** — la plata que de verdad se movió. Es la [contabilidad de devengo](https://docs.clatri.com/finance/accrual/) traducida a dos palabras, y explica por qué un mes excelente puede sentirse apretado en la cuenta.

Debajo:

- **Patrimonio neto**, con su tendencia
- **Cuentas y tarjetas**, con sus saldos y sus bolsillos de ahorro
- **Mis negocios** — tus negocios y líneas dentro de esta entidad
- **Resumen financiero** — obligaciones, próximos pagos, activos, inversiones, **Proyectos**, saldos
- **Contactos** — tus contrapartes frecuentes
- **Estadísticas** — encabezadas por *"Adónde fue tu dinero"*, cuyo **Ver todo** abre el **Plan de cuentas**
- **Informes** — **Flujo de caja**, **Por cobrar y pagar**, **Estado de resultados**, **Saldos por mes** y principales pagos recurrentes

Las secciones se pueden **reordenar y ocultar**: el dashboard que te sirve a ti no es el mismo que le sirve a quien lleva tres negocios.

Los otros dos:

- **Administración**: calendario, árbol de Spaces, tareas próximas (Atrasadas / Hoy / Mañana / Esta semana / Más adelante / Sin fecha), libreta de Contactos, hábitos con su grid de constancia
- **Health**: métricas corporales con historial, seguimiento del ciclo menstrual, condiciones activas, episodios recientes

Los dashboards te dan una vista rápida de tu información. También puedes registrar y modificar datos directamente desde la UI, pero la forma más cómoda y rápida de controlar tus datos es el chat.

### El chat

Puedes enviar:

- **Texto** — mensajes escritos, desde instrucciones simples hasta solicitudes complejas
- **Voz** — mensajes de audio que el agente transcribe y procesa
- **Archivos** — imágenes, PDFs, extractos bancarios, documentos médicos

El agente responde con texto y, cuando la información lo amerita, con **widgets interactivos**: tarjetas con datos clave, tablas, listas de tareas, vistas de cuentas, gráficos. No es solo texto — la respuesta se adapta al tipo de información que te está mostrando.

Cuando ver algo ayuda —un lugar, un plato, un objeto, una idea visual—, Clatri puede buscar fotos reales en la web y mostrarlas dentro de la misma respuesta, como una sola imagen o como una galería. Tocar una la abre en grande, con su fuente y un botón para abrirla. Necesita la app **2.8.0** o posterior; en la web ya está disponible. Cada búsqueda de imágenes consume créditos (ver [Precio](https://docs.clatri.com/pricing/)).

---

Clatri no solo conversa: actúa. Si le pides registrar un gasto, organizar una tarea, revisar un extracto o resumir un documento, usa el especialista correcto y ejecuta ese trabajo sobre tu información.

Todo esto ocurre con controles de acceso, almacenamiento privado y capas adicionales de protección para tu información más sensible. La explicación completa está en [Seguridad y privacidad](https://docs.clatri.com/security/).
