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.

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 en tu perfil de miembro: activado para propietarios y administradores, desactivado para los miembros

¿Quién debe poder corregir?

Abrir canUpdateHints a todo el equipo hace converger los hints deprisa, pero expone a instrucciones contradictorias. La configuración que mejor funciona: unos pocos referentes de negocio autorizados, y el resto trasladándoles sus correcciones.

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.

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. Si lo está, comprueba canUpdateHints en tu perfil de miembro: hacen falta los dos.

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