Bonnes pratiques et dépannage

Un agent qui tourne sans être lu ne sert à rien, et un agent qui se comporte mal se diagnostique presque toujours au même endroit : son journal d'exécution.

Où arrivent les résultats

Quatre canaux, cumulables :

Le chatter Odoo est le canal le plus sous-estimé : la note arrive sur la facture ou le devis concerné, exactement là où la personne qui doit agir la verra.

Un récapitulatif quotidien rassemble par ailleurs l'activité de tous vos agents en un seul message matinal.

Le widget dans Odoo

Vos équipes peuvent consulter leurs agents sans quitter Odoo : une bulle apparaît en bas à droite de votre Odoo de production et affiche, pour chaque utilisateur, les agents qui lui sont assignés ainsi que leur historique.

L'assignation se fait par login Odoo, dans la configuration de l'agent. Un commercial voit ses agents, pas ceux de la comptabilité.

Ouvrir un agent affiche son historique, exactement comme dans le tableau de bord : les comptes rendus de ses exécutions et vos échanges avec lui dans le même fil. La flèche de retour ramène à la liste, et le compteur de crédits reste sous les yeux.

La même bulle peut aussi héberger un chat Aidoo AI, alternative à Claude ou ChatGPT pour les utilisateurs qui ne veulent pas quitter Odoo. Les deux fonctions s'activent indépendamment depuis la page Clés API.

Symptômes et causes

L'agent est passé en pause tout seul

C'est un comportement voulu, pas une panne. Trois causes possibles :

1. Échecs consécutifs. Le seuil configuré a été atteint. Ouvrez le journal de la dernière exécution : la cause y figure.
2. Odoo injoignable. Le contrôle préalable a échoué plusieurs fois de suite. Vérifiez votre connexion Odoo.
3. Identité Odoo invalide. Le membre dont l'agent emprunte les droits n'a plus de clé Odoo valide, ou elle a expiré.

Corrigez la cause, puis réactivez l'agent depuis sa page.

Il consomme beaucoup plus que prévu

Regardez dans cet ordre :

1. Les outils externes. Une application connectée sans restriction recharge tout son catalogue à chaque tour. C'est la cause la plus fréquente.
2. Le volume traité. Si votre base a grossi, une mission sans plafond traite maintenant dix fois plus d'enregistrements.
3. Le nombre d'allers-retours. Le journal montre chaque appel d'outil. Un agent qui relit dix fois le même enregistrement a une mission mal formulée.
4. Le modèle. Vérifiez que personne ne l'a fait monter d'un cran.

Les résultats varient d'une exécution à l'autre

La mission laisse trop de latitude. Un agent n'est pas déterministe : à consigne floue, résultat variable.

Reprenez la mission et fixez ce qui doit l'être : le filtre exact, le nombre maximal d'éléments, le format du résumé attendu. « Fais le point sur les impayés » et « liste les factures échues de plus de 30 jours, au maximum 20, triées par ancienneté, et termine par le total » ne produisent pas la même stabilité.

Il ne trouve rien alors que les données existent

Presque toujours un problème de droits Odoo, pas de règles Aidoo. Connectez-vous à Odoo avec le compte dont l'agent emprunte l'identité, et cherchez les mêmes enregistrements. S'ils n'apparaissent pas, la cause est là.

Vérifiez ensuite les règles multi-société : l'enregistrement peut appartenir à une société que ce compte ne voit pas.

Un agent événementiel ne se déclenche pas

Trois vérifications :

1. Le premier démarrage ne rejoue pas le passé. L'agent ne traite que les enregistrements créés ou modifiés après son activation.
2. Les conditions sont peut-être trop strictes. Testez le même filtre dans Odoo pour voir s'il ramène des enregistrements.
3. La fréquence de surveillance dépend de votre palier. Sur Starter, la vérification a lieu au maximum une fois par heure : un événement n'est pas traité dans la seconde.

« Crédits épuisés »

Les exécutions sont en file d'attente, elles ne sont pas perdues. Rechargez avec un pack, attendez le renouvellement mensuel, ou libérez du budget en espaçant un agent. Voir Crédits et consommation.

Un agent a fait quelque chose d'inattendu dans Odoo

Ouvrez son journal d'exécution : chaque appel y figure, avec les paramètres. Vous saurez exactement quoi a été modifié et à quel moment.

Puis resserrez : ajoutez une condition de valeur sur la règle concernée, baissez le plafond d'écritures, ou passez l'agent en mode workflows uniquement le temps de reprendre sa configuration.

Cinq habitudes qui évitent les ennuis

Un agent, une mission. Un agent qui relance les impayés et qualifie les leads et surveille le stock est ingérable. Trois agents séparés se règlent, se diagnostiquent et se mettent en pause indépendamment.

Testez à blanc après chaque modification de mission. Le test simule les écritures : il coûte quelques crédits et évite des corrections dans Odoo.

Gardez le plafond d'écritures serré. Cinq par exécution convient à la plupart des missions. Un agent qui bute contre le plafond vous apprend quelque chose sur sa mission.

Relisez le journal la première semaine. Ensuite, le récapitulatif quotidien suffit.

Choisissez la licence Odoo selon le périmètre voulu. Un agent emprunte n'importe quel compte Odoo existant : celui que vous désignez borne déjà ce qu'il peut voir et modifier, avant même les règles Aidoo.

Étape suivante

• Règles et permissions : resserrer le périmètre
• Crédits et consommation : maîtriser le coût