L'intelligence artificielle

Odoo 19 intègre l'assistance par intelligence artificielle à plusieurs endroits du logiciel. Ce ne sont pas des variantes d'une même fonction : elles n'ont ni les mêmes prérequis, ni le même degré d'autonomie, ni les mêmes conséquences quand elles se trompent. Ce chapitre les distingue avant de détailler celles qui se configurent.

Les quatre niveaux d'assistance

L'écart entre les deux derniers est celui qui compte : un agent propose une réponse qu'un humain lit, une action serveur applique une décision que personne ne voit passer. Les précautions ne sont pas les mêmes.

Les prérequis

Trois conditions distinctes, à vérifier dans cet ordre.

Une précision d'abord, parce qu'elle explique la suite : l'assistance repose sur deux modules portant tous deux le nom IA, et qui ne s'installent pas de la même façon.

Autrement dit, une base peut très bien proposer la rédaction assistée sans qu'aucun menu IA ne soit visible : le socle est là, l'application ne l'est pas.

L'extension PostgreSQL

Les agents indexent leurs documents de référence pour pouvoir s'y référer. Cette indexation repose sur l'extension PostgreSQL vector, que le serveur doit fournir. Odoo la contrôle avant d'installer : le socle d'assistance refuse purement et simplement de s'installer si l'extension manque. En installation automatique, il s'abstient sans message ni trace visible ; à l'installation manuelle, l'opération échoue avec une erreur.

La clé d'accès au fournisseur

Odoo n'héberge pas de modèle : il appelle un service extérieur (OpenAI ou Google) et lui transmet les éléments nécessaires à la demande. Cet appel suppose une clé d'accès, dont les conditions dépendent de l'hébergement. La procédure figure à la section 3.3.4.

L'application

Les fonctions d'assistance rédactionnelle s'utilisent sans rien installer. Configurer des agents, des sujets ou des instructions par défaut suppose en revanche d'ajouter l'application, qui n'arrive jamais d'elle-même.

1. Ouvrir Apps.
2. Rechercher IA. L'application se présente comme une application ordinaire, sans qu'il soit besoin de retirer le filtre par défaut.
3. Cliquer sur Activer.
4. Un menu IA apparaît, portant l'entrée Agents. L'entrée Configuration, qui donne accès aux clés d'accès et aux instructions par défaut, n'est visible que pour un administrateur des paramètres.

Les agents

Un agent est un interlocuteur configuré pour un usage précis. Il se distingue de l'assistant générique par trois choses : une consigne permanente qui cadre ses réponses, des documents de référence sur lesquels il s'appuie, et des sujets qui lui donnent des outils.

Créer un agent

1. Ouvrir IA › Agents › Agents.
2. Cliquer sur Nouveau.
3. Renseigner le Nom de l'agent, puis le sous-titre placé juste dessous, qui résume l'agent pour ses utilisateurs. Ce champ n'a pas d'étiquette : il se repère à son texte d'exemple.
4. Choisir le Modèle LLM parmi ceux des fournisseurs configurés.
5. Régler le Style de réponse : Analytique, Équilibrée ou Créatif.
6. Rédiger le Prompt système : la consigne permanente qui cadre le rôle et le ton.
7. Enregistrer.

Donner des documents de référence

L'onglet Sources rassemble les documents sur lesquels l'agent s'appuie : catalogue, conditions générales, procédure interne, page de site.

1. Ouvrir l'onglet Sources de l'agent.
2. Cliquer sur Ajouter une source et choisir un fichier ou une adresse web.
3. Attendre l'indexation.

Chaque ligne porte un statut :

Le bouton Traiter à nouveau réindexe une source déjà traitée : il sert aux adresses web, dont le contenu change sans qu'Odoo en soit averti. Un fichier joint n'en a pas besoin, son contenu étant figé.

Les sujets

Un sujet est une compétence : un jeu d'instructions détaillées assorti des outils nécessaires pour l'exercer. Il se rattache ensuite à un ou plusieurs agents, ce qui évite de tout écrire dans le prompt système et permet de réutiliser la même compétence ailleurs.

Odoo en livre. La liste ouverte par IA › Agents › Sujets n'est pas vide sur une base neuve : les modules installés y déposent leurs sujets, avec leurs instructions et leurs outils déjà rattachés.

Ouvrir l'un d'eux donne la mesure de ce qu'est un sujet abouti : plusieurs pages d'instructions, énonçant les règles à respecter, les formats attendus, les enchaînements interdits et les cas de repli , et une dizaine d'outils rattachés, du type IA : Recherche ou IA : Obtenir les champs.

Créer un sujet.

1. Ouvrir IA › Agents › Sujets.
2. Cliquer sur Nouveau.
3. Renseigner le Titre, puis le sous-titre sans étiquette placé dessous, qui résume la compétence en une ligne.
4. Rédiger les Instructions : la procédure à suivre, dans le détail.
5. Désigner les Outils IA que le sujet met à disposition. Odoo en livre une dizaine, et toute action serveur cochée Utiliser dans l'IA vient s'y ajouter , voir la section 20.5.2.
6. Enregistrer, puis rattacher le sujet à l'agent voulu par son champ Sujets.

