# Настройка BYOK для dbt Wizard на платформе dbt

Платформа dbt | Starter, Enterprise, Enterprise+

Используйте собственный ключ (bring-your-own-key, BYOK), чтобы подключить dbt Wizard или dbt Copilot на dbt platform к своей учётной записи у поставщика ИИ вместо использования инфраструктуры под управлением dbt Labs.

Приведённые ниже инструкции по настройке BYOK применимы только к dbt platform. О настройке BYOK для CLI см. в разделе [Настройка BYOK для dbt Wizard](https://docs.getdbt.tech/docs/dbt-ai/wizard-byok.md).

При настройке поставщика с собственным ключом расходы на использование отражаются в вашей учётной записи у поставщика, а не в учётной записи dbt Labs, и оплату за токены взимает выбранный вами поставщик.

Если вы предпочитаете обойтись без самостоятельного обслуживания, [вариант под управлением dbt Labs (управляемое подключение)](https://docs.getdbt.tech/docs/platform/manage-dbt-ai.md#configure-ai-provider) готов к использованию без настройки и включает [пробные и ежемесячные кредиты на использование](https://docs.getdbt.tech/docs/dbt-ai/pricing-billing/trial-and-billing.md).

## Предварительные требования

* [Учётная запись dbt platform](https://www.getdbt.com/pricing) на тарифном плане Starter, Enterprise или Enterprise+
* Права администратора dbt для включения функций ИИ и настройки поставщиков в **Account settings**
* API-ключ или учётные данные для поддерживаемого поставщика ИИ

 Посмотреть полный список поддерживаемых поставщиков ИИ

dbt Wizard поддерживает [модели управляемое подключение](https://docs.getdbt.tech/docs/dbt-ai/pricing-billing/overview.md#dbt-managed-providers) (оплата через dbt Labs, управлять ключом не требуется) и [модели с собственным ключом (BYOK)](https://docs.getdbt.tech/docs/dbt-ai/wizard-byok.md) (оплата напрямую провайдеру).

Ниже перечислены поддерживаемые провайдеры ИИ в зависимости от того, где вы работаете. Полный список доступных моделей см. в [таблице тарифов провайдеров моделей](https://www.getdbt.com/legal/dbt-wizard-token-costs-by-model).

### dbt platform

| Провайдер                                                                    | Доступ                               |
| ---------------------------------------------------------------------------- | ------------------------------------ |
| [OpenAI](https://openai.com/policies/row-terms-of-use/) (по умолчанию)       | dbt управляемое подключение или BYOK |
| [Anthropic](https://www.anthropic.com/legal/consumer-terms)†                 | dbt управляемое подключение или BYOK |
| Модели с открытыми весами (например, DeepSeek, Kimi и другие).               | dbt управляемое подключение          |
| [Azure AI Foundry](https://www.microsoft.com/licensing/terms) / Azure OpenAI | BYOK                                 |

### Локально (CLI)

| Провайдер                                                                    | Доступ                               |
| ---------------------------------------------------------------------------- | ------------------------------------ |
| [OpenAI](https://openai.com/policies/row-terms-of-use/)                      | dbt управляемое подключение или BYOK |
| [Anthropic](https://www.anthropic.com/legal/consumer-terms)†                 | dbt управляемое подключение или BYOK |
| Модели с открытыми весами (например, DeepSeek, Kimi и другие).               | dbt управляемое подключение          |
| [Azure AI Foundry](https://www.microsoft.com/licensing/terms) / Azure OpenAI | BYOK                                 |
| [AWS Bedrock](https://aws.amazon.com/service-terms/)                         | BYOK                                 |
| [Google Gemini](https://ai.google.dev/gemini-api/terms)                      | BYOK                                 |
| [Snowflake Cortex](https://www.snowflake.com/en/legal/terms-of-service/)     | BYOK                                 |
| [Databricks Unity AI Gateway](https://www.databricks.com/legal/mcsa)         | BYOK                                 |

Вы также можете подключить личную подписку OpenAI ChatGPT вместо ключа.

†Корпоративные лицензии и лицензии по подписке Anthropic (например, Claude Enterprise) не поддерживаются согласно [условиям использования](https://www.anthropic.com/legal/consumer-terms) Anthropic.

#### dbt Copilot

dbt Copilot поддерживает различных поставщиков ИИ, в том числе использование собственного ключа (BYOK) на тарифных планах Starter, Enterprise и Enterprise+:

* API-ключ OpenAI под управлением dbt Labs (управляемое подключение)
* Собственный API-ключ OpenAI (BYOK)
* Собственный API-ключ Azure OpenAI (BYOK)

Snowflake Cortex, AWS Bedrock, Azure AI Foundry и Anthropic не поддерживаются в dbt Copilot.

## Настройка поставщика ИИ

Аккаунт dbt platform на любом тарифном плане может использовать провайдера dbt с управлением со стороны dbt Labs, чтобы сразу приступить к работе. Аккаунты на тарифных планах Starter, Enterprise и Enterprise+ также могут настроить собственного ИИ-провайдера с использованием своего ключа (BYOK). При использовании BYOK вызовы API и связанные с ними расходы оплачиваются вами в соответствии с тарифами этого провайдера.

Следующие инструкции описывают настройку ИИ-провайдера под управлением dbt Labs или с использованием BYOK для dbt Wizard. ИИ-провайдеры под управлением dbt администрируются dbt Labs и не требуют предоставления пользователем ключа API. Список ИИ-провайдеров в разделе **Account settings** может меняться по мере добавления dbt Labs управляемых моделей. Актуальный список моделей и провайдеров приведён в [таблице тарифов провайдеров моделей](https://www.getdbt.com/legal/dbt-wizard-token-costs-by-model).

**Чтобы настроить провайдера:**

1. Нажмите на название своего аккаунта и выберите **Account settings** в боковом меню.
2. В разделе **Settings** нажмите **AI features**.
3. В разделе **AI providers** нажмите **Edit**, чтобы настроить интеграцию с ИИ.
4. Для каждого провайдера выберите вариант **Key management** в раскрывающемся списке, затем выполните приведённые ниже действия для выбранного провайдера.

### Anthropic

**Под управлением dbt Labs**

Используйте этот вариант как управляемую альтернативу модели OpenAI, используемой по умолчанию.

1. Если вариант **dbt Labs** ещё не выбран, выберите его в списке, чтобы использовать ключ Anthropic под управлением dbt Labs.
2. Нажмите **Save**.

**Под вашим управлением (BYOK)**

1. Выберите **Anthropic** из доступных вариантов.
2. Введите свой ключ API Anthropic.
3. Нажмите **Save**.

Ограничения для эмбеддингов

При использовании ключа API Anthropic dbt продолжает использовать ключ OpenAI под управлением dbt Labs для создания эмбеддингов в инструментах MCP `text_to_sql`, поскольку Anthropic не предоставляет собственных средств создания эмбеддингов.

### OpenAI

**Под управлением dbt Labs**

Этот вариант выбран по умолчанию. Используйте его, если хотите работать с ключами ИИ-провайдеров под управлением dbt. Подробнее см. в разделе [Модели и цены](https://docs.getdbt.tech/docs/dbt-ai/pricing-billing/overview.md?version=2.0).

1. Если переключатель **dbt Labs** ещё не включён, включите его, чтобы использовать ключ под управлением dbt Labs.
2. Нажмите **Save**.

[![Пример страницы интеграции с dbt Labs](/img/docs/dbt-platform/account-integration-dbtlabs.png?v=2 "Пример страницы интеграции с dbt Labs")](#)Пример страницы интеграции с dbt Labs

**Под вашим управлением (BYOK)**

1. Выберите **OpenAI** из доступных вариантов.
2. Введите свой ключ API OpenAI.
3. Нажмите **Save**.

[![Пример страницы интеграции с OpenAI](/img/docs/dbt-platform/account-integration-openai.png?v=2 "Пример страницы интеграции с OpenAI")](#)Пример страницы интеграции с OpenAI

Ограничение, связанное с размещением данных

Проекты OpenAI с включёнными [настройками резидентности данных](https://platform.openai.com/docs/guides/your-data#data-residency-controls), настроенные для США (регион проекта — US), в настоящее время не поддерживают BYOK. В этих проектах можно использовать только ключ API, указанный в конфигурации платформы dbt. Указание пользовательских конечных точек, необходимых для обеспечения резидентности данных, пока не поддерживается, и мы рассматриваем возможное решение этой проблемы.

Чтобы использовать BYOK, убедитесь, что в вашем проекте OpenAI не включены настройки резидентности данных. Проекты без заданного региона используют стандартную конечную точку OpenAI (`https://api.openai.com`) и поддерживают BYOK.

* Для BYOK включите новейшие модели генерации текста, а также модель `text-embedding-3-small`.
* Убедитесь, что в вашем проекте не включены ограничения на размещение данных. Проекты без настроек региона используют стандартную конечную точку OpenAI (`https://api.openai.com`) и поддерживают BYOK.

### Azure AI Foundry

**Только под вашим управлением (BYOK)**

Подробнее о развёртывании моделей в Azure см. в документации [Развёртывание моделей в Azure OpenAI](https://learn.microsoft.com/en-us/azure/ai-studio/how-to/deploy-models-openai) и [Azure AI Foundry](https://learn.microsoft.com/en-us/azure/ai-foundry/).

Настройте учётные данные для своего развёртывания Azure AI Foundry в dbt следующим образом:

1. Найдите сведения о своём развёртывании на портале Azure — в Azure AI Foundry или Azure OpenAI.
2. Введите свой ключ API Azure.
3. Заполните поля **Endpoint**, **API Version** и **Deployment / AI model name**.
4. Нажмите **Save**.

Используйте полный целевой URI Azure

В поле **Endpoint** введите полный целевой URI (Target URI) из Azure — не только базовый адрес конечной точки. Если указать только базовый адрес конечной точки, например `https://<resource>.openai.azure.com`, проверка учётных данных не пройдёт и настройка будет заблокирована.

Поддерживаются следующие форматы:

* `https://<resource>.openai.azure.com/openai/deployments/<deployment>/chat/completions?api-version=<version>`
* `https://<resource>.openai.azure.com/openai/responses?api-version=<version>`

[![Пример раздела интеграции с Azure AI Foundry](/img/docs/dbt-platform/account-integration-azure-manual.png?v=2 "Пример раздела интеграции с Azure AI Foundry")](#)Пример раздела интеграции с Azure AI Foundry