Un agente trabaja sin supervisión. Lo que lo acota no es, por tanto, tu vigilancia, sino un motor de reglas que comprueba cada llamada antes de que salga hacia Odoo.

La seguridad nunca depende del prompt

Las reglas no son instrucciones dadas a la IA. Las aplica el servidor, en cada llamada, con independencia de lo que el agente crea que puede hacer. Una instrucción maliciosa oculta en un dato de Odoo no puede, por tanto, sortearlas.

Cómo se compone una regla

Una regla asocia un ámbito a unas operaciones, con condiciones opcionales.

Ámbito: grupo «facturación»
Operaciones: query, read

Ámbito: modelo mail.activity
Operaciones: query, read, create

Ámbito: modelo sale.order
Operaciones: query, read, write
Condición: amount_total < 5000

Un agente acumula varias reglas. Todo lo que no cubre ninguna regla queda denegado.

Los ámbitos

Designas o bien un grupo funcional, o bien una lista de modelos explícita. Para identificar el nombre técnico de un modelo (sale.order, crm.lead…), consulta la lista de modelos de Odoo.

Grupo	Cubre
`crm`	Iniciativas y oportunidades
`ventes`	Presupuestos, pedidos y sus líneas
`facturation`	Facturas, rectificativas, pagos
`achats`	Pedidos de compra y sus líneas
`stock`	Transferencias y movimientos de stock
`support`	Tickets y tareas de proyecto
`rh`	Ausencias
`communication`	Mensajes y actividades

Cada grupo cubre además las actividades planificadas (mail.activity) e incorpora los modelos de solo lectura de los que depende: conceder escritura sobre los pedidos da lectura de clientes y productos, sin permitir nunca modificarlos. Del mismo modo, el grupo rh da lectura de empleados y departamentos, y el grupo stock, de las cantidades en stock y las ubicaciones.

Para un agente de ámbito estrecho, es preferible una lista de modelos explícita: se tarda más en configurar y es bastante más seguro.

Las operaciones

Operación	Qué autoriza
`query`	Buscar registros
`read`	Leer registros conocidos
`report`	Calcular agregados
`print`	Generar un PDF
`create`	Crear
`write`	Modificar
`workflow`	Disparar una acción de negocio de Odoo
`execute`	Llamar a un método de Odoo

La eliminación no existe

delete no aparece en esta lista, y no por descuido: ningún agente puede eliminar un registro, sea cual sea su configuración. Para retirar un registro de la circulación, un agente debe archivarlo mediante write.

Las condiciones de valores

Es el ajuste que convierte un permiso amplio en un permiso seguro.

Una condición se aplica a un campo y se comprueba antes de la escritura. Aidoo relee el registro afectado y verifica la condición sobre su estado real, no sobre lo que el agente afirma.

Condición	Efecto
`amount_total < 5000`	El agente no toca las operaciones grandes
`state != posted`	Nunca modifica una factura contabilizada
`user_id = <un comercial>`	Se mantiene en la cartera de una persona

Ante la duda, la llamada se deniega

Si Aidoo no consigue verificar una condición, por ejemplo porque no ha podido releer el registro, la llamada se bloquea. El motor falla siempre del lado de la denegación.

El modo aprendizaje

Es el ajuste por defecto de un agente nuevo, para no tener que adivinar sus reglas antes de verlo trabajar. Durante una ventana de 48 horas:

Lo que hace el agente	Lo que ocurre
Leer cualquier modelo	Permitido, dentro de lo que ve su cuenta de Odoo
Escribir sobre un modelo cubierto por una regla de partida	Ejecutado, como fuera del aprendizaje
Escribir sobre un modelo que ninguna regla cubre	En espera de tu validación (ver más abajo)
Eliminar	Sigue siendo imposible

Cada acceso realmente ejecutado queda observado: modelo, operación, número de llamadas. Tanto las ejecuciones autónomas como las conversaciones (en Aidoo o en la burbuja de Odoo) alimentan el aprendizaje. Una escritura validada cuenta como acceso observado; una rechazada, no.

Al congelar, automáticamente al terminar las 48 horas o por decisión tuya con el botón Congelar los permisos ahora, los accesos observados se fusionan en las reglas: los modelos que comparten las mismas operaciones se agrupan, y un grupo funcional cubierto por completo pasa a ser una regla de grupo. Las reglas de partida se conservan tal cual. Revisas el resultado y lo corriges si hace falta; desmarcar la casilla desde la ficha del agente te muestra esas reglas antes de guardarlas.

Lo que el aprendizaje no adivina

