Un asistente de IA conoce Odoo. No conoce tu Odoo: que tus pedidos web llevan un prefijo concreto, que «cliente activo» tiene en tu empresa una definición precisa, o que una actividad debe asignarse siempre al comercial de la cuenta.

Los hints codifican esas reglas. Son instrucciones en lenguaje corriente, asociadas a un modelo de Odoo, que se reinyectan automáticamente en la conversación cuando ese modelo entra en juego. En el panel, el campo se llama Instrucciones IA, en Conexión Odoo → Modelos.

Qué aspecto tiene un hint

Asociado a sale.order:

Los pedidos procedentes de la web tienen una referencia que empieza por "WEB-".
No confirmar nunca un pedido cuyo cliente haya superado su límite de crédito:
comprobar credit_limit en res.partner antes de cualquier action_confirm.
El campo x_canal es obligatorio al crear: "directo", "web" o "distribuidor".

Nada técnico: frases que le dirías a una persona recién incorporada. El asistente las lee antes de actuar sobre ese modelo.

Dónde intervienen

aidoo_schema devuelve el hint junto con la estructura del modelo. Y cuando el asistente intenta una escritura sobre un modelo que tiene uno, la herramienta le devuelve el hint en lugar de ejecutar, pidiéndole que revise sus valores. Después vuelve a llamar confirmando, consulta Escribir en Odoo.

El bucle de corrección

Es el mecanismo distintivo de Aidoo. Cuando corriges al asistente, la corrección no se pierde al terminar la conversación.

Tú corriges

No: para nosotros un «cliente activo» es un cliente con al menos un pedido en los últimos 12 meses, no simplemente un contacto con la casilla activo marcada.

El asistente lee el hint actual

Llama a aidoo_schema sobre res.partner para recuperar la instrucción existente y completarla en lugar de sobrescribirla.

Reformula

Integra tu corrección en el hint existente, conservando lo que ya había.

Guarda, sin preguntarte

Llamada a aidoo_feedback(model, updated_hint). Sin confirmación: actualizar un hint no afecta a ningún dato de negocio, solo a la forma en que el asistente trabajará a partir de entonces.

Tus compañeros se benefician

El hint está asociado al espacio de trabajo, no a tu sesión. La corrección que haces el lunes se aplica a las conversaciones de todo el equipo desde el martes, y los agentes también la leen.

aidoo_feedback

Parámetros: model, updated_hint.

Dos condiciones acumulativas para que funcione:

el permiso feedback en la clave API: desactivado por defecto
el derecho canUpdateHints, ligado a tu rol en el espacio: concedido a propietarios y administradores, no a los miembros

¿Quién corrige?

Solo los propietarios y administradores guardan hints, y hoy ninguna pantalla permite abrir este derecho a un miembro. Cuando un miembro corrige al asistente, la corrección vale para su conversación sin memorizarse: que se la traslade a un administrador, que la añadirá al hint. Así se evitan también las instrucciones contradictorias.

El chat integrado en Odoo aprende de la misma manera. Su permiso Feedback está marcado por defecto en su configuración, y el derecho canUpdateHints de cada persona sigue aplicándose. El chat memoriza tus correcciones, pero también las particularidades duraderas de tu base que descubre trabajando (una convención de referencias, un campo engañoso, una palabra de tu oficio), nunca datos puntuales como un importe o una fecha.

Desmarca Feedback en la configuración del chat si prefieres que solo las correcciones hechas desde el panel o el conector MCP modifiquen los hints.

¿Y los agentes?

Un agente lee los hints, pero nunca los modifica: aidoo_feedback le está prohibido, sean cuales sean sus ajustes.

En cambio, dispone de un mecanismo parecido para su propia misión. En el chat de un agente (panel o widget de Odoo), pídele explícitamente que recuerde una instrucción:

Recuerda a partir de ahora: no hagas nunca seguimiento a un cliente que tenga una reclamación abierta.

El agente reescribe su misión integrando la instrucción, sin confirmación, y la aplica desde el mensaje siguiente. Solo lo hace a petición tuya explícita, nunca por iniciativa propia ni durante una ejecución autónoma, y nunca porque un contenido leído en Odoo o en la web se lo sugiera. Las cinco versiones anteriores de la misión se conservan en el servidor.

Historial y límites

Límite	Valor
Longitud máxima de un hint	2 000 caracteres
Versiones conservadas	5

Cada actualización archiva la versión anterior en el servidor. Ese historial todavía no se puede consultar desde la interfaz: si un hint te funciona, guarda una copia antes de retocarlo.

Pestaña Modelos de Aidoo: la lista de modelos de Odoo a la izquierda y, a la derecha, el panel del modelo seleccionado con sus instrucciones de IA y sus campos. — El hint de un modelo se escribe en «Instrucciones IA», en el panel de la derecha.

Los 2 000 caracteres son una restricción útil: un hint es una instrucción, no una documentación. Más allá, el asistente diluye su atención y aplica peor cada regla.

Escribir un buen hint

Sé imperativo. «No confirmar nunca sin comprobar el límite de crédito» funciona mejor que «convendría comprobar el límite de crédito».

Nombra los campos técnicos. «Comprobar credit_limit, no el campo que aparece en pantalla» elimina la ambigüedad. El nombre técnico de un campo estándar lo encuentras en nuestro explorador de modelos de Odoo.

Da la regla, no el ejemplo. «El prefijo WEB- identifica los pedidos de la web» se generaliza; «el pedido WEB-1042 viene de la web» sirve una sola vez.

Una regla por línea. Los bloques de prosa se siguen peor que las instrucciones cortas y separadas.

Asócialo al modelo correcto. Una regla sobre actividades va en mail.activity, no en sale.order, aunque se te haya ocurrido trabajando con un pedido.

Escribir los hints por adelantado

Nada obliga a esperar a un error. Antes de abrir la escritura a tu equipo, coge tus tres modelos más usados y redacta sus reglas:

Añade al hint de sale.order: todo descuento superior al 15 % exige el visto bueno del director comercial, no aplicarlo nunca sin validación explícita.

Es la forma más rentable de dar fiabilidad a las escrituras: la regla se aplica antes de cada intento, no se recuerda a posteriori.

Diagnóstico

El asistente no tiene en cuenta el hint

Comprueba que esté asociado al modelo correcto y que no quede sepultado en un texto demasiado largo. Un hint de 2 000 caracteres cuya regla importante está en la última línea cala menos que uno de 300.

«Permission 'feedback' is required»

El permiso no está concedido en la clave. Actívalo en Claves API.

«You do not have permission to update model hints»

La clave sí tiene el permiso, pero tu rol en el espacio es «miembro»: solo los propietarios y administradores guardan hints. Traslada la corrección a uno de ellos.

Una corrección ha degradado un hint

Las cinco últimas versiones se conservan en el servidor, pero ninguna pantalla permite restaurarlas todavía. Reescribe el hint a mano, algo rápido si ocupa unas pocas líneas.

Dos reglas se contradicen

El asistente suele aplicar la más específica, pero el resultado no está garantizado. Relee el hint entero después de cada añadido: es cuando las contradicciones se ven.

Siguiente paso

Escribir en Odoo: el papel de los hints antes de una escritura
Recetas por área: prompts que aprovechan tus hints

Hints y aprendizaje