Skip to content

Commit 7d0b0a2

Browse files
github-automation-metabaseMetabase Docs bot
andauthored
[auto] adding content to release-x.57.x->release-x.57.x (#776)
Co-authored-by: Metabase Docs bot <[email protected]>
1 parent 9dce8a0 commit 7d0b0a2

File tree

22 files changed

+360
-335
lines changed

22 files changed

+360
-335
lines changed

_docs/v0.57/ai/metabot.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,7 @@ Some tips:
5353
- Whenever you want Metabot to do something completely different, you should reset the conversation, as Metabot might find that irrelevant historical context to be confusing.
5454
- Once Metabot creates a question for you, you can follow up with more questions or take over yourself. You can drill through the chart or step into the editor to tweak the query (both in the query builder and the SQL editor).
5555
- Metabot works best with English prompts. While it might understand other languages, you'll get the most reliable results by asking your questions in English.
56+
- Define domain-specific terms in the [glossary](../exploration-and-organization/data-model-reference#glossary) to help Metabot understand your organization's terminology.
5657

5758
### Metabot response menu
5859

_docs/v0.57/ai/settings.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,7 @@ The best thing you can do to improve Metabot's performance is to prep your data
4848
- [Add models and metrics to your Metabot collection](#add-models-and-metrics-to-your-metabot-collection)
4949
- [Add descriptions for your data and content](#add-descriptions-for-your-data-and-content)
5050
- [Make sure the semantic types for each field are correct](#make-sure-the-semantic-types-for-each-field-are-correct)
51+
- [Define domain-specific terms in the glossary](#define-domain-specific-terms-in-the-glossary)
5152
- [Curate prompt suggestions](#curate-prompt-suggestions)
5253

5354
### Add models and metrics to your Metabot collection
@@ -76,6 +77,12 @@ Make sure the semantic types for each field accurately describe the field's "mea
7677

7778
Metabase will try to set semantic types automatically, but you should confirm that each field has the relevant semantic type. See [Data types and semantic types](../data-modeling/semantic-types). You can also set semantic types for [models](../data-modeling/models#add-metadata-to-columns-in-a-model).
7879

80+
### Define domain-specific terms in the glossary
81+
82+
Add your organization's terminology, acronyms, and business-specific terms to the [glossary](../exploration-and-organization/data-model-reference#glossary). When Metabot receives a prompt, it can look up terms in the glossary to better understand your request.
83+
84+
For example, if you define "MRR" as "Monthly Recurring Revenue" in your glossary, Metabot will know what you mean when you ask "What's our MRR for Q4?" This is especially helpful for industry-specific jargon, internal product names, or abbreviations unique to your organization.
85+
7986
### Curate prompt suggestions
8087

8188
When you select a collection for Metabot to "learn", Metabot will suggest a series of prompts based on the content it finds in that collection. These prompts just give people a feel for the kinds of things people can ask Metabot to do.

_docs/v0.57/data-modeling/models.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,12 @@ There are some limitations to this indexing:
126126

127127
You can edit a model's query by clicking on the down arrow next to the model's name and clicking on **Edit query definition**. When you're doing editing, be sure to save your changes. Unlike questions, which prompt you to save as a new question, any changes here will overwrite the existing model. If you want to create a new model from an existing model, select **Duplicate this model** from the model sidebar (the icon of two overlapping squares).
128128

129+
### Checking for breaking changes
130+
131+
> {% include plans-blockquote.html feature="Checking for breaking changes" %}
132+
133+
When you save changes to a model, Metabase will try to detect whether your changes would break any other entities that depend on that model. For example, if you remove a column from the model, but other questions based on that model rely on that column, Metabase will warn you that those downstream questions will break.
134+
129135
## Model list view
130136

131137
![Viewing a model as a list](./images/model-list.png)

_docs/v0.57/exploration-and-organization/data-model-reference.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -56,9 +56,9 @@ Admins can edit the metadata in this reference by clicking the **Edit** button i
5656

5757
## Glossary
5858

59-
The glossary is a place where anyone can define terms relevant to your data. Currently, the glossary is a simple key-value store of terms and their definitions.
59+
The glossary is a place where anyone can define terms relevant to your data. To add a new term, click **+ New term**. Add the term name and its definitions, then click the checkmark to save the term to the glossary.
6060

61-
To add a new term, click **+ New term**. Add the term name and its definitions, then click the checkmark to save the term to the glossary.
61+
The glossary is particularly useful for [Metabot](../ai/metabot). When Metabot gets a prompt, it can look up glossary terms to understand your request. For example, if you define "MRR" as "Monthly Recurring Revenue" in your glossary, Metabot will know what you mean when you ask "What's our MRR for Q4?"
6262

6363
## Segments
6464

148 KB
Loading
153 KB
Loading
148 KB
Loading
189 KB
Loading

0 commit comments

Comments
 (0)