Las condiciones de valores («solo facturas en borrador», «importe inferior a 5.000») siguen escribiéndose a mano. El aprendizaje observa modelos y operaciones, no umbrales. Tras congelar, relee las reglas de escritura y añade las condiciones que correspondan.

Una vez congelado, el agente no vuelve al aprendizaje por sí solo. Si sus reglas resultan demasiado estrechas, añádelas a mano, o haz clic en Relanzar el aprendizaje desde su ficha (propietario o administrador del espacio): se abre una nueva ventana de 48 horas, las reglas actuales pasan a ser reglas de partida y los accesos observados vuelven a cero.

La validación humana

Algunas operaciones no salen de inmediato: esperan a que una persona las apruebe. Tres casos:

la opción Validación humana de escrituras está marcada (viene desactivada por defecto): cada creación, modificación o acción de Odoo del agente se somete a aprobación;
el agente está en modo aprendizaje y quiere escribir sobre un modelo que ninguna regla cubre;
el agente prepara un correo en modo «validación antes del envío» (ver más abajo).

Cada operación pendiente se muestra con su detalle (modelo, campos, destinatarios) en Aidoo y en la burbuja de Odoo, con los botones Aprobar y Rechazar. Sin decisión, caduca a los 7 días.

El agente se pausa mientras espera. Envía juntas las operaciones preparadas en una misma respuesta y luego se detiene, en lugar de seguir como si ya estuvieran hechas. Su informe termina indicando que una operación espera tu validación y que el agente está en pausa. Cuando todas las operaciones enviadas están resueltas, se reanuda una sola vez con el conjunto de decisiones, rechazos incluidos, y adapta lo que sigue.

Situación	Reanudación
Ejecución autónoma	Una nueva ejecución «Decisión recibida» arranca con todas las decisiones
Conversación	El agente retoma la conversación en cuanto no queda nada pendiente

Mientras una operación enviada por una ejecución esté pendiente, las siguientes ejecuciones programadas se omiten, sin consumir nada. Las ejecuciones disparadas por un evento, una fecha o a mano salen igualmente, conociendo la lista de operaciones ya pendientes para no volver a proponerlas.

El modo solo flujos de trabajo

El ajuste más restrictivo: el agente no puede llamar directamente a ninguna herramienta de Odoo, solo ejecutar flujos de trabajo guardados que tú has validado.

Actúa entonces estrictamente dentro de secuencias que has escrito y aprobado. Pierdes en flexibilidad lo que ganas en previsibilidad. Es el ajuste adecuado para un agente que toca la contabilidad.

Las salvaguardas automáticas

Protegen a todos los agentes de forma permanente; solo los límites por ejecución se configuran agente por agente.

Comprobación de Odoo antes de cualquier llamada al modelo de IA. Si tu Odoo no responde, la ejecución se detiene de inmediato, antes de consumir un solo token. Tras varios intentos, el agente se pausa.

Límites por ejecución. Se configuran agente por agente en Límites y seguridad:

Límite	Valor por defecto
Créditos máx. / ejecución	100 créditos (también es el mínimo), hasta 1 000
Tiempo máx.	300 segundos, hasta 4 500
Acciones máx. / ejecución	Vacío, es decir, ilimitado
Escrituras máx. / ejecución	Vacío, es decir, ilimitado

Una escritura cuenta una llamada, no un registro: modificar 50 tickets en una sola llamada agrupada cuenta como una.

Detección de bucles. Una misma llamada repetida con exactamente los mismos parámetros, sin escritura entre medias, se deniega a la tercera vez; a la cuarta, la ejecución se detiene en lugar de quemar su presupuesto.

Pausa automática. Después de 3 fallos consecutivos (ajustable de 1 a 20), o si una ejecución supera el techo de escrituras que hayas fijado, el agente se pausa y te avisa en lugar de insistir.

Interruptor general. El botón Pausar todo suspende todos los agentes del espacio de trabajo de una vez. Útil durante una migración de Odoo o una incidencia.

Parada a demanda. Una ejecución en curso, real o simulada, se detiene con el botón Detener de la burbuja «Ejecución en curso», en el hilo del agente. En una conversación, el botón de envío se convierte en un botón Detener mientras el agente trabaja. La herramienta en curso termina y después no sale nada más; la respuesta parcial se conserva.

Bloqueo de créditos. Al agotarse el fondo, o el presupuesto mensual del agente, no sale ninguna ejecución y no se factura nada. El agente recupera su ritmo en cuanto vuelven los créditos.

Registro inalterable. Cada paso se escribe conforme avanza la ejecución y ya no puede modificarse. Los parámetros sensibles aparecen enmascarados.

