Un assistant IA connaît Odoo. Il ne connaît pas votre Odoo : que vos commandes web portent un préfixe particulier, que « client actif » a chez vous une définition précise, ou qu'une activité doit toujours être assignée au commercial du compte.

Les hints encodent ces règles. Ce sont des consignes en français, attachées à un modèle Odoo, réinjectées automatiquement dans la conversation quand ce modèle est utilisé. Dans le tableau de bord, le champ s'appelle Instructions IA, sous Connexion Odoo → Modèles.

À quoi ressemble un hint

Attaché à sale.order :

Les commandes issues du site web ont une référence commençant par "WEB-".
Ne jamais confirmer une commande dont le client a un encours dépassé :
vérifier credit_limit sur res.partner avant toute action_confirm.
Le champ x_canal est obligatoire à la création : "direct", "web" ou "revendeur".

Rien de technique : des phrases que vous diriez à un nouvel arrivant. L'assistant les lit avant d'agir sur ce modèle.

Où ils interviennent

aidoo_schema renvoie le hint avec la structure du modèle. Et quand l'assistant tente une écriture sur un modèle qui en possède un, l'outil lui renvoie le hint plutôt que d'exécuter, en lui demandant de reprendre ses valeurs. Il rappelle ensuite en confirmant, voir Écrire dans Odoo.

La boucle de correction

C'est le mécanisme distinctif d'Aidoo. Quand vous corrigez l'assistant, la correction ne se perd pas à la fin de la conversation.

Vous corrigez

Non : chez nous un « client actif » est un client avec au moins une commande dans les 12 derniers mois, pas simplement un contact coché actif.

L'assistant lit le hint courant

Il appelle aidoo_schema sur res.partner pour récupérer la consigne existante, afin de la compléter plutôt que de l'écraser.

Il reformule

Il intègre votre correction au hint existant, en gardant ce qui y était déjà.

Il enregistre, sans vous demander

Appel à aidoo_feedback(model, updated_hint). Pas de confirmation : la mise à jour d'un hint n'affecte aucune donnée métier, seulement la manière dont l'assistant travaille ensuite.

Vos collègues en bénéficient

Le hint est attaché à l'espace de travail, pas à votre session. La correction que vous faites lundi s'applique aux conversations de toute l'équipe dès mardi.

aidoo_feedback

Paramètres : model, updated_hint.

Deux conditions cumulatives pour qu'il fonctionne :

la permission feedback sur la clé API : désactivée par défaut
le droit canUpdateHints sur votre profil membre : activé pour les propriétaires et administrateurs, désactivé pour les membres

Qui doit pouvoir corriger ?

Ouvrir canUpdateHints à toute l'équipe fait converger les hints vite, mais expose à des consignes contradictoires. Le réglage qui fonctionne le mieux : quelques référents métier autorisés, les autres remontent leurs corrections à ces référents.

Historique et limites

Limite	Valeur
Longueur maximale d'un hint	2 000 caractères
Versions conservées	5

Chaque mise à jour archive la version précédente côté serveur. Cet historique n'est pas encore consultable depuis l'interface : si un hint vous convient, gardez-en une copie avant de le remanier.

Onglet Modèles d'Aidoo : la liste des modèles Odoo à gauche, et à droite le panneau du modèle sélectionné avec ses instructions IA et ses champs. — Le hint d'un modèle se saisit dans « Instructions IA », sur le panneau de droite.

Les 2 000 caractères sont une contrainte utile : un hint est une consigne, pas une documentation. Au-delà, l'assistant dilue son attention et applique moins bien chaque règle.

Écrire un bon hint

Soyez impératif. « Ne jamais confirmer sans vérifier l'encours » vaut mieux que « il serait souhaitable de vérifier l'encours ».

Nommez les champs techniques. « Vérifier credit_limit, pas le champ affiché à l'écran » lève l'ambiguïté.

Donnez la règle, pas l'exemple. « Le préfixe WEB- désigne les commandes du site » se généralise ; « la commande WEB-1042 vient du site » ne sert qu'une fois.

Une règle par ligne. Les blocs de prose sont moins bien suivis que les consignes courtes et séparées.

Attachez au bon modèle. Une règle sur les activités va sur mail.activity, pas sur sale.order, même si elle vous est venue en travaillant sur une commande.

Écrire les hints à l'avance

Rien n'oblige à attendre une erreur. Avant d'ouvrir l'écriture à votre équipe, prenez vos trois modèles les plus utilisés et écrivez leurs règles :

Ajoute au hint de sale.order : toute remise supérieure à 15 % exige l'accord du directeur commercial, ne jamais l'appliquer sans validation explicite.

C'est la manière la plus rentable de fiabiliser les écritures : la règle est appliquée avant chaque tentative, pas rappelée après coup.

Diagnostic

L'assistant ne tient pas compte du hint

Vérifiez qu'il est attaché au bon modèle, et qu'il n'est pas noyé dans un texte trop long. Un hint de 2 000 caractères où la règle importante est en dernière ligne passe moins bien qu'un hint de 300 caractères.

« Permission feedback is required »

La permission n'est pas accordée à la clé. Si elle l'est, vérifiez canUpdateHints sur votre profil membre : les deux sont nécessaires.

Un hint a été dégradé par une correction

Les cinq dernières versions sont conservées côté serveur, mais aucun écran ne permet encore de les restaurer. Réécrivez le hint à la main, ce qui est rapide s'il fait quelques lignes.

Deux règles se contredisent

L'assistant applique en général la plus spécifique, mais le résultat n'est pas garanti. Relisez le hint entier après chaque ajout : c'est le moment où les contradictions se voient.

Étape suivante

Écrire dans Odoo : le rôle des hints avant une écriture
Recettes par métier : des prompts qui tirent parti de vos hints