# Cómo funciona Frailen

> Un motor para que los agentes actúen, no solo respondan.

Cada pedido pasa por la identidad, el freno, una escritura única y la relectura, en tu API y con los permisos de tu usuario. El agente de encima puede cambiar; las garantías no.

## Un turno, por dentro

Cada pedido es un turno con pasos que se guardan antes de hacerse. Si algo se cae a la mitad, se sabe dónde quedó.

1. **Entiende el pedido**, con lo que la persona escribió y lo que tiene abierto en tu producto.
2. **Lee lo que hace falta**, con las herramientas de lectura de tu API, con los permisos de esa persona.
3. **El freno decide.** Lo que no tiene daño, lo hace. Lo que lo tiene, sale como una tarjeta que la persona confirma.
4. **Escribe una sola vez**, con la identidad de la persona y una clave que evita hacerlo dos veces.
5. **Relee y compara.** Vuelve a leer en tu API y compara con lo que pidió. Si no coincide, lo dice.
6. **Lo deja en la bitácora**: qué hizo, a nombre de quién y cómo salió la relectura. Nadie la edita.

Traza de ejemplo en Acme Billing (un producto inventado):

| Paso | Detalle |
| --- | --- |
| Canal | Chat dentro de Acme Billing |
| Identidad | Sesión firmada por Acme Billing · María |
| Modelo | Pasar el vencimiento de la factura F-2291 al 30 |
| Política de daño | Cambiar una fecha se deshace: va directo |
| Ejecutor | `PATCH /v1/invoices/F-2291` |
| Relectura | vence = 2026-11-30 · verificado |
| Respuesta | «Listo: F-2291 vence el 30 de noviembre» |

## El freno, según el daño

Tu equipo marca en cada herramienta qué daño puede hacer. El freno no depende de lo que el modelo diga: lo decide el código con esas marcas.

- **Mueve dinero:** cobros, precios, cortesías, devoluciones.
- **Toca a muchos de golpe:** cambios o avisos sobre muchos registros a la vez.
- **Le llega a terceros:** correos, WhatsApp, avisos a clientes.
- **No se deshace:** borrar, cancelar, enviar.
- **Correo, teléfono, credenciales y rol:** cambiar con qué entra alguien se confirma siempre, diga lo que diga la herramienta.

Tres resultados posibles:

- **Se hace directo:** mover un vencimiento se deshace moviéndolo de vuelta.
- **Pide confirmación:** porque mueve dinero y toca a muchos de golpe.
- **No lo intenta:** esa persona no tiene permiso para cobrar en tu producto.

## Relee lo que escribe

Una respuesta 200 no prueba que el cambio quedó. El agente vuelve a leer en tu API y compara con lo que pidió. Tres veredictos, nunca otro:

- **verificado:** se releyó y el cambio quedó como se aprobó.
- **no aparece:** se releyó y el cambio no está. No se repite a ciegas.
- **no se pudo leer:** no sabe si quedó. No se repite: ofrece pasar a una persona.

Si no se puede saber si quedó, no lo repite a ciegas: lo dice, lo marca como incierto y ofrece pasar a una persona.

## Lo que ve tu equipo

Un panel con lo que hizo el agente, cuánto costó y lo que espera una decisión. Cada acción del panel pide la passkey de quien la hace.

- **La bitácora:** hora, herramienta, objeto, a nombre de quién y el resultado de cada acción. Solo se agrega.
- **El medidor de tareas:** las tareas del mes contra el cupo del nivel («hasta»), y cuántas se resolvieron con una acción verificada.
- **El tope de gasto:** al llegar, el agente pasa cada caso a una persona hasta que lo subas o empiece el mes.

## Cuando no puede, lo dice

Si falta un permiso, la API falla o el pedido no está en sus herramientas, no inventa: ofrece pasar el caso a una persona de tu equipo, y la respuesta vuelve al mismo chat.

## Más

- Portada: [/es/index.md](/es/index.md) · Seguridad: [/es/seguridad.md](/es/seguridad.md) · Desarrolladores: [/es/desarrolladores.md](/es/desarrolladores.md)
- Esta página en inglés: [/producto.md](/producto.md)