Chemins d'analyse

Un chemin d’analyse est un nom convivial pour une table que vous analysez souvent, comme « Résultats opérationnels » ou « le compte de résultat ». Enregistrez-le une fois, et vous (ainsi que votre assistant IA connecté) pourrez ensuite poser des questions à son sujet par ce nom, sans répéter à chaque fois de quel projet et de quelle table il s’agit.

Choisissez-en un comme valeur par défaut de l’espace de travail, et des questions simples comme « pourquoi ce chiffre a-t-il augmenté le trimestre dernier ? » fonctionnent directement : l’assistant sait déjà à quoi « ce chiffre » fait référence.

Pourquoi les utiliser

Sans chemin d’analyse, chaque question doit préciser exactement où se trouvent les données (le projet et la table), ce qui devient vite fastidieux et facilite les erreurs. Avec un chemin, vous parlez de vos données comme vous y pensez réellement :

Interrogez par nom. « Résume les résultats opérationnels. » plutôt que « résume la table ops_summary_v3 du projet Enterprise Profitability. »
Définissez une valeur par défaut. Marquez votre table la plus utilisée comme valeur par défaut et supprimez complètement le nom : « qu’est-ce qui a changé depuis le mois dernier ? » aboutit automatiquement sur les bonnes données.
Gardez tout le monde cohérent. Quand toute l’équipe parle du « compte de résultat », tous atteignent la même table : pas de supposition, pas de copies périmées.

Enregistrer un chemin d’analyse

Si vous êtes administrateur de l’espace de travail, vous n’avez besoin ni d’un formulaire ni d’un écran de paramètres : demandez simplement à votre assistant IA connecté, en langage courant, d’enregistrer le chemin pour vous :

« Enregistre un chemin d’analyse nommé Résultats opérationnels qui pointe vers la table ops_summary du projet Enterprise Profitability. »

L’assistant confirme le chemin, qui est immédiatement prêt à l’emploi. Vous pouvez en enregistrer autant que vous le souhaitez, un par table que vous analysez régulièrement.

Définir un chemin par défaut

En tant qu’administrateur, marquez un chemin comme valeur par défaut pour que les questions qui ne nomment pas de table aboutissent automatiquement sur lui :

« Fais de Résultats opérationnels le chemin d’analyse par défaut. »

À partir de là, « quels ont été les principaux écarts ce trimestre ? » ou « pourquoi le total a-t-il baissé ? » s’exécutent sur cette table sans rien d’autre à préciser. Il n’y a qu’une seule valeur par défaut pour tout l’espace de travail, de sorte que les questions sans cible de chacun se résolvent vers la même table. Définir une nouvelle valeur par défaut déplace simplement la couronne : il n’y en a jamais qu’une, et l’assistant vous dit laquelle.

Rendre un chemin utile aux assistants IA

Un nom et une table indiquent à un assistant où se trouvent les données. Ils ne lui disent pas ce que les données signifient : quels filtres s’appliquent toujours, comment fonctionne votre exercice fiscal, à quoi renvoient les mots de votre équipe. Sans cela, un assistant devine, et une mauvaise réponse assurée est pire qu’une réponse lente. Cette section couvre les deux endroits où consigner ces connaissances, et pourquoi les deux comptent.

Dans ce guide, assistants IA désigne tout LLM connecté via le MCP de PlaidCloud (Claude, Microsoft Copilot, ChatGPT et d’autres) ainsi que l’IA intégrée de PlaidCloud.

Ajouter des Consignes pour l’invite

Chaque chemin d’analyse possède des Consignes pour l’invite : du texte libre, rédigé par vous, qui indique aux assistants comment utiliser le chemin. Écrivez une directive par ligne.

Pour les ajouter, ouvrez le menu Outils et choisissez Chemins d’analyse, puis sélectionnez un chemin et choisissez Modifier (ou choisissez Nouveau pour en créer un). Le champ Consignes pour l’invite suit Table, juste avant Définir comme valeur par défaut de l’espace de travail. Un assistant connecté avec l’autorisation de gérer les chemins d’analyse peut aussi les définir. Les appelants MCP et API voient ce champ sous le nom description, par exemple : « Définis la description du chemin Résultats opérationnels sur … »

Les assistants utilisent les Consignes pour l’invite de deux façons :

Pour choisir le chemin. Lorsqu’une question ne nomme aucun chemin, l’assistant la compare au nom et aux Consignes pour l’invite de chaque chemin et choisit la meilleure correspondance.
Comme consignes permanentes. Une fois un chemin choisi, l’assistant applique les Consignes pour l’invite à chaque requête sur ce chemin : les filtres à inclure, la terminologie à traduire. Pour un assistant connecté par MCP, les chiffres métier eux-mêmes proviennent des définitions de métriques du projet, et non des consignes.

Les Consignes pour l’invite sont stockées avec le chemin et visibles par toutes les personnes de l’espace de travail qui peuvent voir les chemins d’analyse. Elles parviennent aux assistants qui passent par MCP et à l’IA intégrée de PlaidCloud. Elles ne sont pas transmises à l’assistance IA d’une étape LLM de workflow.

