The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:
TypeScript analyticsbibusiness-intelligencebusinessintelligenceclojuredashboarddatadata-analysisdata-visualizationdatabasemetabasemysqlpostgrespostgresqlreportingslacksql-editorvisualization
AI settings docs: a provider connection takes credentials, not just an API key (#82026)
Andrei Simionescub75caae5f3a4
diff --git a/docs/ai/overview.md b/docs/ai/overview.mdindex f3f942e6edb..1a097ac347f 100644--- a/docs/ai/overview.md+++ b/docs/ai/overview.md@@ -24,7 +24,7 @@ Metabot is Metabase's built-in AI agent. Metabot can help you with most daily ta**Provider**: Choose from:- Metabase's own AI service (available as an add-on exclusively for Metabase Cloud)-- Third-party models via your own [provider API key](settings.md#bring-your-own-api-key)+- Third-party models via your own [provider credentials](settings.md#connect-to-an-ai-provider)**Plans**: available on all plans. You can only use Metabase's AI service on Metabase Cloud.diff --git a/docs/ai/settings.md b/docs/ai/settings.mdindex 80c4686c741..b02b40688fe 100644--- a/docs/ai/settings.md+++ b/docs/ai/settings.md@@ -27,8 +27,8 @@ _Admin > AI_You pick which AI providers Metabase can use:-- If you're **self-hosting Metabase** and want to use Metabot, you'll need to [bring your own AI API key](#bring-your-own-api-key).-- On **Metabase Cloud**, you can [bring your own AI API key](#bring-your-own-api-key), [use the Metabase AI service](#metabase-ai-service), or both.+- If you're **self-hosting Metabase** and want to use Metabot, you'll need to [connect to an AI provider](#connect-to-an-ai-provider) with your own credentials.+- On **Metabase Cloud**, you can [connect to an AI provider](#connect-to-an-ai-provider) with your own credentials, [use the Metabase AI service](#metabase-ai-service), or both.The providers you set up in AI settings power Metabase's built-in AI functionality, not the MCP server. With the MCP server, [your client provides the AI](mcp.md#with-the-mcp-server-your-client-provides-the-ai).@@ -49,16 +49,16 @@ To use the Metabase AI service for Metabot:To remove the service: click the **...** next to **Metabase AI service** in the provider list, then click **Remove**.-### Bring your own API key+### Connect to an AI provider-You can bring your own credentials for any [supported AI provider](./providers.md).+You can use your own credentials with any [supported AI provider](./providers.md). Most take an API key, but not all: Amazon Bedrock takes an AWS access key pair, and Google Gemini Enterprise a service account key file or an OAuth token.-To connect a provider with your own API key:+To connect a provider with your own credentials:1. Go to **Admin > AI**.2. Click **Add a provider**.3. Pick your provider.-4. Enter your **API key**. The **Where do I find this?** link opens your provider's key management page in a new tab.+4. Fill in its credentials. The **Where do I find this?** links open the provider's key management pages in a new tab.5. Click **Connect**.If you've already copied a key, one neat thing: just paste the key anywhere on the provider grid, and Metabase selects the matching provider and fills in the key for you. Check to make sure the provider matches.@@ -233,7 +233,7 @@ If you're using the Metabase AI service, you can see how many Metabot requests pIf you aren't logged into the [Metabase Store](../cloud/accounts-and-billing.md), you'll need to log in to the store before you can view the usage. Once logged in to the store, go back to your Metabase and view the license page.-If you're using your own API key, you can track usage and costs through your AI provider's dashboard.+If you're using your own provider credentials, you can track usage and costs through that provider's dashboard.On Metabase Pro/Enterprise, you also get access to detailed [AI usage auditing](usage-auditing.md) with detailed breakdown of AI usage by user, tool, feature etc.diff --git a/docs/embedding/ai-chat.md b/docs/embedding/ai-chat.mdindex a73a6286a2a..70164105926 100644--- a/docs/embedding/ai-chat.md+++ b/docs/embedding/ai-chat.md@@ -31,7 +31,7 @@ An admin sets up embedded Metabot in your Metabase:2. Select **Admin**.3. Click the **AI** tab.4. In the left sidebar, click **AI Settings**.-5. The first card on the page is your AI provider connection. If the card says **Connect to an AI provider**, [set one up](../ai/settings.md#enable-ai-features). If you're self-hosting, that means [bringing your own API key](../ai/settings.md#bring-your-own-api-key). If the card says **AI providers**, you're already connected.+5. The first card on the page is your AI provider connection. If the card says **Connect to an AI provider**, [set one up](../ai/settings.md#enable-ai-features). If you're self-hosting, that means [connecting one with your own credentials](../ai/settings.md#connect-to-an-ai-provider). If the card says **AI providers**, you're already connected.6. In the **Metabot settings** card, click the **Embedded** tab.7. Turn on **Enable Embedded Metabot**.8. Under **Collection Embedded Metabot can use**, click **Pick a different collection** and choose the collection that holds the metrics, models, and saved questions embedded Metabot should build on.