-
Notifications
You must be signed in to change notification settings - Fork 967
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
add new integration page #6579
add new integration page #6579
Changes from 3 commits
24aba36
6315b54
c4ea959
f4fb140
7730032
b4b3d54
3871104
f26343d
78fd8a6
7e4296e
742995a
a4c0abe
ad0ae2d
29de9e9
b4870cd
4083236
24277ab
46f8e23
3e53bfa
1b06fc9
a740618
5ce2c63
a6e7f24
183118e
b539a5e
1d4b53a
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,102 @@ | ||
--- | ||
title: "Account integrations in dbt Cloud" | ||
sidebar_label: "Account integrations" | ||
description: "Learn how to configure account integrations for your dbt Cloud account." | ||
--- | ||
|
||
The following sections describe the different **Account integrations** available from your dbt Cloud account under the account **Settings** section. | ||
|
||
<Lightbox src="/img/docs/dbt-cloud/account-integrations.jpg" title="Example of Account integrations from the sidebar" /> | ||
|
||
## Git | ||
|
||
Connect your dbt Cloud account to your Git provider to enable dbt Cloud users to authenticate your personal accounts. dbt Cloud will perform Git actions on behalf of your authenticated self, against repositories to which you have access according to your Git provider permissions. | ||
|
||
To configure a Git account integration, click on the Git provider from the list and select the **Pencil** icon to the right of the provider. | ||
|
||
dbt Cloud [natively connects](/docs/cloud/git/git-configuration-in-dbt-cloud) to the following Git providers: | ||
|
||
- GitHub | ||
- GitLab | ||
- Azure DevOps <Lifecycle status="enterprise" /> | ||
|
||
You can connect your dbt Cloud account to additional Git providers by importing a git repository from any valid git URL. Refer to [Import a git repository](/docs/cloud/git/import-a-project-by-git-url) for more information. | ||
|
||
<Lightbox src="/img/docs/dbt-cloud/account-integration-git.jpg" width="85%" title="Example of the Git integration page" /> | ||
|
||
## OAuth | ||
Check warning on line 27 in website/docs/docs/cloud/account-integrations.md GitHub Actions / vale[vale] website/docs/docs/cloud/account-integrations.md#L27
Raw output
|
||
|
||
Connect your dbt Cloud account to an OAuth provider that are integrated with dbt Cloud. | ||
|
||
To configure an OAuth account integration: | ||
- Click on **Integrations** from the sidebar. | ||
- For Slack, click on **Link** to connect your Slack account. | ||
- For custom OAuth providers, under **Custom OAuth integrations**, click on **Add integration** and select the OAuth provider from the list. Fill in the required fields and click **Save**. | ||
|
||
<Lightbox src="/img/docs/dbt-cloud/account-integration-oauth.jpg" width="85%" title="Example of the OAuth integration page" /> | ||
|
||
## AI | ||
|
||
Once AI features have been [enabled](/docs/cloud/enable-dbt-copilot#enable-dbt-copilot), you can use dbt Labs' AI integration or bring-your-own provider to support AI-powered dbt Cloud features like [dbt Copilot](/docs/cloud/dbt-copilot) and [Ask dbt](/docs/cloud-integrations/snowflake-native-app). Note, if you bring-your-own provider, you will incur API calls and associated charges for features used in dbt Cloud. | ||
|
||
To configure the AI integration in your dbt Cloud account, a dbt Cloud admin can perform the following steps: | ||
1. Navigate to **Account settings** in the side menu. | ||
2. Under the **Settings** section, click on **Integrations**. | ||
3. Scroll to **AI**. | ||
4. Click on the **Pencil** icon to the right of **OpenAI** to configure the AI integration. | ||
|
||
<Lightbox src="/img/docs/dbt-cloud/account-integration-ai.jpg" width="85%" title="Example of the AI integration page" /> | ||
|
||
### dbt Labs OpenAI | ||
Check warning on line 50 in website/docs/docs/cloud/account-integrations.md GitHub Actions / vale[vale] website/docs/docs/cloud/account-integrations.md#L50
Raw output
|
||
|
||
1. Select the toggle for **dbt Labs** to use dbt Labs' managed OpenAI key. | ||
2. Click **Save**. | ||
|
||
### OpenAI key | ||
Check warning on line 55 in website/docs/docs/cloud/account-integrations.md GitHub Actions / vale[vale] website/docs/docs/cloud/account-integrations.md#L55
Raw output
|
||
1. Select the toggle for **OpenAI** to use your own OpenAI key. | ||
2. Enter the API key. | ||
3. Click **Save**. | ||
|
||
### Azure OpenAI <Lifecycle status="beta" /> | ||
Check warning on line 60 in website/docs/docs/cloud/account-integrations.md GitHub Actions / vale[vale] website/docs/docs/cloud/account-integrations.md#L60
Raw output
|
||
|
||
**Deploying your own OpenAI model on Azure** https://learn.microsoft.com/en-us/azure/ai-studio/how-to/deploy-models-openai | ||
|
||
:::info | ||
dbt Cloud's AI is optimized for OpenAIs gpt-4o. Using other models can negatively affect performance and accuracy. | ||
(We cannot guarantee things will be working as expected for any other model) | ||
::: | ||
|
||
You can configure credentials for your Azure OpenAI deployment in the following two ways: | ||
|
||
- <Expandable alt_header="From a Target URI"> | ||
|
||
**Locate your Azure OpenAI deployment URI** | ||
ref to Azure docs | ||
|
||
ADD SCREENSHOT | ||
|
||
1. Select **Azure OpenAI**. | ||
2. Select the tab **From Target URI**. | ||
3. Paste the URI into the **Target URI** field. | ||
4. Verify the **Endpoint**, **Model Name**, and **API Version** are correct. | ||
5. Enter your Azure OpenAI API key. | ||
6. Click **Save**. | ||
</Expandable> | ||
|
||
- <Expandable alt_header="Manually providing the credentials"> | ||
|
||
**Locate your Azure OpenAI configuration** | ||
ref to Azure docs | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. @reneruck-dbt can't seem to find the right doc for open ai config |
||
|
||
ADD SCREENSHOT | ||
|
||
1. Select **Azure OpenAI**. | ||
2. Select the tab **Manual Input**. | ||
3. Enter the **Endpoint**. | ||
4. Enter the **Model Name**. | ||
5. Enter the **API Version**. | ||
6. Enter your Azure OpenAI API key. | ||
7. Click **Save**. | ||
</Expandable> | ||
|
||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@reneruck-dbt can't seem to find the right doc for deployment uri