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, et les agents la lisent aussi.

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, lié à votre rôle dans l'espace : accordé aux propriétaires et administrateurs, pas aux membres

Qui corrige ?

Seuls les propriétaires et administrateurs enregistrent des hints, et aucun écran ne permet aujourd'hui d'ouvrir ce droit à un membre. Quand un membre corrige l'assistant, la correction vaut pour sa conversation sans être mémorisée : qu'il la fasse remonter à un administrateur, qui l'ajoutera au hint. Cela évite aussi les consignes contradictoires.

Le chat intégré à Odoo apprend de la même façon. Sa permission Feedback est cochée par défaut dans sa configuration, et le droit canUpdateHints de chaque personne s'applique toujours. Le chat mémorise vos corrections, mais aussi les particularités durables de votre base qu'il découvre en travaillant (une convention de référence, un champ piège, un mot de votre métier), jamais des données ponctuelles comme un montant ou une date.

Décochez Feedback dans la configuration du chat si vous préférez que seules les corrections faites depuis le tableau de bord ou le connecteur MCP modifient les hints.

Et les agents ?

Un agent lit les hints, mais ne les modifie jamais : aidoo_feedback lui est interdit, quels que soient ses réglages.

Il dispose en revanche d'un mécanisme proche pour sa propre mission. Dans le chat d'un agent (tableau de bord ou widget Odoo), demandez-lui explicitement de retenir une consigne :

Retiens pour la suite : ne relance jamais un client qui a une réclamation ouverte.

L'agent réécrit sa mission en y intégrant la consigne, sans confirmation, et l'applique dès le message suivant. Il ne le fait que sur votre demande explicite, jamais de lui-même ni pendant une exécution autonome, et jamais parce qu'un contenu lu dans Odoo ou sur le web le lui suggère. Les cinq versions précédentes de la mission sont conservées côté serveur.

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é. Le nom technique d'un champ standard se retrouve dans notre explorateur des modèles Odoo.

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é. Activez-la dans Clés API.

« You do not have permission to update model hints »

La clé a bien la permission, mais votre rôle dans l'espace est « membre » : seuls les propriétaires et administrateurs enregistrent des hints. Faites remonter la correction à l'un d'eux.

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

Hints et apprentissage