Skip to content

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

docs - embedded Metabot (#70275)

Jeff Bruemmere586b7851359
diff --git a/docs/ai/settings.md b/docs/ai/settings.md
index 380a94c580c..d96b3a492c8 100644
--- a/docs/ai/settings.md
+++ b/docs/ai/settings.md
@@ -30,13 +30,36 @@ For now, Metabot is only available for Metabase Cloud. Before you can set up Met
Once you've added Metabot AI in the Metabase store, you can log into your Metabase and configure it in _Admin > AI_.
+## Metabot options
+
+You can set options for Metabot, both for your internal Metabase, and (separately) for embedded Metabase contexts. That way you can, say, use Metabot in your Metabase, while not giving access to Metabot in your embedded Metabase.
+
+- [Enable Metabot](#enable-metabot)
+- [Verified content](#verified-content)
+- [Collection Metabot can use](#collection-metabot-can-use)
+
+## Enable Metabot
+
+Toggle [Metabot](./metabot.md) on or off for your Metabase or embedded contexts. Both Metabot and Embedded Metabot are enabled by default.
+
+### Internal Metabot
+
+When enabled, Metabot is available to help people create questions, analyze data, and answer questions about your data. When disabled, the Metabot icon and keyboard shortcuts are hidden.
+
+### Embedded Metabot
+
+The toggle will turn embedded Metabot on or off. The toggle affects both full-app embeds and modular embeds.
+
+- [Full-app embedding](../embedding/full-app-embedding.md): The Metabot icon and keyboard shortcuts are only available when Metabot is enabled. Turning off Embedded Metabot will hide these icons and disable the keyboard shortcuts.
+- [Modular embedding](../embedding/modular-embedding.md) The toggle doesn't add Metabot anywhere; you have to explicitly include a chat component (like the SDK's [`MetabotQuestion`](../embedding/sdk/ai-chat.md)) in your application. If, however, you've added a component, and you turn off the Embedded Metabot toggle, your chat component will stop working, so you should also remove or hide the component in your application.
+
## Verified content
Admins on Pro and Enterprise plans can tell Metabot to only work with [models](../data-modeling/models.md) and [metrics](../data-modeling/metrics.md) that have been [verified](../exploration-and-organization/content-verification.md).
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
+## Collection Metabot can use
Select a collection (including its subcollections) to limit which collections Metabot searches during [AI exploration](../ai/metabot.md#ai-exploration).
@@ -44,18 +67,6 @@ 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:
-
-2. Click **Embedded Metabot**.
-3. In the **Collection Embedded Metabot can use** section, click **Pick a collection**.
-4. Select the collection that contains the models and metrics you want Metabot to use.
-
-Metabot will use the models and metrics in that collection to help answer questions and generate queries. You can change this collection at any time. To give Metabot access to all collections, you can set the collection to the root collection, called "Our Analytics" (the default).
-
-Alternatively (or additionally), you can restrict Metabot to [verified content](#verified-content).
-
## Tips for making the most of Metabot
The best thing you can do to improve Metabot's performance is to prep your data like you would for onboarding a new (human) hire to your data. In practice, this means you should:
diff --git a/docs/embedding/full-app-embedding.md b/docs/embedding/full-app-embedding.md
index 7fe4be91bc0..924e8e44c10 100644
--- a/docs/embedding/full-app-embedding.md
+++ b/docs/embedding/full-app-embedding.md
@@ -234,6 +234,10 @@ Additionally, each person within a single customer account could also be a membe
See [full app UI components](./full-app-ui-components.md). For more granular control over embedded components, consider using [Modular embedding](./modular-embedding.md) instead.
+## Metabot in full-app embeds
+
+See [Embedded Metabot settings](../ai/settings.md#enable-metabot).
+
## Reference apps
To build a sample full app embed using SSO with JWT, see our reference apps: