Skip to content

The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:

Docs: AI exploration (#67859)

Abed Habli7a8b15e271be
diff --git a/docs/ai/images/ai-exploration.png b/docs/ai/images/ai-exploration.png
new file mode 100644
index 00000000000..739f9c818db
Binary files /dev/null and b/docs/ai/images/ai-exploration.png differ
diff --git a/docs/ai/images/ai-settings.png b/docs/ai/images/ai-settings.png
index 87b8d48b42e..bfb7cfc9d2e 100644
Binary files a/docs/ai/images/ai-settings.png and b/docs/ai/images/ai-settings.png differ
diff --git a/docs/ai/metabot.md b/docs/ai/metabot.md
index ab9bbecae91..2a0d8418445 100644
--- a/docs/ai/metabot.md
+++ b/docs/ai/metabot.md
@@ -19,6 +19,7 @@ To set up Metabot, see [Metabot settings](./settings.md).
Metabot can help you to:
+- [AI exploration](#ai-exploration).
- [Create a chart using the query builder](#how-metabot-uses-the-query-builder) from a natural language query.
- [Generate SQL in the native editor](../questions/native-editor/writing-sql.md) from natural language. (Currently, only SQL is supported.)
- [Edit SQL directly in the native editor](#inline-sql-editing).
@@ -101,16 +102,29 @@ When you get an error in a SQL query, you can click the **Have Metabot fix it**
You can ask Metabot to generate or edit code in the SQL editor, without using the [chat sidebar](#the-metabot-chat-sidebar):
1. Open the [SQL editor](../questions/native-editor/writing-sql.md).
-2. Press Cmd+; on Mac or Ctrl+; on Windows.
+2. Press Cmd+shift+i on Mac or Ctrl+shift+i on Windows.
3. Describe the SQL you want to generate or modify.
4. Review the generated code and accept or reject it.
+Once you start typing or editing your SQL, you can continue using the keyboard shortcut to refine your code.
+
## Navigating after Metabot creates a chart
If Metabot creates a query or takes you to a new item but you want to return to the previous screen, you can navigate using your browser's back button.
You can also save any chart that Metabot creates to a dashboard or collection.
+## AI exploration
+
+![AI exploration](./images/ai-exploration.png)
+
+Use **AI exploration** to start a new conversation with Metabot when you don’t already have a chart, question, or query to work from.
+
+Open it from **+ New → AI exploration**, then ask a question or pick one of the suggested prompts.
+
+When answering questions in AI exploration, Metabot searches a limited set of content instead of your entire Metabase. Admins can set a **Collection for natural language querying** to scope AI exploration to a specific collection and its subcollections. You can still refer to content outside that scope by explicitly @-mentioning it in your prompt. See [Metabot AI settings](../ai/settings.md) for more details.
+
+
## Giving feedback on Metabot responses
When you hover over Metabot's responses, you'll see options to give feedback.
diff --git a/docs/ai/settings.md b/docs/ai/settings.md
index bddfcef5628..cc3abb4cecc 100644
--- a/docs/ai/settings.md
+++ b/docs/ai/settings.md
@@ -36,6 +36,14 @@ Admins on Pro and Enterprise plans can tell Metabot to only work with [models](.
Restricting Metabot to verified models and metrics (and only models and metrics) helps Metabot produce more reliable answers, since you know someone has at least vetted the data Metabot can use.
+## Collection for natural language querying
+
+Select a collection (including its subcollections) to limit which collections Metabot searches during [AI exploration](../ai/metabot.md#ai-exploration).
+
+This setting only affects conversations started from **+ New → AI exploration**.
+
+People can still @-mention items outside of this collection when prompting in AI exploration. Metabot can also see the person's current context (for example, Metabot will know about the dashboard they're currently viewing, even if the dashboard is outside the selected collection).
+
## When embedding Metabot, you can pick a collection for Metabot to have access to
When embedding Metabot in your app, you can select a collection for Metabot: