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.

Quand un agent attend quelque chose de vous (une opération à valider, la réponse à une question), il le signale dans Aidoo, et selon ses réglages de notification, dans la bulle Odoo ou par e-mail.

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 : dès la création, à l'étape Notifications & accès, puis à tout moment 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. Les opérations à valider, les e-mails proposés et les questions de l'agent s'y traitent aussi, sans passer par Aidoo.

La fiche ouverte suit vos messages. Quand vous écrivez à un agent depuis une fiche Odoo (un devis, un lead, une facture), cette fiche est jointe au message : une puce au-dessus du champ de saisie la rappelle. Elle est cochée par défaut ; un clic la décoche, et ce choix est mémorisé dans votre navigateur. L'agent ne lit la fiche que si votre demande la concerne, et toujours dans le cadre de ses règles.

Plusieurs agents à la fois. Sur ordinateur, l'épingle à côté d'un agent (Épingler dans une fenêtre) l'ouvre dans sa propre fenêtre en bas de l'écran Odoo, jusqu'à trois en même temps. Un clic simple ouvre toujours l'agent dans le panneau.

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. Le motif s'affiche dans le bandeau « Agent mis en pause automatiquement » de sa fiche. Quatre causes possibles :

1. Échecs consécutifs. Le seuil configuré (3 par défaut) 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é.
4. Plafond d'écritures dépassé. Si vous avez renseigné Écritures max / exécution, une exécution qui le dépasse met l'agent en pause.

Corrigez la cause, puis cliquez sur Reprendre depuis sa fiche.

Il ne s'exécute plus à l'heure prévue

Son statut n'indique aucune pause, mais ses exécutions planifiées ne partent plus. Cause la plus fréquente : une opération attend votre validation. Le dernier compte rendu se termine par « Une opération attend votre validation. L'agent est en pause ». Tant qu'elle n'est pas tranchée, les exécutions planifiées sont sautées, sans rien consommer. Approuvez ou rejetez-la : l'agent reprend aussitôt avec votre décision. Voir la validation humaine.

Autres causes à vérifier : une plage horaire d'activité qui exclut l'heure prévue, le budget mensuel de l'agent épuisé, le pool de crédits vide, ou l'interrupteur général activé.

L'exécution s'arrête avant la fin

Le compte rendu indique toujours pourquoi. Les messages les plus courants :

Toutes ces limites se règlent dans Limites & sécurité, à la création ou depuis la fiche de l'agent.

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.
5. Les documents lus. Chaque nouveau document lu coûte 1 crédit par tranche de 20 pages ; un agent qui ouvre toutes les pièces jointes d'un gros lot le sent passer.

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.

Pour un déclencheur sur date, Aidoo repère les échéances à venir toutes les 10 minutes au plus : un enregistrement créé ou déplacé moins de 10 minutes avant son échéance peut partir en retard, voire être manqué.

« Crédits épuisés »

Aucune exécution ne part tant que le pool est vide, et rien n'est facturé. Les exécutions prévues entre-temps sont sautées ; l'agent reprend son rythme dès que des crédits reviennent. Prenez une recharge, attendez le renouvellement mensuel, ou libérez du budget en espaçant un agent. Voir Crédits et consommation.

Si le message est « Votre limite mensuelle de crédits IA est atteinte », c'est votre plafond personnel qui est atteint, pas le pool : seul un propriétaire ou un administrateur peut le relever, depuis la page Équipe.

Un agent a fait quelque chose d'inattendu dans Odoo

Si l'exécution est encore en cours, cliquez sur Arrêter dans la bulle « Run en cours » de son fil : l'outil en cours se termine, puis plus rien ne part.

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

Puis resserrez : ajoutez une condition de valeur sur la règle concernée, fixez un plafond d'écritures, cochez Validation humaine des é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 bouton Tester (dry run) simule les écritures : il coûte quelques crédits et évite des corrections dans Odoo.

Fixez un plafond d'écritures serré. Le champ est vide (illimité) par défaut ; cinq par exécution convient à la plupart des missions qui débutent. 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