# dbt Wizard в Studio IDE [Предварительная версия](https://docs.getdbt.tech/docs/dbt-versions/product-lifecycles "Подробнее о статусе или тарифе")

Платформа dbt | Оплата по использованию

Используйте dbt Wizard в Studio IDE, чтобы быстрее вносить надежные изменения в dbt. Он понимает ваш проект, отвечает на вопросы с учетом контекста, генерирует модели, тесты, документацию и определения Semantic Layer, а также показывает различия в файлах перед сохранением изменений.

dbt Wizard поддерживает весь жизненный цикл разработки dbt — от исследования до проверки изменений. Используйте его, чтобы:

* Задавать вопросы о проекте с учетом связей между данными, метаданных и контекста каталога.
* Создавать модели или выполнять их рефакторинг по запросам на естественном языке.
* Генерировать и проверять YAML для тестов, документации, семантических моделей и метрик.
* Вносить целевые изменения в логику, имена, материализации, тесты и связанные YAML-файлы.
* Исследовать сбои заданий и запусков с помощью dbt Agent Skills.

Агент включает следующие возможности, доступные сразу и не требующие настройки:

* [dbt Agent Skills](https://github.com/dbt-labs/dbt-agent-skills): рекомендуемые dbt руководства и инструкции, поддерживаемые dbt Labs.
* [Набор инструментов Product docs сервера dbt MCP](https://docs.getdbt.tech/docs/dbt-ai/mcp-available-tools.md#product-docs): инструменты для поиска и получения материалов из официальной документации dbt.

Функции ИИ включаются по умолчанию. Они уже включены для новых аккаунтов и вскоре будут включены для существующих. Если ваша организация отказалась от их использования, они останутся выключенными. Администраторы могут в любое время [выключить или снова включить ИИ и настроить провайдеров](https://docs.getdbt.tech/docs/platform/manage-dbt-ai.md).

Предпочитаете учиться по видео?

Посмотрите бесплатный [видеокурс dbt Wizard](https://learn.getdbt.com/courses/dbt-wizard) на dbt Learn!

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

* [Аккаунт dbt platform](https://www.getdbt.com/signup) и [лицензия Developer](https://docs.getdbt.tech/docs/platform/manage-access/seats-and-users.md).
  * [Устаревшие тарифы Team](https://docs.getdbt.tech/docs/platform/billing/plans-and-billing.md#legacy-plans) не предоставляют доступ к dbt Wizard. Чтобы использовать его, перейдите на [тариф Starter, Enterprise или Enterprise+](https://www.getdbt.com/pricing).
* [Среда разработки](https://docs.getdbt.tech/docs/platform/studio-ide/develop-in-studio.md#get-started-with-the-studio-ide) и учетные данные, настроенные в Studio IDE.
* Используйте поддерживаемого провайдера ИИ. См. [Поддерживаемые провайдеры ИИ](https://docs.getdbt.tech/docs/platform/wizard-platform.md#supported-ai-providers) или [Таблицу тарифов провайдеров моделей](https://www.getdbt.com/legal/dbt-wizard-token-costs-by-model), где приведены полный список моделей и тарифы.

Если dbt Wizard перестал отвечать, возможно, ваш аккаунт исчерпал доступные кредиты на использование. См. [Пробный период и оплата](https://docs.getdbt.tech/docs/dbt-ai/pricing-billing/trial-and-billing.md).

 Доступность и особенности использования

* **Где работает:** Поддерживается только в [Studio IDE](https://docs.getdbt.tech/docs/platform/studio-ide/develop-in-studio.md), во всех [типах развертывания](https://docs.getdbt.tech/docs/platform/about-platform/tenancy.md?version=2.0). Не поддерживается в VS Code и dbt platform CLI.
* **Движки:** Работает с dbt v2 и dbt v1.
* **Диалоги:** В списке диалогов откройте меню **More actions** (три точки) нужного диалога, затем нажмите **Delete**, чтобы удалить его. При удалении открытого диалога панель очищается.
* **Сеансы:** Обновление текущей вкладки браузера сохраняет активный сеанс. В новой вкладке или при повторном открытии закрытой вкладки сеанс начинается с пустой историей.
* **История чата:** Хранится только в течение 90 дней. В развертываниях с одним арендатором история чата пока не поддерживается, поэтому сохраняйте все важное перед закрытием.
* **Режим планирования:** Пока не поддерживается. Агент не показывает отдельный план перед применением изменений, однако вы можете использовать режим **Ask for approval**, чтобы подтверждать изменения в каждом файле.
* **Новый чат:** Нажмите **Start new dbt Wizard chat** (в правом верхнем углу панели dbt Wizard), чтобы начать новый сеанс.

### Использование dbt Wizard

Используйте панель dbt Wizard для генерации ресурсов с помощью быстрых действий или поручите агенту полный цикл создания и рефакторинга моделей с помощью запросов на естественном языке.

Чтобы использовать dbt Wizard, выполните следующие действия:

1. Откройте свой проект dbt в [Studio IDE](https://docs.getdbt.tech/docs/platform/studio-ide/develop-in-studio.md), затем выберите **dbt Wizard** в палитре команд.

2. Начните ввод запроса одним из нескольких способов на [панели dbt Wizard](https://docs.getdbt.tech/docs/dbt-ai/wizard-ide.md?version=2#panel-controls):

   * **Быстрые действия**: Используйте [генерацию ресурсов с помощью быстрых действий](https://docs.getdbt.tech/docs/dbt-ai/wizard-ide.md#panel-controls) в верхней части панели для создания соответствующих запросов.
   * **Обычный текст**: Введите в текстовое поле описание того, что вы хотите создать или изменить.
   * **Контекст модели**: Введите `@`, чтобы выбрать модель в качестве контекста. Это ограничит изменения агента выбранным ресурсом.

3. Нажмите [кнопку **Agent mode**](https://docs.getdbt.tech/docs/dbt-ai/wizard-ide.md#agent-modes), чтобы задать режим работы dbt Wizard. Доступны режимы **Explore only**, **Ask for approval** (по умолчанию) и **Edit files automatically**.

4. Выберите модель dbt управляемое подключение, с которой хотите работать, в [списке выбора модели](https://docs.getdbt.tech/docs/dbt-ai/pricing-billing/overview.md#choose-a-model) рядом с кнопкой **Agent mode**.

5. [Просмотрите предложения агента](https://docs.getdbt.tech/docs/dbt-ai/wizard-ide.md#reviewing-agent-suggestions) и примите или отклоните изменения. Вы также можете нажать кнопку **Start new dbt Wizard chat**, чтобы начать новый сеанс чата.

6. [Разрешайте выполнение команд dbt](https://docs.getdbt.tech/docs/dbt-ai/wizard-ide.md#granting-command-permissions), когда dbt Wizard запрашивает запуск таких команд, как `dbt compile` или `dbt build`.

7. Повторите эти действия, чтобы создать или изменить другие модели.

8. Зафиксируйте изменения в своем проекте dbt и откройте pull request. Но будьте осторожны: этот волшебник умеет творить заклинания.

На следующих изображениях показано, как dbt Wizard отображает ход работы и результат:

[![dbt Wizard выполняет рефакторинг модели и отображает граф зависимостей в интерфейсе чата.](/img/docs/dbt-platform/wizard-ide-refactor-lineage.png?v=2 "dbt Wizard выполняет рефакторинг модели и отображает граф зависимостей в интерфейсе чата.")](#)dbt Wizard выполняет рефакторинг модели и отображает граф зависимостей в интерфейсе чата.

[![Итоговый результат рефакторинга Wizard в виде сравнения изменений](/img/docs/dbt-platform/wizard-ide-refactor-diff.png?v=2 "Итоговый результат рефакторинга Wizard в виде сравнения изменений")](#)Итоговый результат рефакторинга Wizard в виде сравнения изменений

Чтобы узнать больше о dbt Wizard и его работе, разверните следующие разделы с дополнительной информацией.

 Элементы управления панелью

Панель dbt Wizard содержит:

1. **Быстрые действия** (в центре): Кнопки в верхней части панели для типовых задач, таких как генерация документации, тестов, семантических моделей и метрик. При выборе действия текстовое поле автоматически заполняется запросом.
2. **Кнопка Agent mode** (внизу слева): Переключение между режимами **Explore only**, **Ask for approval** и **Edit files automatically**. Нажмите кнопку, чтобы сменить режим.
3. **Список выбора модели** (внизу слева): Выберите модель dbt управляемое подключение для текущего сеанса. Сведения о доступных моделях см. в разделе [Выбор модели](https://docs.getdbt.tech/docs/dbt-ai/pricing-billing/overview.md#choose-a-model).
4. **Контекст модели dbt** (внизу слева): Показывает текущий открытый файл. Используйте `@` в текстовом поле, чтобы сослаться на другую модель dbt. Нажмите **x**, чтобы убрать контекст модели dbt.
5. **Поле ввода текста** (внизу слева): Введите запрос в текстовое поле, чтобы описать, что вы хотите создать или изменить. Введите `@`, чтобы выбрать модель dbt в качестве контекста. Это ограничит изменения агента выбранным ресурсом.
6. **Start new dbt Wizard chat** (вверху справа): Начинает новый сеанс чата.
7. **Stop** или **Enter** (внизу справа): Нажмите **Enter**, чтобы отправить запрос. Нажмите **Stop**, чтобы остановить текущий сеанс и работу агента. Это действие нельзя отменить.

[![Панель Wizard в Studio IDE с кнопками быстрых действий, кнопкой режима агента, списком выбора модели и полем ввода текста.](/img/docs/dbt-platform/wizard-panel.png?v=2 "Панель Wizard в Studio IDE с кнопками быстрых действий, кнопкой режима агента, списком выбора модели и полем ввода текста.")](#)Панель Wizard в Studio IDE с кнопками быстрых действий, кнопкой режима агента, списком выбора модели и полем ввода текста.

В dbt Wizard также есть упрощенная навигационная панель над полем ввода текста. Она показывает текущий проект и ветку и помогает выполнять операции Git, например фиксировать изменения в файлах или создавать ветку.

[]()

 Режимы агента

dbt Wizard работает в трёх режимах:

| Режим                                        | Поведение                                                                                                                                                                                                                                                                                                                                                                                            |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Только исследование**                      | Агент выполняет запросы к данным и объясняет их, но не может редактировать файлы или запускать сборки. Лучше всего подходит для анализа данных или проверки результатов модели, когда вы не хотите, чтобы агент предлагал изменения. Каждый ответ сопровождается SQL-запросом или определением метрики, на котором он основан. Доступен на главной вкладке пользователям с правами только на чтение. |
| **Запрашивать подтверждение** (по умолчанию) | Агент подготавливает изменения в файлах. Вы подтверждаете каждое изменение файла перед его сохранением. Лучше всего подходит, если вам нужен строгий контроль над тем, что сохраняется в вашей ветке.                                                                                                                                                                                                |
| **Редактировать файлы автоматически**        | Агент подготавливает и автоматически сохраняет изменения в файлах без подтверждения для каждого файла. Лучше всего подходит для ускоренной итеративной работы, когда вы уверены в своём запросе.                                                                                                                                                                                                     |

Переключаться между режимами можно в любой момент с помощью кнопки **Режим агента** (внизу слева). В режимах редактирования аналитические инструменты остаются доступными, поэтому при выходе из режима **Только исследование** вы ничего не теряете.

[![dbt Wizard в режимах Explore only, Ask for approval и Edit files automatically.](/img/docs/dbt-platform/wizard-modes.png?v=2 "dbt Wizard в режимах Explore only, Ask for approval и Edit files automatically.")](#)dbt Wizard в режимах Explore only, Ask for approval и Edit files automatically.

 Просмотр предложений агента

Когда dbt Wizard предлагает изменения кода, вы можете просмотреть их до сохранения в проекте:

* **Просмотр различий**: Агент показывает сравнение предлагаемых изменений. Нажмите **Show all X lines**, чтобы развернуть и просмотреть предложение целиком.
* **Индикаторы строк**: Добавленные и удаленные строки выделены и снабжены номерами, чтобы вы могли точно увидеть, что изменилось.
* **Копирование или открытие в редакторе**: Используйте элементы в правом верхнем углу области сравнения, чтобы скопировать предложение или открыть его непосредственно в редакторе.

 Предоставление разрешений на выполнение команд

Для проверки или запуска моделей во время сеанса агент может запросить выполнение команд dbt, таких как `dbt compile` или `dbt build`. Перед выполнением каждого запроса вам будет предложено подтвердить его. Например, агент может запросить запуск:

```bash
dbt compile --select model_name
```

Вы можете выбрать один из следующих вариантов:

| Вариант                                               | Поведение                                                                             |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------- |
| **Yes, run once**                                     | Разрешает однократное выполнение этой конкретной команды.                             |
| **Yes, and allow `dbt_command_name` for the session** | Разрешает выполнять команды dbt до конца сеанса без повторных запросов подтверждения. |
| **No**                                                | Отклоняет запрос. Агент не выполнит команду.                                          |

После выполнения команды dbt Wizard добавляет значок и всплывающую подсказку к результатам на [вкладке **Commands**](https://docs.getdbt.tech/docs/platform/studio-ide/ide-user-interface.md#console-section) в Studio IDE. Это помогает отличать команды, запущенные агентом, от команд, запущенных вручную, в результатах выполнения и журналах.

### Добавление собственных навыков

Вы можете расширить возможности dbt Wizard с помощью собственных навыков, закрепив в них принятые в команде соглашения по SQL, правила именования и рабочие процессы моделирования, чтобы не повторять их в каждом запросе. Полный справочник, включая инструкции по созданию, структурированию и вызову навыков, см. в разделе [Навыки](https://docs.getdbt.tech/docs/dbt-ai/wizard-platform-skills.md).

### Диагностика сбоев заданий

dbt Wizard может исследовать и устранять сбои заданий и запусков dbt непосредственно из Studio IDE. Эта возможность основана на навыке `troubleshooting-dbt-job-errors` из набора [dbt Agent Skills](https://github.com/dbt-labs/dbt-agent-skills), который уже настроен в агенте — дополнительная настройка не требуется.

Вы можете задавать агенту вопросы и давать команды, например:

* «Какие задания завершились с ошибкой за последнее время?»
* «Какова первопричина сбоя задания?»
* «Как исправить недавний сбой задания?»
* «Исправь сбой задания».

Агент сообщает, когда локальное состояние проекта может отличаться от состояния, в котором выполнялось задание, — например, если вы работаете в другой ветке или у вас есть незафиксированные изменения. Так вы получите полный контекст, прежде чем применять предложенные исправления.

### Обработка тайм-аутов

Если команда dbt, запущенная dbt Wizard, выполняется более 5 минут, агент автоматически пытается остановить ее на сервере, прежде чем вернуть вам управление.

Вместо зависания или общей ошибки агент выводит понятное сообщение о том, что время ожидания команды истекло и ее выполнение было прервано. В сообщении также указано, удалось ли выполнить запрос на отмену. Если отмена не удалась, команда может продолжать выполняться на сервере.

После этого вы можете повторить команду, сузить запрос или выполнить другое действие.

### Процесс миграции на dbt v2

Если у вас есть доступ к [dbt Wizard](https://docs.getdbt.tech/docs/dbt-ai/wizard-ide.md) с включёнными [функциями ИИ](https://docs.getdbt.tech/docs/platform/manage-dbt-ai.md), вы можете воспользоваться навыком [миграции на dbt v2](https://docs.getdbt.tech/docs/dbt-ai/wizard-ide.md#fusion-migration-workflow). Этот навык помогает исправлять ошибки совместимости прямо в Studio IDE с помощью dbt Wizard — без ручного анализа логов. Он классифицирует каждую ошибку, автоматически применяет проверенные исправления и показывает, что препятствует дальнейшей миграции.

к сведению

Процесс миграции на dbt v2 доступен через dbt Wizard в Studio IDE. Если вы используете VS Code или dbt platform CLI, воспользуйтесь вместо этого [инструментом autofix](https://docs.getdbt.com/guides/dbt-package-compat?step=4).

1. В списке заданий нажмите кнопку **Review job** для задания с успешным запуском.
   * Если кнопка **Review job** не отображается, включите переключатель **Show dbt v2 eligibility** в списке заданий.

2. Во всплывающем окне **dbt v2 eligibility unknown for this job** нажмите **Debug in Studio with dbt Wizard**.

3. dbt перенаправит вас в Studio IDE и переключит вашу персональную среду разработки на dbt v2.

4. Откроется dbt Wizard и автоматически запустит навык миграции на dbt v2 со следующим запросом:

   ```text
   I need help fixing dbt v2 compatibility issues in this project. Please investigate and resolve any deprecation warnings or incompatibilities. Please use the migrating-dbt-core-to-fusion skill to guide this.
   ```

5. Рассмотрите и одобрите запросы разрешений от dbt Wizard, чтобы он мог выполнять необходимые команды.

6. dbt Wizard последовательно выполняет `dbt compile`, анализирует результаты и применяет исправления, пока компиляция не завершится успешно или не возникнет ошибка, которую он не сможет устранить. Если дальнейшая работа невозможна, он корректно завершает процесс, объясняет, что не удалось исправить, создаёт markdown-файл со сводкой всех внесённых изменений и предоставляет ссылку на него.

7. Когда проект будет компилироваться без предупреждений и ошибок, создайте коммит и опубликуйте изменения.

8. После слияния изменений дождитесь повторного запуска задания или запустите его вручную на dbt v2.

[![Процесс миграции на v2 с помощью Developer Agent: анализ и исправление ошибок совместимости с v2 в Studio IDE.](/img/docs/dbt-platform/v2-migration-workflow.gif?v=2 "Процесс миграции на v2 с помощью Developer Agent: анализ и исправление ошибок совместимости с v2 в Studio IDE.")](#)Процесс миграции на v2 с помощью Developer Agent: анализ и исправление ошибок совместимости с v2 в Studio IDE.

Подробнее о подготовке проекта к dbt v2 и действиях при возникновении ошибок совместимости см. в [контрольном списке готовности к dbt v2](https://docs.getdbt.tech/docs/dbt/dbt-readiness.md) и [руководствах по переходу на dbt v2](https://docs.getdbt.tech/guides/prepare-v2-upgrade.md).

### Составление эффективных запросов

Хорошие запросы включают *область применения* (какие модели или часть проекта затрагиваются), *цель* (нужное преобразование или бизнес-логику) и любые *ограничения* (соглашения об именовании, материализацию, тесты). Вот несколько примеров:

| Задача                                    | Пример запроса                                                                                                                                               |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Создать новую модель                      | «Создай модель с именем `fct_daily_revenue`, которая объединяет `stg_orders` и `stg_payments`, агрегирует выручку по дням и материализуется в виде таблицы». |
| Выполнить рефакторинг существующей модели | «Выполни рефакторинг `fct_orders`, чтобы использовать инкрементальную материализацию. Сохрани существующие тесты и соблюдай наши соглашения об именовании».  |
| Сгенерировать тесты и документацию        | «Добавь тесты `not_null` и `unique` для первичного ключа `dim_customers` и сгенерируй документацию для всех столбцов».                                       |

Подробные рекомендации, шаблоны и дополнительные примеры для SQL, документации, тестов и семантических моделей см. в [сборнике рецептов запросов](https://docs.getdbt.tech/guides/prompt-cookbook.md).

Рекомендации по использованию dbt Wizard

Рекомендуемые рабочие процессы для реальных задач проекта — изучения проекта, проверки изменений, создания определений Semantic Layer и других — см. в разделе [Как использовать dbt Wizard в проекте dbt](https://docs.getdbt.tech/best-practices/how-to-use-wizard/wizard-1-intro.md). Большинство этих запросов работают в Studio IDE аналогичным образом.

## Задавайте вопросы в режиме Explore

Режим Explore в Studio IDE позволяет задавать вопросы о данных производственной среды на обычном языке. dbt Wizard в режиме Explore отвечает и дает пояснения, но никогда не изменяет ваш проект. Этот режим отлично подходит для разведочного анализа данных и быстрого знакомства с ними.

В режиме Explore запросы выполняются с использованием ваших личных учетных данных для хранилища данных.

1. Откройте dbt Wizard и при необходимости выберите **Explore only** в переключателе режимов (внизу слева).

2. Введите свой вопрос и нажмите **Enter**. Формулируйте вопрос конкретно и указывайте нужный период, группировку и фильтр:

   * «Какова общая выручка за второй квартал 2026 года по месяцам?»
   * «Сколько новых клиентов зарегистрировалось в июле?»
   * «Какие регионы росли быстрее всего в этом году?»

3. dbt Wizard кратко описывает обычным языком выполненные действия, а затем показывает результат. Переключайтесь между **Chart**, **Table** и **SQL**, чтобы просматривать данные в удобном для вас виде.

4. Проверьте данные: откройте представление **SQL** и изучите запрос или управляемую метрику, на основе которых получен ответ. Обратите внимание: SQL-запрос нельзя редактировать, но можно скопировать.

5. Продолжите работу, задав уточняющий вопрос в той же беседе. Например, после первого вопроса можно написать «Теперь покажи разбивку по регионам».

Режим Explore использует dbt-управляемое подключение инференс, поэтому вопросы расходуют [пул потребления](https://docs.getdbt.tech/docs/dbt-ai/wizard-billing-faqs.md) dbt Wizard вашего аккаунта, как и любое другое использование dbt Wizard.

В Studio IDE ответ и его визуализация отображаются непосредственно на панели dbt Wizard рядом с вашим проектом.

[![Режим Explore в Studio IDE: диаграмма и переключатели Chart/Table/SQL на панели dbt Wizard.](/img/docs/dbt-platform/wizard-ide-explore-viz.png?v=2 "Режим Explore в Studio IDE: диаграмма и переключатели Chart/Table/SQL на панели dbt Wizard.")](#)Режим Explore в Studio IDE: диаграмма и переключатели Chart/Table/SQL на панели dbt Wizard.

## Выбор модели

При использовании управляемое подключение инференса dbt вы можете в любой момент переключаться между поддерживаемыми управляемыми моделями с помощью раскрывающегося списка выбора модели рядом с элементом управления **Agent mode** (где вы выбираете **Ask for approval** или **Edit files automatically**).

* В [Studio IDE](https://docs.getdbt.tech/docs/dbt-ai/wizard-ide.md) и на [главной вкладке dbt Wizard](https://docs.getdbt.tech/docs/platform/wizard-home.md) откройте раскрывающийся список выбора модели рядом с элементом управления **Agent mode** на панели dbt Wizard, затем выберите модель.
* В списке отображаются доступные вам управляемые модели. Сведения о доступных моделях и тарифах на их токены приведены в [таблице тарифов поставщиков моделей](https://www.getdbt.com/legal/dbt-wizard-token-costs-by-model).
* Если вы [используете собственный ключ (BYOK)](https://docs.getdbt.tech/docs/dbt-ai/wizard-byok.md), dbt Wizard использует поставщика и модель, настроенные для вашего ключа, а не модель из списка управляемых моделей.

[![Раскрывающийся список выбора модели рядом с элементом управления Agent mode на панели Wizard.](/img/docs/dbt-platform/wizard-model-picker.png?v=2 "Раскрывающийся список выбора модели рядом с элементом управления Agent mode на панели Wizard.")](#)Раскрывающийся список выбора модели рядом с элементом управления Agent mode на панели Wizard.

## Связанная документация

* [О dbt Wizard на платформе dbt](https://docs.getdbt.tech/docs/platform/wizard-platform.md)
* [Контрольный список готовности к dbt v2](https://docs.getdbt.tech/docs/dbt/dbt-readiness.md)
* [Разработка с dbt Wizard](https://docs.getdbt.tech/docs/platform/studio-ide/develop-studio-ai.md)
* [Сборник примеров запросов](https://docs.getdbt.tech/guides/prompt-cookbook.md)
* [Семантические модели](https://docs.getdbt.tech/docs/build/semantic-models.md)
* [Об ИИ и интеллектуальных возможностях dbt](https://docs.getdbt.tech/docs/dbt-ai/about-dbt-ai.md)