Las herramientas ajenas a Odoo

Un agente también puede actuar fuera de Odoo: publicar en Slack, enviar un correo, escribir en Notion. Dos fuentes, cinco aplicaciones por agente como máximo.

El banco de aplicaciones. Más de 1000 servicios conectables en unos clics desde la página Integraciones, con la autenticación gestionada en tu lugar.

Tus propios servidores MCP. Si ya expones herramientas internas por MCP, decláralas con su autenticación (cabecera estática u OAuth). Los secretos se cifran por espacio de trabajo.

El detalle de la conexión, del catálogo y del ajuste de permisos está en Integraciones y herramientas externas.

Restringe la lista de herramientas

Para cada aplicación, activa solo las dos o tres herramientas realmente útiles. Sin esa restricción, todo el catálogo de la aplicación se carga en cada turno de conversación, lo que dispara el consumo de créditos sin aportar nada.

La escritura hacia un servicio externo se gobierna con un interruptor aparte: por defecto, un agente solo lee. Y el contenido que llega de un servicio de terceros se trata como no fiable, exactamente igual que los datos de Odoo.

El acceso web

Dos herramientas opcionales, reservadas a los agentes y nunca expuestas a Claude ni a ChatGPT: una búsqueda web y una lectura de páginas. Desactivadas por defecto.

Útiles para un agente que deba comprobar un dato público, por ejemplo la existencia de una empresa antes de cualificar un lead. Los resultados se truncan para no disparar el presupuesto de tokens, y las direcciones internas quedan bloqueadas.

Los demás permisos

Además de las reglas de Odoo, la sección Permisos del agente incluye interruptores específicos, todos desactivados por defecto:

Permiso	Qué abre
Proponer correos	El agente prepara correos vinculados a un registro de Odoo (hasta 20 de una vez), con hasta 5 adjuntos ya presentes en Odoo si hace falta. En modo validación antes del envío (el predeterminado), nada sale sin tu clic. En modo envío automático, salen al instante bajo la identidad de Odoo del agente, dentro del límite de correos automáticos por ejecución (10 por defecto, hasta 100).
Lectura de documentos	El agente lee los PDF, imágenes (escaneos incluidos) y archivos Word adjuntos a los registros, hasta 30 páginas y 20 MB. 1 crédito por cada tramo de 20 páginas, una sola vez por documento.
Puede hacer una pregunta a una persona	Solo en ejecución autónoma, el agente hace una pregunta (con hasta 4 opciones) y se detiene; se reanuda en cuanto llega la respuesta, dada desde Aidoo, la burbuja de Odoo o un enlace por correo. Sin respuesta en 7 días, la pregunta caduca.
Agentes colaboradores	Se configuran desde la ficha del agente: puede consultar hasta a 5 agentes del espacio o delegarles una tarea. El agente solicitado trabaja con su propia identidad, sus reglas y su presupuesto, y no puede solicitar a otro a su vez.
Drive Aidoo	El agente lee y escribe archivos (Markdown, Excel, Word, CSV) en el Drive del espacio: su carpeta privada, la carpeta `shared` en lectura y las carpetas que añadas. Una eliminación, o sobrescribir un archivo subido por una persona, pasa por la validación.

Estos permisos nunca amplían el acceso a Odoo: documentos y adjuntos se leen con la identidad de Odoo del agente, incluidas sus reglas de lectura.

Un método de configuración que funciona

Deja que el aprendizaje haga la primera criba

Durante las 48 horas, pon al agente a trabajar con casos reales. Sus lecturas son libres, sus escrituras fuera de las reglas pasan por ti y espera tu decisión antes de continuar. Al congelar, relee las reglas obtenidas y quita lo que tocó por curiosidad y no por necesidad.

Quédate en solo lectura si el agente analiza

Para un agente que produce informes, únicamente query, read y report. El agente produce sus análisis y compruebas que apunta bien.

Añade la escritura menos arriesgada

Por lo general create sobre mail.activity: el agente programa seguimientos sin modificar nada existente.

Abre la modificación, con condiciones

write sobre un modelo concreto, acotado por una condición de valor. Nunca write sobre un grupo entero sin condición.

Fija un techo de escrituras ajustado

El campo Escrituras máx. / ejecución está vacío (ilimitado) por defecto. Para un agente que empieza, fíjalo en cinco: basta para la mayoría de las misiones, y superarlo pausa al agente. Súbelo solo cuando un caso legítimo lo supere.

Siguiente paso

Créditos y consumo: lo que cuesta cada ejecución
Buenas prácticas y diagnóstico: diagnosticar un agente bloqueado