dbt Copilot
dbt Copilot помогает генерировать SQL, документацию, тесты и семантические модели в dbt platform.
dbt Wizard — рекомендуемый ИИ-агент для разработки данных с соблюдением правил управления в dbt. Он охватывает полный цикл разработки — исследование, создание, проверку и выпуск — с опорой на граф зависимостей, тесты, контракты и определения метрик вашего проекта dbt.
Дополнительную информацию см. в разделах Часто задаваемые вопросы об ИИ в dbt, Оплата и Условия использования dbt.
Ранняя версия dbt Copilot в Studio IDE доступна только ограниченному числу аккаунтов. dbt Wizard доступен для всех аккаунтов и рекомендуется для разработки с использованием ИИ в Studio IDE — он поддерживает все возможности быстрых действий dbt Copilot, а также многошаговые изменения со встроенной проверкой.
Лимиты действий по тарифным планам
Использование dbt Copilot измеряется в действиях — один выполненный запрос к ИИ считается одним действием. Каждый тарифный план включает ежемесячный лимит действий на одну лицензию:
| Тарифный план | Действий в месяц |
|---|---|
| Developer | ❌ |
| Starter | 100 |
| Enterprise | 5,000 |
| Enterprise+ | 10,000 |
Лимиты Enterprise и Enterprise+ не действуют, если вы используете собственный ключ (BYOK), поскольку оплату за такое использование взимает напрямую ваш поставщик ИИ. Для прежних тарифных планов уровня Enterprise, подключённых до 1 мая 2025 года, действует лимит в 1 000 действий.
В разделе Использование ИИ в dbt описано, что считается действием, что происходит при достижении лимита и как проверить объём использования.
Настройка поставщика ИИ для dbt Copilot
Для изменения настроек аккаунта и настройки поставщиков необходимы права администратора dbt. dbt Copilot настраивается отдельно от dbt Wizard — сведения о поставщиках для dbt Wizard см. в разделе Управление функциями ИИ.
dbt Copilot поддерживает меньше провайдеров, чем dbt Wizard, в том числе использование собственного ключа (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 Copilot предоставляет встроенную помощь в Studio IDE и Insights. Настройте его отдельно от dbt Wizard, если ваша команда использует эти встроенные функции ИИ.
Чтобы настроить провайдера:
- Нажмите на название своей учетной записи и выберите Account settings в боковом меню.
- В разделе Settings нажмите Copilot.
- В разделе AI providers нажмите Edit, чтобы настроить интеграцию с ИИ.
- Выберите вариант Key management в раскрывающемся списке, затем выполните приведенные ниже действия для своего провайдера.
- dbt Labs OpenAI
- OpenAI
- Azure OpenAI
- Выберите переключатель dbt Labs, чтобы использовать ключ OpenAI, управляемый dbt Labs.
- Нажмите Save.
- Выберите переключатель OpenAI, чтобы использовать собственный ключ OpenAI.
- Введите ключ API.
- Нажмите Save.
Проекты OpenAI с включёнными настройками резидентности данных, настроенные для США (регион проекта — US), в настоящее время не поддерживают BYOK. В этих проектах можно использовать только ключ API, указанный в конфигурации платформы dbt. Указание пользовательских конечных точек, необходимых для обеспечения резидентности данных, пока не поддерживается, и мы рассматриваем возможное решение этой проблемы.
Чтобы использовать BYOK, убедитесь, что в вашем проекте OpenAI не включены настройки резидентности данных. Проекты без заданного региона используют стандартную конечную точку OpenAI (https://api.openai.com) и поддерживают BYOK.
Подробнее о развертывании собственной модели OpenAI в Azure см. в разделе Развертывание моделей в Azure OpenAI.
Настройте учетные данные для своего развертывания Azure OpenAI в dbt следующим образом:
- Найдите параметры Azure OpenAI на странице сведений о развертывании в Azure.
- Введите свой ключ API Azure OpenAI.
- Укажите Endpoint, API Version и Deployment / Model Name.
- Нажмите Save.
В поле 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>
- Для BYOK включите новейшие модели генерации текста, а также модель
text-embedding-3-small. - Убедитесь, что в вашем проекте не включены ограничения на размещение данных.
Важные замечания
- dbt Copilot — отдельный инструмент, отличающийся от dbt Wizard. Для разработки с ИИ-агентом на всех этапах жизненного цикла используйте dbt Wizard.
- Функции ИИ включены по умолчанию. Администраторы могут в любой момент отключить или снова включить их.
- Некоторые функции доступны только в тарифных планах Enterprise и Enterprise+. Подробности см. в разделе Оплата.
- dbt Copilot пока не поддерживает генерацию семантических моделей с использованием последней версии спецификации YAML.


