07Configuration ODESA

L'analyste commercial

Produire des analyses commerciales en langage naturel à partir de la base des ventes (CRM/ERP), avec restitution dans un rapport Excel ou Word.

Besoin métier

Les directions commerciales disposent d'une mine de données dans leur CRM ou leur ERP, mais l'analyse reste coûteuse : exports, tableaux croisés, mise en forme. Les indicateurs clés, top clients, évolution du CA, marges, performance par commercial / région / produit, demandent à chaque fois un retraitement manuel.

Le besoin : obtenir ces analyses à la demande, en langage naturel, à partir des données réelles, et pouvoir les figer dans un rapport diffusable sans effort.

Comment ça fonctionne

Capacités ODESA mobilisées

sql (centrale)

Interroger la base des ventes en lecture (query), agréger et croiser les axes commerciaux.

fichiers (fs)

Déposer un export (CSV/Excel) des analyses dans un dossier autorisé.

COM Windows (com)

Optionnel : piloter Excel/Word pour un rapport mis en forme (tableaux, onglets, en-têtes).

interaction humaine (ui)

Optionnel : confirmer la diffusion ou le périmètre d'un rapport.

VScript

Optionnel : encapsuler les analyses récurrentes (CA du mois, top clients…).

Déroulé type

1

L'utilisateur : « Quel est le chiffre d'affaires de ce trimestre, et comment se compare-t-il au même trimestre l'an dernier ? »

2

L'utilisateur : « Décompose cette évolution par région. »

3

L'utilisateur : « Sur la région Est, quels clients ont le plus baissé ? »

4

L'utilisateur : « Donne-moi la marge moyenne par commercial sur le trimestre. »

5

L'utilisateur : « Mets ces analyses dans un rapport Excel, un onglet par thème, et dépose-le dans le dossier comité. »

Données & accès
  • Base des ventes : la base du CRM ou de l'ERP (SQLite, PostgreSQL ou SQL Server ; pilote mssql en pur Python pour SQL Server).
  • Identifiants : un compte lecture seule dédié, déclaré comme connexion nommée.
  • Cartographie : description des tables et colonnes des ventes (commandes, lignes, clients, commerciaux, régions, produits, marges).
  • Dossier de rapports : une racine autorisée pour déposer les fichiers Excel/CSV.
  • Office (si COM utilisé) : Excel/Word installés sur la machine ODESA, ProGID autorisés.
Bornage & sécurité
  • Connexion nommée en lecture seule vers la base des ventes (droit d'écriture retiré côté SGBD).
  • Capacité sql limitée à query ; pas d'écriture.
  • Racine de fichiers restreinte au dossier des rapports.
  • Si COM activé : ProGID limités à Excel/Word.
  • Jeton Bearer exigé pour tout appel.
  • Configuration chiffrable/verrouillable ; tout tourne en local, chiffres commerciaux et rapports restent chez le client.

Mise en place

Les étapes pour configurer ODESA sur ce cas d'usage.

1

Installer ODESA en local sur le poste/serveur ayant accès à la base des ventes.

2

Créer un compte lecture seule sur le CRM/ERP et le déclarer en connexion nommée.

3

Activer la capacité sql en lecture ; cartographier les tables commerciales.

4

Définir la racine du dossier de rapports ; si besoin, autoriser Excel/Word via COM.

5

Poser le jeton Bearer.

6

Valider avec un comité « blanc » : quelques analyses types + génération d'un rapport.

Limites & points d'attention
  • Définition des indicateurs : « marge », « CA », « client actif » doivent être définis sans ambiguïté ; la cartographie doit refléter ces règles.
  • Qualité des données source : doublons clients, lignes annulées, devises… peuvent fausser une analyse si elles ne sont pas prises en compte.
  • Lecture seule : l'IA ne corrige pas la base ; les anomalies se traitent à la source.
  • Volumétrie : sur de gros historiques, borner les périodes pour garder des temps de réponse courts.
  • Confidentialité : restreindre le périmètre aux données que l'utilisateur a le droit de voir.
Évolutions possibles
  • Fonctions VScript pour les analyses récurrentes (tableau de bord commercial standard).
  • Rapport périodique automatique via planification VAILS (hebdomadaire, mensuel).
  • Alertes : prévenir quand un client clé décroche ou qu'une marge passe sous un seuil.
  • Croiser avec d'autres bases (stocks, livraisons) pour des analyses de bout en bout.
  • Combiner avec l'index plein-texte pour relier comptes rendus de visite et performance client.

Mettez ODESA au travail.

ODESA installe l'IA agentique chez vos clients, en local et sous contrôle. Devenez le partenaire qui la déploie.

07ODESA configuration

The sales analyst

Produce sales analyses in plain language from the sales database (CRM/ERP), with output to an Excel or Word report.

Business need

Sales departments hold a goldmine of data in their CRM or ERP, but analysis stays costly: exports, pivot tables, formatting. Key indicators, top customers, revenue trend, margins, performance by rep / region / product, each require manual rework.

The need: obtain these analyses on demand, in plain language, from the real data, and be able to freeze them in a shareable report effortlessly.

How it works

ODESA capabilities used

sql (core)

Query the sales database read-only (query), aggregate and cross-reference the sales axes.

Files (fs)

Drop an export (CSV/Excel) of the analyses in an allowed folder.

Windows COM (com)

Optional: drive Excel/Word for a formatted report (tables, tabs, headers).

Human interaction (ui)

Optional: confirm the distribution or scope of a report.

VScript

Optional: encapsulate recurring analyses (month's revenue, top customers…).

Typical flow

1

User: "What is this quarter's revenue, and how does it compare to the same quarter last year?"

2

User: "Break this trend down by region."

3

User: "On the East region, which customers dropped the most?"

4

User: "Give me the average margin per rep for the quarter."

5

User: "Put these analyses in an Excel report, one tab per theme, and drop it in the committee folder."

Data & access
  • Sales database: the CRM or ERP database (SQLite, PostgreSQL or SQL Server; pure-Python mssql driver for SQL Server).
  • Credentials: a dedicated read-only account, declared as a named connection.
  • Mapping: description of the sales tables and columns (orders, lines, customers, reps, regions, products, margins).
  • Reports folder: an allowed root to drop the Excel/CSV files.
  • Office (if COM used): Excel/Word installed on the ODESA machine, allowed ProgIDs.
Scope & security
  • Read-only named connection to the sales database (write right removed at the DBMS level).
  • sql capability limited to query; no writing.
  • File root restricted to the reports folder.
  • If COM enabled: ProgIDs limited to Excel/Word.
  • Bearer token required for any call.
  • Configuration encryptable/lockable; everything runs locally, sales figures and reports stay with the customer.

Setup

The steps to configure ODESA for this use case.

1

Install ODESA locally on the workstation/server with access to the sales database.

2

Create a read-only account on the CRM/ERP and declare it as a named connection.

3

Enable the sql read capability; map the sales tables.

4

Define the reports-folder root; if needed, authorise Excel/Word via COM.

5

Set the Bearer token.

6

Validate with a "dry-run" committee: a few standard analyses + report generation.

Limits & caveats
  • Indicator definitions: "margin", "revenue", "active customer" must be defined unambiguously; the mapping must reflect these rules.
  • Source-data quality: duplicate customers, cancelled lines, currencies… can skew an analysis if not accounted for.
  • Read-only: the AI does not fix the database; anomalies are handled at the source.
  • Volume: on large histories, bound the periods to keep response times short.
  • Confidentiality: restrict the scope to the data the user is allowed to see.
Possible extensions
  • VScript functions for recurring analyses (standard sales dashboard).
  • Automatic periodic report via VAILS scheduling (weekly, monthly).
  • Alerts: warn when a key customer slips or a margin falls below a threshold.
  • Cross-reference with other databases (stock, deliveries) for end-to-end analyses.
  • Combine with the full-text index to link visit reports and customer performance.

Put ODESA to work.

ODESA brings agentic AI to your clients, locally and under control. Become the partner who deploys it.