Agents et outils

Agents

Un agent est un utilisateur Odoo que votre entreprise configure pour Abstr.ax. Il a ses propres droits dans Odoo, par exemple sales pour les commandes et les clients, ou finance pour les factures. Un agent voit seulement les modèles que votre entreprise autorise pour lui, avec les règles d'enregistrement de son utilisateur Odoo.

Vous pouvez utiliser 1 ou plusieurs agents. Votre entreprise décide lesquels.

L'argument agent

Chaque outil a l'argument agent. Votre assistant le remplit :

• Avec 1 agent, l'argument est facultatif.
• Avec plusieurs agents, l'assistant nomme l'agent dans chaque appel. Les instructions de la connexion décrivent vos agents, pour que l'assistant puisse choisir. Vous pouvez aussi le lui dire : « Utilise l'agent finance. »
• Un outil qui modifie des données accepte seulement les agents qui peuvent modifier des données.

Ce que l'assistant peut faire

• Chercher des modèles et des champs : odoo_schema_search, odoo_models, odoo_fields. L'assistant cherche ici d'abord, pour ne pas deviner les noms de champs.
• Lire des données : odoo_search, odoo_read, odoo_aggregate, odoo_report.
• Calculer : odoo_compute exécute un court script Python sur des données Odoo et renvoie seulement le résultat.
• Modifier des données : odoo_create, odoo_write, odoo_call, odoo_post_message. Seul un agent avec des droits d'écriture a ces outils, et votre client vous demande votre accord avant chaque modification.

La référence des outils montre tous les arguments.

Recettes

Une recette est une suite fixe d'appels d'outils avec son propre nom, par exemple « factures ouvertes d'un client ». Votre assistant propose une recette avec l'outil propose_recipe. Après l'approbation d'un administrateur de votre entreprise, chaque personne qui a cet agent peut l'exécuter aussitôt, sans nouvelle connexion : list_recipes donne les recettes approuvées avec leurs paramètres, run_recipe exécute une recette qui lit, et run_write_recipe une recette qui modifie des données. Les instructions de la connexion nomment aussi les recettes approuvées.

Une étape peut exécuter odoo_compute : la recette est alors un script approuvé qui ne renvoie que son résultat. Les réponses restent ainsi courtes. Le script reçoit ses valeurs par inputs. Une étape avec foreach s'exécute 1 fois pour chaque élément d'une liste, par exemple pour lettrer chaque ligne d'un relevé après 1 approbation. Si un élément échoue, la recette s'arrête et indique lequel ; les éléments précédents sont exécutés.

Grandes réponses

Abstr.ax donne chaque enregistrement qu'Odoo renvoie ; il ne fixe pas de maximum lui-même. Une réponse trop grande pour la conversation reste entière 1 heure comme ressource : l'assistant reçoit un résumé avec le nombre et les premières lignes, et des liens vers la réponse entière en JSON et en CSV. Votre client peut récupérer ces liens. Pour calculer sur un grand ensemble, l'assistant utilise odoo_compute, qui lit les données sur le serveur et renvoie seulement le résultat.

Fichiers Excel et CSV

odoo_export écrit des enregistrements dans un fichier Excel (XLSX) ou CSV avec l'export d'Odoo. Un chemin de champ suit une relation, par exemple partner_id/name, et partner_id/id donne l'identifiant externe. La réponse contient un lien de téléchargement qui ouvre le fichier pendant 1 heure dans un navigateur, sans connexion : toute personne qui a le lien peut ouvrir le fichier pendant cette heure. Le fichier est aussi une ressource de la conversation.

odoo_import importe un fichier CSV ou Excel avec l'import d'Odoo : chaque ligne, ou aucune si 1 ligne échoue, avec le numéro de ligne du fichier dans le message. La ligne 1 est l'en-tête avec les chemins de champ, ou l'assistant donne le chemin de champ de chaque colonne. Une colonne id avec un identifiant externe fait qu'un 2e import du même fichier met les enregistrements à jour au lieu de les ajouter à nouveau. L'assistant peut réimporter un export précédent par sa ressource, après une modification.

Langue

Les outils, les erreurs et les données Odoo arrivent dans votre langue : anglais, néerlandais ou français. Abstr.ax prend la langue de votre profil de connexion. Votre entreprise peut la changer.