Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.activeviam.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Atoti Intelligence Essentials

This is part of the Atoti Intelligence Essentials offer.
This guide explains how to provide additional context about cubes to improve Visualize This responses.

​
Configuration file

Add Visualize This configuration to the application configuration file. Configuration is optional but recommended for better results. Add the following to application.yaml: 
atoti:
  ai:
    context:
      cubes:
        - name: "cubeName1"
          description: "Description of the cube 1"
          dimensions:
            - name: "dimensionName1"
              description: "description dimension1"
              hierarchies:
                - name: "hierarchyName1"
                  description: "description hierarchy1"
                  levels:
                    - name: "levelName1"
                      description: "description level1"
            - name: "dimensionName2"
              description: "description dimension2"
              hierarchies:
                - name: "hierarchyName2"
                  description: "description hierarchy2"
          measures:
            - name: "measure1"
              description: "description measure1"
            - name: "measure2"
              description: "description measure2"
          measure-folders:
            - name: "folderName1"
              description: "description folder1"
            - name: "folderName2"
              description: "description folder2"
        - name: "cubeName2"
          description: "Description of the cube 2"
          dimensions:
            - name: "dimensionName3"
              hierarchies:
                - name: "hierarchyName3"
                  levels:
                    - name: "levelName3"
                      description: "description level3"
                - name: "hierarchyName4"
                  description: "description hierarchy4"
                  levels:
                    - name: "levelName4"
                      description: "description level4"
            - name: "dimensionName5"
              description: "description dimension4"
          measures:
            - name: "measure3"
              description: "description measure3"
            - name: "measure4"
              description: "description measure4"
          measure-folders:
            - name: "folderName3"
              description: "description folder3"
            - name: "folderName4"
              description: "description folder4"
      system-prompt-paths:
          - "prompts/prompt1.md"
          - "prompts/prompt2.md"

​
Configuration parameters

The following table describes each configuration parameter:
Parameter nameDescription
system-prompt-pathsOrdered list of paths to system prompt files. Files are concatenated in the declared order and appended to the LLM context.
nameName of the cube to configure Visualize This for.
descriptionDescription of the cube.
dimensionsList of dimensions to provide additional information to the LLM.
  nameName of the dimension.
  descriptionDescription of the dimension.
  hierarchiesList of hierarchies to provide additional information to the LLM.
    nameName of the hierarchy.
    descriptionDescription of the hierarchy.
    levelsList of levels to provide additional information to the LLM.
      nameName of the level.
      descriptionDescription of the level.
measuresList of measures to provide additional information to the LLM.
  nameName of the measure.
  descriptionDescription of the measure.
measure-foldersList of measure folders to provide additional information to the LLM.
  nameName of the measure folder.
  descriptionDescription of the measure folder.

​
Alternative: XMLA_DESCRIPTION property

Descriptions for dimensions, hierarchies, and levels can also be sourced from the XMLA_DESCRIPTION property set directly on the OLAP element schema definition. When this property is present on an element, Visualize This reads it as the element’s description. This is useful when descriptions are already defined in the cube schema, and you want to avoid duplicating them in the application configuration file. If both XMLA_DESCRIPTION and the application configuration file provide a description for the same element, the two values are concatenated.
The XMLA_DESCRIPTION property applies to dimensions, hierarchies, levels, and measures only. Cubes and measure folders must be described through the application configuration file.

​
Partial configuration

Configuration does not require descriptions for all elements. Provide descriptions only for elements that need additional context.

​
Verify the configuration

After completing the configuration, verify that Visualize This uses the custom descriptions:
  1. Start the Atoti application
  2. Open the Atoti UI
  3. Ask the AI assistant to create a visualization
  4. Check that the assistant understands business terms from the descriptions
After configuring Visualize This, learn how to use it: How to use Visualize This To define an AI disclaimer, see AI disclaimer