Aidoo expose votre Odoo sous forme d'outils. L'assistant en choisit un, Aidoo vérifie qu'il a le droit de l'utiliser, puis exécute l'appel sur votre base.

Cette page est l'inventaire complet. Chaque outil renvoie vers la page qui le détaille.

La matrice complète

Outil	Permission	Par défaut
aidoo_query	`query`	Oui
aidoo_read	`read`	Oui
aidoo_schema	`schema`	Oui
aidoo_report	`report`	Oui
aidoo_print	`print`	Oui
aidoo_create	`create`	Non
aidoo_write	`write`	Non
aidoo_delete	`delete`	Non
aidoo_execute	`execute`	Non
aidoo_workflow	`execute`	Non
aidoo_workflow_run	`workflow`	Non
aidoo_feedback	`feedback`	Non
aidoo_attach	`attach`	Non

Une clé API nouvellement créée reçoit les cinq permissions de lecture. Tout le reste doit être activé explicitement dans Clés API.

Les outils de lecture

Ils ne peuvent rien modifier : la liaison outil → méthode Odoo est verrouillée côté serveur, aidoo_query ne sait appeler que search_read et search_count.

aidoo_queryPermission query · activée par défaut

Cherche et lit des enregistrements. C'est l'outil le plus utilisé, celui qui répond à « quels devis… », « combien de clients… », « la liste des factures… ».

Paramètres : model, domain (le filtre Odoo), fields, limit (80 par défaut), offset, order. Renvoie les enregistrements, mais aussi total_count et has_more, pour que l'assistant sache qu'il ne voit qu'une page.

aidoo_readPermission read · activée par défaut

Lit des enregistrements dont on connaît déjà les identifiants. Plus direct que aidoo_query quand l'assistant vient de trouver un id.

aidoo_schemaPermission schema · activée par défaut

Découvre la structure de votre base : la liste des modèles, ou les champs d'un modèle précis avec leur type et leurs relations. Aucune donnée métier n'est lue.

C'est aussi l'outil qui renvoie les hints : vos consignes métier attachées à un modèle.

aidoo_reportPermission report · activée par défaut

Agrège sans rapatrier. Regroupe par un ou plusieurs champs et calcule une mesure : chiffre d'affaires par mois, encours par commercial, quantités par catégorie.

À préférer systématiquement à aidoo_query dès qu'il s'agit de totaux : Odoo fait le calcul, seuls les résultats transitent.

aidoo_printPermission print · activée par défaut

Génère un PDF via le moteur de rapports QWeb d'Odoo et renvoie un lien de téléchargement. Facture, devis, bon de livraison, ordre de fabrication.

Il est classé en lecture seule : il produit un document, il ne modifie aucun enregistrement.

Les outils d'écriture

Aucun n'est accordé par défaut. Ce sont les permissions de votre clé qui les bornent, pas une confirmation supplémentaire, voir Écrire dans Odoo.

aidoo_createPermission create · à activer manuellement

Crée un ou plusieurs enregistrements. En mode groupé, les enregistrements partent en un seul appel Odoo, ce qui préserve la cohérence.

aidoo_writePermission write · à activer manuellement

Modifie des enregistrements existants. En mode groupé, chaque lot d'identifiants reçoit ses propres valeurs, et le résultat détaille le succès ou l'échec de chaque lot.

aidoo_deletePermission delete · à activer manuellement

Supprime définitivement : c'est l'unlink d'Odoo. Irréversible, sans corbeille.

À n'accorder qu'en connaissance de cause

delete est la seule permission qui détruit de l'information sans recours. Dans la plupart des déploiements, elle reste désactivée : archiver un enregistrement via aidoo_write répond au même besoin et se rattrape.

aidoo_workflowPermission execute · à activer manuellement

Déclenche une action métier d'Odoo, les boutons de vos écrans : confirmer un devis, valider une facture, réceptionner un transfert. Seules les méthodes préfixées action_ ou button_ sont autorisées.

aidoo_executePermission execute · à activer manuellement

Appelle une méthode Odoo arbitraire, pour les cas que les autres outils ne couvrent pas. Les méthodes qui doublonneraient un outil dédié sont bloquées (create, write, unlink, read, search_read…), afin qu'une permission ne puisse pas en contourner une autre.

C'est l'outil le plus puissant, donc celui à accorder le plus parcimonieusement.

Les outils spécialisés

Trois outils, un même mot

Trois outils portent « workflow » dans leur nom et ne font pas du tout la même chose. C'est la confusion la plus fréquente de tout le catalogue.

Outil	Ce qu'il exécute	Permission
`aidoo_workflow`	Un bouton Odoo : confirmer un devis, valider une facture. Rien à voir avec les workflows Aidoo	`execute`
`aidoo_workflow_list`	Rien. Il liste vos workflows Aidoo enregistrés	`workflow`
`aidoo_workflow_run`	Un workflow Aidoo : la suite d'étapes que vous avez enregistrée	`workflow`

Retenez le partage : aidoo_workflow agit dans Odoo, les deux autres agissent sur ce que vous avez enregistré dans Aidoo.

aidoo_workflow_run

Exécute un workflow Aidoo : une suite d'étapes enregistrée une fois, rejouée d'une phrase, avec des variables.

Un workflow enregistré peut effectuer des opérations que les outils individuels refuseraient : c'est vous qui l'avez validé à la création.

L'assistant appelle aidoo_workflow_list en début de conversation pour savoir ce qui existe, puis aidoo_workflow_run pour exécuter celui qui correspond.

aidoo_feedbackPermission feedback · à activer manuellement

Met à jour le hint d'un modèle quand vous corrigez l'assistant. C'est le mécanisme d'apprentissage d'Aidoo, voir Hints et apprentissage.

Exige la permission feedback et le droit canUpdateHints sur votre profil membre.

aidoo_attachPermission attach · à activer manuellement

Fait remonter un fichier vers Odoo sans le faire transiter par l'IA : l'assistant vous donne un lien d'envoi à usage unique, vous déposez le fichier, Odoo le reçoit. Sert aussi à la digitalisation de factures fournisseur.

Comment choisir les permissions à accorder

Une progression qui marche

Commencez en lecture seule pendant une semaine. Ajoutez create quand un besoin concret apparaît. N'ouvrez execute que pour un usage identifié, et gardez delete fermé.

Usage	Permissions
Consultation, reporting, analyse	Les cinq permissions de lecture, par défaut
Saisie assistée (contacts, notes, activités)	+ `create`, `write`
Traitement de bout en bout (confirmer, valider)	+ `execute`
Rattrapage de données, corrections en masse	+ `delete`, temporairement

Chaque permission se règle par clé et par environnement : vous pouvez autoriser les écritures sur votre base de test et les refuser en production.

Ce que l'assistant sait avant d'essayer

Au démarrage, aidoo_context renvoie la liste des outils réellement disponibles. L'assistant sait donc à l'avance ce qu'il ne peut pas faire, et vous le dit au lieu de tenter l'opération et d'échouer.

Si une action vous est refusée alors que vous pensiez y avoir droit, vérifiez dans cet ordre : la permission de la clé, puis les droits du compte Odoo, puis les modèles bloqués dans Sécurité et permissions.