Que rédiger

Incluez ce qu’un nouvel analyste aurait besoin de savoir dès son premier jour avec cette table. Donnez à chaque directive sa propre ligne.

Rédigez ceci	Exemple
Les questions auxquelles le chemin répond, et celles auxquelles il ne répond pas.	« Résultats opérationnels mensuels par unité commerciale. À utiliser pour les questions de chiffre d’affaires, de coûts et d’EBITDA. Pas pour les effectifs ni les prévisions ; utilisez le chemin Prévision. »
La métrique que désigne un terme métier, pour les assistants connectés par MCP.	« “Chiffre d’affaires” correspond à la métrique Chiffre d’affaires net. `billed_amount` est la facturation, pas le chiffre d’affaires. »
Les filtres qui s’appliquent toujours.	« Exclure toujours `scenario = 'Budget'` sauf si la question porte sur le budget. Les lignes intersociétés ont `entity_type = 'IC'` ; ne les incluez pas dans les totaux. »
Conventions de signe, calendrier et granularité.	« Les coûts sont stockés en négatif. L’exercice fiscal commence en juillet, donc FY26 va de juil. 2025 à juin 2026. Une ligne par unité commerciale et par mois. »
Termes métier associés aux données.	« “Le Midwest” signifie `region IN ('IL','IN','OH','MI')`. “Produits principaux” signifie `product_tier = 'A'`. »

Restez bref et précis. Une directive par ligne vaut mieux qu’un paragraphe, et la limite est de 1 000 caractères. Les espaces en début et en fin sont supprimés.

Ce qu’il ne faut pas rédiger

Ce que les assistants voient déjà. Les types de colonnes, les clés et le nombre de lignes sont renvoyés avec la table. Les répéter consomme vos 1 000 caractères.
Ce que signifie une colonne. Placez-le dans un mémo de colonne afin qu’il reste attaché à la colonne, partout où la table est utilisée. Les Consignes pour l’invite servent à indiquer comment utiliser le chemin dans son ensemble.
Tout ce qui est confidentiel. Les Consignes pour l’invite sont visibles dans tout l’espace de travail, et pas seulement par les personnes ayant accès au projet de la table. N’y mettez ni mots de passe ni clés, ni données personnelles, ni chiffres et commentaires que vous ne montreriez pas à chaque membre de l’espace de travail.

Bonnes et mauvaises Consignes pour l’invite

Les deux exemples ci-dessous concernent le même chemin, avec la même question : « Quel a été l’EBITDA du Midwest l’an dernier ? »

	Consignes faibles	Bonnes consignes
Texte	« Données opérationnelles. »	« Résultats opérationnels mensuels par unité commerciale. EBITDA = `ebitda_adj` ; ignorer `ebitda`. Exclure `scenario = 'Budget'` et les lignes intersociétés (`entity_type = 'IC'`). L’exercice fiscal commence en juillet. Midwest = IL, IN, OH, MI. »
Ce que fait l’assistant	Choisit la colonne `ebitda` simple, inclut les lignes de budget et intersociétés, et interprète « l’an dernier » comme l’année civile.	Utilise `ebitda_adj`, exclut les lignes de budget et intersociétés, retient le dernier exercice fiscal clos et filtre sur les quatre États du Midwest.
La réponse	Un chiffre plausible, faux et différent de celui de l’équipe financière.	Le chiffre que communique l’équipe financière.

Les consignes faibles ne sont pas fausses. Elles laissent simplement chaque décision aux suppositions de l’assistant.

Ajouter des mémos de colonne

Les Consignes pour l’invite couvrent le chemin dans son ensemble. Un mémo de colonne explique une colonne, et c’est ainsi que les assistants apprennent ce qu’une colonne contient réellement. Lorsque l’objet d’une colonne n’est pas clair d’après son nom, un mémo fait la différence entre la bonne colonne et une mauvaise colonne plausible.

Les mémos de la table du chemin sont renvoyés aux assistants IA avec la liste des colonnes, dans table_describe avec include=['columns'], sous la forme memo sur chaque colonne qui en possède un. Les colonnes sans mémo sont renvoyées comme avant. Les mêmes mémos parviennent à l’assistance IA d’une étape LLM de workflow pour les tables qu’elle utilise.

Quand un mémo est nécessaire

Ajoutez un mémo pour	Exemple de mémo
Les codes et abréviations	`seg_cd` : « Code de segment client : E = Grande entreprise, M = Moyenne entreprise, S = PME. »
Les mesures qui se ressemblent	`ebitda_adj` : « EBITDA après retrait des éléments exceptionnels. À utiliser pour le reporting ; `ebitda` n’est pas ajusté. »
Les indicateurs	`is_ic` : « 1 si la ligne est une transaction intersociétés. À exclure des totaux consolidés. »
Les unités ou la devise	`amt_local` : « Montant dans la devise locale de l’entité, en milliers. »
Les valeurs dérivées ou allouées	`alloc_cost` : « Coût partagé alloué à cette unité selon les effectifs. Non encouru directement. »

Ignorez les colonnes dont le nom dit tout, comme invoice_date ou customer_name. Un mémo qui répète le nom n’apporte rien.

Comment ajouter un mémo

Ouvrez la table du chemin dans l’Explorateur de tables.
Dans la barre d’outils, activez Propriétés de la colonne.
Sélectionnez la colonne dans la liste des colonnes.
Saisissez le texte dans Mémo.

Un mémo défini sur la table s’applique partout où la table est utilisée, y compris dans tous les chemins d’analyse qui pointent vers elle.

Consignes pour l’invite ou mémo

Placez chaque information à un seul endroit.

	Consignes pour l’invite	Mémo de colonne
Couvre	Comment utiliser le chemin dans son ensemble	Ce que signifie une colonne
Contenu typique	Questions traitées, filtres permanents, calendrier fiscal, termes métier	Codes, unités, indicateurs, quelle mesure similaire utiliser
Exemple	« Exclure les lignes intersociétés des totaux. »	`is_ic` : « 1 si la ligne est intersociétés. »

Ici, le mémo indique ce que signifie is_ic, et les Consignes pour l’invite indiquent ce qu’il faut en faire.

Les utiliser

Une fois vos chemins enregistrés, posez simplement vos questions :

Par nom : « Montre-moi les premières lignes des résultats opérationnels. »
Par la valeur par défaut : « Qu’est-ce qui a changé par rapport au trimestre dernier ? » (aucune table nommée : le chemin d’analyse par défaut de l’espace de travail est utilisé).
Changez librement : « Fais maintenant la même chose pour la Prévision. » L’assistant suit, d’un chemin à l’autre.

Cela s’associe naturellement aux questions d’allocation (voir Tracer les allocations), pour passer de « pourquoi les résultats opérationnels ont-ils varié ? » directement aux comptes et aux inducteurs qui les expliquent.

Les utiliser via MCP

Lorsqu’un assistant connecté par MCP transmet un chemin d’analyse à un outil, il peut utiliser soit le nom du chemin (sans distinction de casse), soit son id. Un chemin mis à jour avec un id inexistant est refusé ; pour créer un nouveau chemin, omettez l’id.

query_data_read accepte analysis_path à la place d’un projet et d’une table pour table, json_paths, dimension_value, column_values et aggregate.

Aperçu de certaines colonnes seulement. Transmettez columns=[...] à query_data_read(action='table') pour ne renvoyer que les colonnes nommées. Les règles d’accès aux lignes s’appliquent toujours intégralement. Il ne peut pas être combiné avec version_id.

Obtenir un total filtré en un seul appel. Demandez à column_values la mesure et filtrez sur la colonne qui vous intéresse :

query_data_read(
  action='column_values',
  project_id=<project>,
  table_id=<table>,
  dimension_column_name=<filter column>,
  value_column_name=<measure>,
  filters={<filter column>: <value>}
)

Il renvoie une ligne pour cette valeur. Lorsqu’un nom de colonne est mal orthographié, l’erreur liste jusqu’à cinq correspondances proches afin que l’assistant puisse corriger et réessayer.

Totaliser ou ventiler en un seul appel. Utilisez action='aggregate' pour regrouper par une ou plusieurs colonnes et totaliser, moyenner ou compter des mesures sur le serveur, au lieu de lire des lignes :

query_data_read(
  action='aggregate',
  project_id=<project>,
  table_id=<table>,
  group_by=['Product'],
  measures=[{'column': 'Revenue', 'agg': 'sum'}, {'column': 'Volume'}],
  filters={'Fiscal Year': 2027},
  order_by='Revenue',
  limit=10
)

measures accepte agg parmi sum (valeur par défaut), avg, min, max ou count ; count accepte aussi '*'. Une valeur de filters peut être une liste pour correspondre à l’une de plusieurs valeurs. limit vaut 50 par défaut et 500 au maximum. order_by nomme une mesure ou une colonne de regroupement ; les mesures sont triées de la plus élevée à la plus basse. La réponse contient rows, total_groups et truncated, qui vaut true lorsqu’il existe plus de groupes que ceux renvoyés par limit. Les règles d’accès aux lignes s’appliquent avant le calcul des totaux.

Qui peut les configurer

La configuration des chemins d’analyse (leur enregistrement et le choix de la valeur par défaut) est une action d’administrateur, afin que les noms partagés restent propres et dignes de confiance pour tous. Une fois qu’ils existent, chaque membre de l’espace de travail peut les utiliser dans ses questions, tout en ne voyant que les données que ses propres autorisations lui permettent.

Voir aussi

Définitions de métriques : convenez une fois pour toutes de la façon dont un chiffre métier est calculé
Des réponses fiables : comment PlaidCloud note chaque réponse de l’IA et l’assortit de réserves
Tracer les allocations : expliquer pourquoi un résultat nommé a changé
Récupération, ancrage et chemins d’analyse : la place des chemins d’analyse dans l’architecture de récupération globale
Prise en main des agents de codage IA : connecter un assistant par MCP
Microsoft 365 Copilot : utiliser les chemins d’analyse depuis Teams et Outlook