# dbt Copilot Платформа dbt | Starter, Enterprise, Enterprise+ dbt Copilot помогает генерировать SQL, документацию, тесты и семантические модели в dbt platform. dbt Wizard — рекомендуемый агент для работы с dbt dbt Wizard — рекомендуемый ИИ-агент для разработки данных с соблюдением правил управления в dbt. Он охватывает полный цикл разработки — исследование, создание, проверку и выпуск — с опорой на граф зависимостей, тесты, контракты и определения метрик вашего проекта dbt. Дополнительную информацию см. в разделах [Часто задаваемые вопросы об ИИ в dbt](https://docs.getdbt.tech/docs/dbt-ai/dbt-ai-faqs.md#is-dbt-wizard-the-same-as-dbt-copilot), [Оплата](https://docs.getdbt.tech/docs/dbt-ai/wizard-billing-faqs.md) и [Условия использования dbt](https://www.getdbt.com/terms-of-use). *Ранняя версия dbt Copilot в Studio IDE доступна только ограниченному числу аккаунтов. dbt Wizard доступен для всех аккаунтов и рекомендуется для разработки с использованием ИИ в Studio IDE — он поддерживает все возможности быстрых действий dbt Copilot, а также многошаговые изменения со встроенной проверкой.* ## Лимиты действий по тарифным планам Использование dbt Copilot измеряется в действиях — один выполненный запрос к ИИ считается одним действием. Каждый тарифный план включает ежемесячный лимит действий на одну лицензию: | Тарифный план | Действий в месяц | | ------------- | ---------------- | | Developer | ❌ | | Starter | 100 | | Enterprise | 5,000 | | Enterprise+ | 10,000 | Лимиты Enterprise и Enterprise+ не действуют, если вы [используете собственный ключ (BYOK)](https://docs.getdbt.tech/docs/platform/wizard-byok-platform.md), поскольку оплату за такое использование взимает напрямую ваш поставщик ИИ. Для прежних тарифных планов уровня Enterprise, подключённых до 1 мая 2025 года, действует лимит в 1 000 действий. В разделе [Использование ИИ в dbt](https://docs.getdbt.tech/docs/platform/billing/dbt-ai-usage.md) описано, что считается действием, что происходит при достижении лимита и как проверить объём использования. ## Настройка поставщика ИИ для dbt Copilot Для изменения настроек аккаунта и настройки поставщиков необходимы права администратора dbt. dbt Copilot настраивается отдельно от dbt Wizard — сведения о поставщиках для dbt Wizard см. в разделе [Управление функциями ИИ](https://docs.getdbt.tech/docs/platform/manage-dbt-ai.md#configure-ai-provider). 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, если ваша команда использует эти встроенные функции ИИ. **Чтобы настроить провайдера:** 1. Нажмите на название своей учетной записи и выберите **Account settings** в боковом меню. 2. В разделе **Settings** нажмите **Copilot**. 3. В разделе **AI providers** нажмите **Edit**, чтобы настроить интеграцию с ИИ. 4. Выберите вариант **Key management** в раскрывающемся списке, затем выполните приведенные ниже действия для своего провайдера. ### dbt Labs OpenAI 1. Выберите переключатель **dbt Labs**, чтобы использовать ключ OpenAI, управляемый dbt Labs. 2. Нажмите **Save**. [![Пример страницы интеграции с dbt Labs](/img/docs/dbt-platform/account-integration-dbtlabs.png?v=2 "Пример страницы интеграции с dbt Labs")](#)Пример страницы интеграции с dbt Labs ### OpenAI 1. Выберите переключатель **OpenAI**, чтобы использовать собственный ключ OpenAI. 2. Введите ключ API. 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. ### Azure OpenAI Подробнее о развертывании собственной модели OpenAI в Azure см. в разделе [Развертывание моделей в Azure OpenAI](https://learn.microsoft.com/en-us/azure/ai-studio/how-to/deploy-models-openai). Настройте учетные данные для своего развертывания Azure OpenAI в dbt следующим образом: 1. Найдите параметры Azure OpenAI на странице сведений о развертывании в Azure. 2. Введите свой ключ API Azure OpenAI. 3. Укажите **Endpoint**, **API Version** и **Deployment / Model Name**. 4. Нажмите **Save**. Используйте полный URI назначения Azure В поле **Endpoint** введите полный URI назначения (Target URI) из Azure — не только базовый адрес конечной точки. Если указать только базовый адрес, например `https://.openai.azure.com`, проверка учетных данных не пройдет и завершить настройку не удастся. Поддерживаются следующие форматы: * `https://.openai.azure.com/openai/deployments//chat/completions?api-version=` * `https://.openai.azure.com/openai/responses?api-version=` [![Пример раздела интеграции с Azure OpenAI](/img/docs/dbt-platform/account-integration-azure-manual.png?v=2 "Пример раздела интеграции с Azure OpenAI")](#)Пример раздела интеграции с Azure OpenAI * Для BYOK включите новейшие модели генерации текста, а также модель `text-embedding-3-small`. * Убедитесь, что в вашем проекте не включены ограничения на размещение данных. ## Важные замечания * dbt Copilot — отдельный инструмент, отличающийся от dbt Wizard. Для разработки с ИИ-агентом на всех этапах жизненного цикла используйте [dbt Wizard](https://docs.getdbt.tech/docs/platform/wizard-overview.md). * Функции ИИ включены по умолчанию. Администраторы могут [в любой момент отключить или снова включить их](https://docs.getdbt.tech/docs/platform/manage-dbt-ai.md). * Некоторые функции доступны только в тарифных планах Enterprise и Enterprise+. Подробности см. в разделе [Оплата](https://docs.getdbt.tech/docs/platform/billing.md). * dbt Copilot пока не поддерживает генерацию семантических моделей с использованием последней версии спецификации YAML.