AI Notes
Last updated
Last updated
Notes are natural language instructions for the AI agent.
To create a note, click 'Add Note' and then type or paste in your note. Good notes are:
concise - to conserve tokens
specific - referencing exact names within the data such as a column name or value within a column
human understandable - a good sanity check for your note is, "Could an intern that hasn't worked with this data before understand this note?"
Notes can (and often should) be linked to multiple datasets. This allows you to centralize logic for explaining something that applies to multiple datasets in your account.
Notes are classified by AI into 3 categories:
Data Lineage - where the data comes from
Business Context - explanations of nuances related to your business
Semantic Layer - specific column and table relationships such as KPI definitions and join keys
As part of the AI Readiness evaluation, we check for coverage across each of these categories for each AI-visible dataset.
Here are some example scenarios where you may want to create a note:
Does your organization have a pressing need to abbreviate everything? You're not alone, but this can be confusing for AI. Use Notes to teach AI your acronyms, i.e.:
CACP means Customer Acquisition Cost Payback and is calculated as Sales & Marketing Expenses in Period / (Net New MRR Acquired in Period * Gross Margin)
Do you have tables that look very similar for different business units? You can teach AI which table to use in which scenario with a note, i.e.:
The table prefix "ABC" refers to our alcohol business unit, and "DEF" refers to our diesel fuel business unit