Mettre l'agent à l'épreuve

Le bouton Test, en tête du formulaire, ouvre une conversation avec l'agent tel qu'il est configuré. C'est le moyen de vérifier le comportement avant de l'exposer aux utilisateurs : reformuler la même question de plusieurs façons, vérifier qu'il cite bien ses sources, contrôler qu'il refuse ce qui sort de son périmètre.

Les instructions par défaut

Quand un utilisateur déclenche l'assistance, Odoo appelle un agent et lui transmet une consigne. Ni l'un ni l'autre ne sont figés : ils dépendent de l'endroit d'où la demande part, et ce rattachement se configure par des règles.

Chaque règle répond à une question de la forme « lorsque les utilisateurs font ceci, à quel agent s'adresser et avec quelle consigne ». Odoo en livre sept, une par point d'entrée de l'interface : huit si l'application Connaissances est installée.

1. Ouvrir IA › Configuration › Prompts par défaut.
2. Ouvrir une règle, ou cliquer sur Nouveau.

Le formulaire tient en cinq champs et un onglet :

Les huit points d'entrée :

L'automatisation assistée par l'IA

Certaines décisions ne s'expriment pas par une condition fixe : classer une demande entrante selon son contenu, choisir un traitement selon un texte libre, extraire une information d'un message. Une action serveur assistée par l'intelligence artificielle traite ces cas.

Le principe

Le mécanisme sépare strictement la décision de l'exécution.

Créer un outil

1. Activer le mode développeur.
2. Ouvrir Paramètres › Technique › Actions › Actions de serveur.
3. Créer l'action réalisant l'opération voulue, ou ouvrir une action existante.
4. Renseigner le Modèle sur lequel elle opère.
5. Choisir le Type parmi les vignettes proposées. Le choix n'est pas libre : seuls certains types peuvent servir d'outil, voir le tableau ci-dessous.
6. Ouvrir l'onglet Utilisation et cocher Utiliser dans l'IA.
7. Renseigner le champ de texte libre qui apparaît à droite de la case, il porte le seul texte d'exemple Brève explication de ce que cela fait. C'est sur cette description, et sur elle seule, que l'action de décision choisira d'appeler cet outil.
8. Si le type est Exécuter le code , ou Actions multiples enchaînant une action de code, renseigner le Schéma IA : le descriptif au format JSON des arguments attendus, leur type et leurs contraintes. Le laisser vide si l'outil n'attend aucun argument.
9. Enregistrer.

Deux types sont éligibles sous condition : Mettre à jour l'enregistrement, si la valeur provient d'une saisie ou d'une séquence et non d'une expression calculée, et Actions multiples, à la seule condition que toutes les actions qu'elle enchaîne soient elles-mêmes éligibles.

Créer l'action de décision

1. Toujours depuis les actions de serveur, créer une action et retenir le Type IA.
2. Sélectionner le Modèle concerné.
3. Ouvrir l'onglet Pop-up, c'est ainsi que l'interface française nomme l'onglet Prompt, qui n'apparaît que sur ce type d'action.
4. Renseigner le champ Outils : les actions que la décision est autorisée à appeler. La liste proposée se limite aux actions cochées Utiliser dans l'IA et portant sur le même modèle. Un outil défini sur un autre modèle n'apparaîtra pas.
5. Rédiger l'instruction dans le champ Prompt d'action IA : le contexte, la décision attendue, les critères à appliquer.
6. Enregistrer.
7. Rattacher enfin cette action à un déclencheur, via une règle d'automatisation (voir le chapitre 21) ou un bouton sur le document.

Rédiger l'instruction. Le champ est un éditeur de texte enrichi, doté de deux commandes propres, appelées par / comme dans les modèles d'e-mail :

• Sélecteur de champ, sous-titré Insérer un champ : insère la valeur d'un champ de l'enregistrement traité. C'est ainsi que l'instruction reste générique tout en s'appuyant sur des données réelles.
• Sélecteur d'enregistrements, sous-titré Insérer des enregistrements : désigne des enregistrements précis que la décision pourra consulter : un barème, une liste de référence.

Ce que vous écrivez n'est pas tout ce que reçoit le modèle. Odoo y ajoute automatiquement la date et l'heure courantes, l'identité de l'enregistrement traité, et les valeurs des champs que vos commandes ont insérés. Inutile donc de rappeler la date dans l'instruction.

Ce qui se passe à l'exécution. L'action traite les enregistrements un par un. Pour chacun, elle soumet l'instruction enrichie, reçoit la liste des outils à appeler et les exécute dans l'ordre. Le cycle s'arrête lorsque la décision estime n'avoir plus rien à faire.

Deux contrôles bloquent l'enregistrement d'une configuration incohérente : cocher Utiliser dans l'IA sur un type inéligible refuse la sauvegarde avec le message L'action '…' ne peut pas être utilisée comme outil d'IA., et un Schéma IA qui n'est pas du JSON valide est rejeté de même.

Ce que l'assistance ne fait pas