Skip to main content
Version: 0.0.41

Descriptions

The Descriptions tab contains the metadata generated for the data sources connected to this Custom Model. Descriptions provide context about tables, columns, and data types, helping the model deliver accurate responses to user queries.

How Descriptions Are Generated​

Descriptions are generated automatically during Create Semantic Model or Update Semantic Model operations. The system analyzes the data source structure and creates descriptive metadata for each element.

Managing Descriptions​

System-generated descriptions are sufficient for most use cases. Manual management is an advanced option.

Adding Descriptions​

You can add additional descriptions for tables or columns that the system did not describe, or where the generated description is insufficient.

Modifying Descriptions​

Existing descriptions can be modified or disabled. Only change a description if the system-generated version is incorrect or misleading for the model's use case.

Best Practices​

  • Trust system-generated descriptions as the default — they are optimized for the model's analytical functions.
  • Only modify descriptions if you have a clear understanding of how the change will affect query accuracy.
  • After making manual changes, test the model's responses to verify that the adjustments improve, not degrade, the output quality.