Table of Contents

AI Model Documentation

AI Model Documentation generates human-readable descriptions for the tables, columns, and measures in your model. It reads your schema (names, data types, relationships, DAX expressions) and writes descriptions that explain what each object represents.

Generating Descriptions

For the Entire Model

  1. Click Document Entire Model from the toolbar or model context menu.
  2. The AI processes everything in the model and populates the Description field on each object.

For Individual Objects

  1. Right-click a table, column, or measure in the Explorer.
  2. Select Generate AI Description.

Generate vs. Regenerate

  • Generate only fills in empty descriptions. If a table or column already has a description, it's left alone.
  • Regenerate overwrites existing descriptions. You'll see a confirmation prompt first, so you won't accidentally lose descriptions you've written yourself.

This distinction is important because you can safely run bulk generation without losing work you've already done.

Pairing with the Data Dictionary

AI-generated descriptions are a great starting point, but they're not always perfect. For the best results, combine AI documentation with the Data Dictionary:

  1. Generate: Let the AI create a first draft of descriptions for the whole model.
  2. Export: Export the Data Dictionary to a spreadsheet.
  3. Review: Share with your team. Business analysts can refine descriptions, add domain context, and fix anything the AI got wrong.
  4. Import: Bring the revised spreadsheet back in to apply all changes at once.

This gives you the speed of AI with the accuracy of human review.

What the AI Sees

The AI receives only schema metadata:

  • Table names and types
  • Column names, data types, and format strings
  • Measure names and DAX expressions
  • Relationship definitions

No raw data from your tables is sent.

AI Provider

Model Documentation uses whichever AI provider you've configured:

  • BYOK: Your own API key. Included with every license.
  • AI Add-on: Hosted AI through Fact Foundry's proxy. Available with the AI Add-on license tier.

Configure your provider in Settings > AI.

Edit this page