Créer un agent
Les quatre chemins de création, le choix du modèle d'IA, l'écriture d'une bonne mission, le déclencheur, les limites, et le test à blanc dès la création.
12 min de lectureMis à jour le 1 octobre 2026
Quatre chemins mènent au même résultat. Choisissez selon ce que vous savez déjà de votre besoin.
Les quatre chemins
| Chemin | Quand le choisir | Temps |
|---|---|---|
| Partir d'un modèle | Votre besoin ressemble à un cas courant | 2 minutes |
| Décrire en français | Vous savez ce que vous voulez, pas comment le régler | 5 minutes |
| Configurer à la main | Vous voulez maîtriser chaque règle | 15 minutes |
| Importer un fichier | Vous reprenez un agent exporté d'un autre espace | 1 minute |
Partir d'un modèle
La Galerie de modèles propose huit agents éprouvés, avec des permissions déjà réduites au strict nécessaire. Vous choisissez, vous ajustez la mission et le planning, c'est prêt.
C'est le chemin recommandé pour un premier agent, même si le modèle ne correspond pas exactement : il est plus simple d'adapter un agent cadré que de tout régler soi-même.
Décrire en français
Avec Décrire en langage naturel, vous écrivez ce que l'agent doit faire, Aidoo propose une configuration complète : mission reformulée, déclencheur, règles, limites. Si un point reste flou, il vous pose d'abord quelques questions.
La description peut être longue, jusqu'à 40 000 caractères : un cahier des charges complet passe sans découpage, Aidoo le condense en une mission de 20 000 caractères au plus. Le modèle proposé est toujours Auto ; vous pourrez en choisir un précis ensuite, depuis la configuration de l'agent.
Chaque lundi matin, repère les devis de plus de 10 000 € envoyés depuis plus de deux semaines sans réponse, et planifie une activité de relance pour le commercial concerné.
La proposition est toujours soumise à votre relecture
Aidoo ne crée jamais l'agent à partir de la seule description. Vous voyez la configuration proposée, vous la modifiez étape par étape, puis vous la créez. Cette génération consomme quelques crédits, comme n'importe quel appel à un modèle.
Configurer à la main
Le Formulaire vierge, étape par étape : Identité, Rôle & modèle IA, Déclencheur, Permissions, Limites & sécurité, Notifications & accès, Récapitulatif. Utile quand votre cas est précis, ou quand vous voulez comprendre exactement ce que fait chaque réglage. Les autres chemins passent par les mêmes étapes, préremplies.
Importer un fichier
Un agent s'exporte au format aidoo-agent/v1 et se réimporte ailleurs avec Importer un fichier JSON (aidoo-agent/v1). Pratique pour reprendre un agent éprouvé dans un autre espace de travail. L'export ne contient ni identité Odoo ni secret : vous redésignez le membre à l'import. Le format, un exemple complet et la référence de chaque champ sont dans Importer et exporter un agent.
Écrire une bonne mission
C'est le réglage qui compte le plus. Une mission floue produit un agent imprévisible.
Dites quoi chercher, précisément. « Les factures en retard » laisse trop de place ; « les factures clients validées, non payées, dont l'échéance est dépassée » ne laisse aucun doute.
Dites quoi faire de chaque élément. L'agent doit savoir s'il ajoute une note, planifie une activité, envoie un e-mail ou se contente de compter.
Dites comment conclure. « Termine par un résumé : nombre de factures en retard, montant total, cinq premiers clients concernés. » Sans cette phrase, la restitution varie d'une exécution à l'autre.
Bornez le volume. « Traite au maximum les 20 plus anciennes » évite qu'une exécution ne parte sur 400 enregistrements le jour où votre base grossit.
La mission accepte jusqu'à 20 000 caractères : assez pour un cahier des charges détaillé, avec ses règles, ses cas particuliers et le format de sortie attendu.
Le test des trois lectures
Faites lire la mission à quelqu'un qui ne connaît pas le besoin. S'il vous pose une question, l'agent se posera la même, et il y répondra tout seul, à sa façon.
Choisir le modèle d'IA
Par défaut, le modèle est Auto : Aidoo choisit un modèle économique adapté aux agents et le tient à jour, sans réglage de votre part. C'est le bon choix pour la plupart des missions.
Si votre mission l'exige, choisissez un modèle précis. Chacun affiche trois repères : Coût, Vitesse, Puissance. Le coût se traduit directement en crédits consommés.
| Type de mission | Modèle conseillé |
|---|---|
| Lister, compter, résumer une liste | Un modèle économique |
| Rédiger un message adapté au contexte | Un modèle intermédiaire |
| Analyser, comparer, décider entre plusieurs options | Le modèle le plus capable |
Commencez avec Auto ou un modèle économique. Si les résultats sont approximatifs, montez d'un cran : c'est plus rentable que de payer un modèle puissant pour compter des factures.
Pendant l'essai gratuit
Seuls les modèles économiques sont disponibles, et l'essai est borné à 500 crédits ou 30 jours, au premier des deux atteint.
Le déclencheur
Trois modes : Planifié, Événementiel ou Conversationnel.
Planifié : un rythme prêt à l'emploi (« Chaque matin ouvré (8h) », « Toutes les heures »…) ou un rythme Personnalisé : fréquence, jours, heure. Le rythme personnalisé accepte jusqu'à 5 créneaux pour des horaires différents selon les jours, par exemple du lundi au jeudi à 15 h et le vendredi à 13 h (Ajouter un créneau). Aucun palier ne borne cette fréquence : l'agent suit exactement le planning que vous lui donnez, dans son fuseau, avec au moins 5 minutes entre deux exécutions. Les Horaires de fonctionnement limitent en option les exécutions automatiques à certains jours et créneaux.
Événementiel : vous désignez un modèle Odoo, le type d'événement (création ou modification), et des conditions facultatives. Aidoo surveille ce modèle à un rythme fixé par votre palier : une heure sur Starter, un quart d'heure sur Pro, cinq minutes sur Business. C'est le délai de réaction maximal de l'agent.
Exemple : modèle crm.lead, à la création, sans condition, pour qualifier chaque nouveau lead. Ou modèle sale.order, à la modification, avec la condition state = sale, pour réagir aux commandes confirmées.
Événementiel, à une date : avec À une date de l'enregistrement, l'agent s'exécute au moment exact où tombe un champ date de l'enregistrement, avancé ou retardé du nombre de minutes choisi (3 points de déclenchement au plus, une semaine de décalage au maximum). Exemple : modèle calendar.event, 30 minutes avant start pour préparer un briefing.
Conversationnel : aucun déclencheur. L'agent répond quand on lui parle, depuis Aidoo ou depuis la bulle Odoo.
L'identité Odoo
À l'étape Identité, le champ Compte Odoo de l'agent désigne le compte dont l'agent empruntera les droits. Seuls les propriétaires et administrateurs peuvent faire ce choix. Seuls les comptes dont le membre a enregistré son jeton Odoo personnel dans Aidoo sont sélectionnables : les autres apparaissent grisés.
Aucune licence Odoo à ajouter
Un agent se pose sur n'importe quelle licence Odoo existante : il emprunte le compte d'un membre déjà en place, sans utilisateur supplémentaire à créer ni licence à payer. Ce compte fixe son périmètre, alors choisissez-le en fonction de ce que l'agent doit pouvoir toucher.
Les permissions : l'apprentissage par défaut
Vous n'avez pas à remplir la matrice des règles à la création. La case Mode apprentissage est cochée d'office : pendant 48 heures, l'agent découvre lui-même ce dont il a besoin.
- Il lit tout ce que son compte Odoo voit.
- Une écriture sur un modèle qui n'est couvert par aucune règle est mise en attente : vous l'approuvez ou la refusez, depuis Aidoo ou depuis la bulle Odoo. Rien n'est écrit sans vous.
- Chaque accès réellement exécuté est noté dans la liste des accès observés, visible sur la fiche de l'agent.
- Au bout de 48 heures, les permissions sont figées : les accès observés deviennent des règles ordinaires, que vous pouvez retoucher. Vous pouvez aussi figer plus tôt, d'un clic.
Les règles d'un modèle de la galerie, d'une génération par prompt ou d'un fichier importé restent en place comme règles de départ : leurs écritures passent sans validation, l'apprentissage complète le reste. Une fois les permissions figées, un propriétaire ou un administrateur peut Relancer l'apprentissage depuis la fiche de l'agent pour une nouvelle fenêtre de 48 heures.
Décochez la case pour retrouver l'éditeur de règles classique, décrit dans Règles et permissions.
Faites-le travailler pendant la fenêtre
Un agent qui n'a rien observé se retrouve sans aucune permission au gel. Lancez-le, discutez avec lui, laissez-le traiter quelques cas réels : c'est ce qu'il fait pendant ces 48 heures qui fixe ce qu'il aura le droit de faire ensuite.
La même étape propose des capacités facultatives, toutes désactivées par défaut :
- Accès web : chercher sur le web et lire des pages publiques.
- Validation humaine des écritures : chaque création, modification ou action dans Odoo attend votre accord.
- Proposer des e-mails (envoi validé) : l'agent prépare des e-mails Odoo, vous les relisez avant envoi. L'Envoi automatique s'active après la création, depuis la fiche de l'agent.
- Lecture de documents : lire les PDF et images attachés aux enregistrements, scans compris.
- Peut poser une question à un humain : en exécution autonome, l'agent s'arrête sur une question et reprend avec votre réponse.
- Drive Aidoo : lire et écrire des fichiers dans l'espace de fichiers du workspace.
Les apps externes (Slack, Gmail…) sont décrites dans Intégrations.
Notifications et accès
L'avant-dernière étape règle où l'agent rend compte : e-mail, chatter Odoo, canal Discuss. Elle désigne aussi, dès la création, les utilisateurs Odoo qui verront l'agent dans la bulle Aidoo de leur Odoo : votre propre compte est précoché s'il est lié, et Tout sélectionner coche toute l'équipe. Un agent conversationnel n'est utilisable dans Odoo que par les utilisateurs cochés ici. La liste reste modifiable depuis la fiche de l'agent.
Les limites de sécurité
L'étape Limites & sécurité regroupe les garde-fous, réglables par agent :
| Limite | Rôle | Par défaut |
|---|---|---|
| Actions max / exécution | Empêche une boucle de consommer sans fin | Illimité (champ vide) |
| Crédits max / exécution | Plafonne le coût d'une exécution | 100 crédits, aussi le minimum |
| Délai max (secondes) | Interrompt une exécution qui traîne | 300 s, jusqu'à 4 500 s |
| Écritures max / exécution | Bloque l'agent au-delà de N écritures | Illimité (champ vide) |
Une écriture compte un appel, pas un enregistrement : modifier 50 tickets en un seul appel groupé compte pour 1. Le plafond d'écritures reste le plus utile au démarrage : réglé à 5, il vous laisse constater ce que l'agent modifie avant de lui laisser la bride.
La Pause automatique arrête l'agent après plusieurs échecs d'affilée (3 par défaut). Vous pouvez aussi fixer un Budget mensuel de l'agent (crédits), en plus du pool de l'espace de travail, et, si l'agent envoie lui-même ses e-mails, un nombre maximal d'E-mails automatiques max / exécution (10 par défaut).
Créer l'agent
Le Récapitulatif se termine par un seul bouton, Créer l'agent : l'agent est créé et activé immédiatement. Il reçoit sa propre clé API, dont les permissions sont dérivées exactement de ses règles : ni plus, ni moins. Pendant la fenêtre d'apprentissage, cette clé porte toutes les opérations, le moteur de règles décidant appel par appel ; elle est resserrée au gel.
Si l'activation est refusée (pas d'abonnement Agents, palier insuffisant, nombre d'agents actifs atteint), l'agent reste en Brouillon : sa fiche affiche la raison et le bouton Activer.
Tester sans risque
Faites un test à blanc dès la création
Aucun test n'est lancé automatiquement. Depuis la fiche de l'agent, Tester (dry run) exécute la mission réellement, mais simule les écritures : l'agent vous montre ce qu'il aurait créé ou modifié, sans rien changer dans Odoo. C'est le seul moyen de voir comment il interprète votre mission avant qu'elle ne produise des effets. Si vous voulez tester avant son premier créneau, ou retoucher sa mission d'abord, mettez-le en pause (Mettre en pause) le temps des essais.
Chaque exécution dépose son compte rendu dans le fil de discussion de l'agent : ce qu'il a constaté, ce qu'il a réellement écrit, et les chiffres qui résument son passage. C'est la première chose à relire après un test.
Pour le détail, l'icône de débogage sur une bulle d'exécution ouvre la trace complète : chaque appel d'outil, avec ses paramètres, son résultat, son statut et sa durée. Si l'agent lit dix fois le même enregistrement ou part sur un modèle inattendu, la mission est à reformuler.
Une exécution qui part dans la mauvaise direction, réelle ou simulée, s'interrompt avec Arrêter : l'outil en cours se termine, puis l'agent s'arrête.
La première exécution réelle mérite une relecture attentive. Ensuite, le récapitulatif quotidien suffit.
Après la création
Tout se règle ensuite depuis la fiche de l'agent :
- Renommer : cliquez sur son nom.
- Mettre en pause, Reprendre, Exécuter à la demande.
- Dupliquer : une copie en brouillon, avec la même configuration et ses sources de connaissance.
- Archiver : l'agent est désactivé et sa clé API révoquée. Retrouvez-le avec Voir les agents archivés dans la liste : Désarchiver le remet en pause avec sa clé réactivée.
- Commandes rapides et Agents collaborateurs se configurent uniquement sur la fiche, pas dans l'assistant de création. Voir Un agent, c'est quoi ?.
Étape suivante
- Règles et permissions : borner ce que l'agent peut toucher
- Crédits et consommation : mesurer et maîtriser le coût
- Bonnes pratiques et dépannage : quand un agent se comporte mal