> ## 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.

# How to configure Visualize This

> How to supply cube context to Visualize This via `application.yaml`, covering `system-prompt-paths`, cube and dimension descriptions, hierarchy levels, the `XMLA_DESCRIPTION` OLAP schema property as an alternative, and partial configuration for selective elements.

<Info>
  ### Atoti Intelligence Essentials

  This is part of the Atoti Intelligence Essentials offer.
</Info>

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`:

```yaml theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
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 name      | Description                                                                                                                 |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| system-prompt-paths | Ordered list of paths to system prompt files. Files are concatenated in the declared order and appended to the LLM context. |
| name                | Name of the cube to configure Visualize This for.                                                                           |
| description         | Description of the cube.                                                                                                    |
| dimensions          | List of dimensions to provide additional information to the LLM.                                                            |
|   name              | Name of the dimension.                                                                                                      |
|   description       | Description of the dimension.                                                                                               |
|   hierarchies       | List of hierarchies to provide additional information to the LLM.                                                           |
|     name            | Name of the hierarchy.                                                                                                      |
|     description     | Description of the hierarchy.                                                                                               |
|     levels          | List of levels to provide additional information to the LLM.                                                                |
|       name          | Name of the level.                                                                                                          |
|       description   | Description of the level.                                                                                                   |
| measures            | List of measures to provide additional information to the LLM.                                                              |
|   name              | Name of the measure.                                                                                                        |
|   description       | Description of the measure.                                                                                                 |
| measure-folders     | List of measure folders to provide additional information to the LLM.                                                       |
|   name              | Name of the measure folder.                                                                                                 |
|   description       | Description 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.

<Note>
  The `XMLA_DESCRIPTION` property applies to dimensions, hierarchies, levels, and measures only.
  Cubes and measure folders must be described through the application configuration file.
</Note>

## 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

## Related reading

After configuring Visualize This, learn how to use it:
[How to use Visualize This](../../../../user-guide/chat)

To define an AI disclaimer, see [AI disclaimer](../disclaimer)