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
aidoo_document	`document`	Non

Une clé API nouvellement créée reçoit les cinq permissions de lecture courantes : query, read, schema, report et print. L'écran de consentement pré-coche les mêmes quand vous connectez Claude ou ChatGPT. Tout le reste, y compris document, doit être activé explicitement : dans Clés API, ou en cochant la case correspondante à l'écran de consentement.

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, has_more et next_offset, pour que l'assistant sache qu'il ne voit qu'une page, et où reprendre.

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. L'équivalent public sur Odoo standard : l'explorateur des modèles Odoo, avec les champs et relations de chaque modèle.

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.

aidoo_documentPermission document · à activer manuellement

Lit le contenu d'une pièce jointe Odoo : PDF, image (scans compris) ou document Word. Renvoie une transcription et une analyse structurée : document signé ou non, dates, montants, parties, cases cochées. C'est l'outil qui répond à « ce devis est-il signé ? » sans que vous ouvriez le fichier.

Cible : une pièce jointe précise, un document d'Odoo Documents, ou les pièces jointes d'un enregistrement (l'assistant vous demande laquelle s'il y en a plusieurs).
Actions : extract lit le document, ask pose une question précise sur un document déjà lu, status suit la lecture d'un long document, traitée en arrière-plan.
Limites : 30 pages et 20 Mo par document. Un fichier Word est lu d'après son texte : la détection de signature n'y est pas disponible.
Coût : 1 crédit par tranche de 20 pages, décompté une seule fois par document. Relire le même fichier dans les 30 jours, ou lui poser une question, ne coûte rien.

Deux verrous s'appliquent : la permission document sur la clé, et le réglage d'espace Paramètres → Lecture de documents par IA (activé par défaut, modifiable par le propriétaire et les administrateurs). Le fichier est lu sous votre identité Odoo : l'outil n'atteint que les pièces jointes que vous voyez. Le contenu lu est transmis à l'assistant comme une donnée, jamais comme une consigne à suivre. Le détail est dans Pièces jointes et OCR.

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.

Ce qu'ils écrivent reste annulable pendant 7 jours depuis Aidoo : les créations toujours, les modifications et suppressions si le snapshot avant écriture est activé. Les actions métier d'aidoo_workflow et d'aidoo_execute ne s'annulent pas.

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, sans corbeille. Seul le réglage « Snapshot avant écriture » d'Aidoo permet de recréer les enregistrements supprimés, avec de nouveaux identifiants, voir Revenir en arrière.

À n'accorder qu'en connaissance de cause

delete est la permission qui détruit de l'information : sans snapshot, il n'y a aucun recours, et même avec lui les lignes liées et les pièces jointes ne reviennent pas. 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`
Lecture de PDF et de scans (signatures, montants)	+ `document`
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. Pour aidoo_document, vérifiez aussi que le réglage Lecture de documents par IA est actif.