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

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

Главная вкладка dbt Wizard — это интерфейс разработки в dbt platform, ориентированный на работу с ИИ-агентом.

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

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

Главная вкладка dbt Wizard дополняет [возможности dbt Wizard в Studio IDE](https://docs.getdbt.tech/docs/dbt-ai/wizard-ide.md). В то время как Studio IDE позволяет пользователям работать непосредственно в традиционной среде IDE, главная вкладка специально создана для разработки с ИИ-агентом и помогает сосредоточиться на контроле и проверке результатов его работы.

[![Главная вкладка dbt Wizard — начальный экран с запросами для быстрого старта](/img/docs/dbt-platform/wizard-home-empty.png?v=2 "Главная вкладка dbt Wizard — начальный экран с запросами для быстрого старта")](#)Главная вкладка dbt Wizard — начальный экран с запросами для быстрого старта

[![Агент dbt Wizard выполняет рефакторинг модели docs github для технических писателей :) ](/img/docs/dbt-platform/wizard-home-agent.png?v=2 "Агент dbt Wizard выполняет рефакторинг модели docs github для технических писателей :) ")](#)Агент dbt Wizard выполняет рефакторинг модели docs github для технических писателей :)

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

* [Аккаунт dbt](https://www.getdbt.com/signup) и [пользовательская лицензия Developer или Read-only](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-versions/experimental-features.md) для вашего аккаунта.

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

## Возможности

Используйте dbt Wizard на главной вкладке, чтобы:

* **Получать ответы с учётом контекста проекта**: задавайте вопросы о происхождении данных, зависимостях, логике моделей и контексте проекта.
* **Отлаживать задания, завершившиеся с ошибкой**: исследуйте ошибки запусков и заданий с помощью dbt Agent Skills с учётом полного контекста проекта.
* **Создавать ветки и управлять ими**: создавайте и переключайте ветки непосредственно в процессе работы с агентом.
* **Вносить изменения в модели и проект**: выполняйте рефакторинг SQL, обновляйте YAML и изменяйте конфигурацию проекта с помощью естественного языка.
* **Создавать и дорабатывать логику преобразований**: создавайте или переписывайте модели, тесты, документацию и семантические определения с помощью запросов на обычном языке.
* **Запускать процедуры проверки**: выполняйте компиляцию и сборку, чтобы проверить предлагаемые изменения до их сохранения.
* **Задавать вопросы о данных в рабочей среде**: используйте [режим Explore](#agent-modes), чтобы запрашивать управляемые метрики и модели на обычном языке и просматривать SQL или определение метрики, лежащие в основе каждого ответа. Это основной интерфейс для [пользователей с доступом только для чтения](https://docs.getdbt.tech/docs/platform/wizard-read-only-users.md).
* **Выбирать модель**: выбирайте модель под управлением dbt (управляемое подключение), с которой хотите работать, в [меню выбора модели](https://docs.getdbt.tech/docs/dbt-ai/pricing-billing/overview.md#choose-a-model).

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

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

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

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

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

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

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

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

Режим Explore выполняет запросы с вашими личными учётными данными хранилища. Если их нет, он использует [учётные данные для аналитики](https://docs.getdbt.tech/docs/platform/wizard-read-only-users.md#set-up-analytics-credentials) проекта — общие учётные данные, которые администратор настраивает для подключений Snowflake, BigQuery, Redshift или Databricks. Благодаря этому [пользователи с доступом только для чтения](https://docs.getdbt.tech/docs/platform/wizard-read-only-users.md) могут выполнять запросы без собственных учётных данных. Если ни тех ни других нет, dbt Wizard предложит настроить учётные данные или обратиться к администратору.

Ответы в режиме Explore опираются на определения в вашем проекте, поэтому для их формирования необходимы метаданные или определения Semantic Layer. О том, что помогает улучшить ответы, см. раздел [Подготовьте команду к получению качественных ответов](https://docs.getdbt.tech/docs/platform/wizard-read-only-users.md#set-your-team-up-for-good-answers).

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.

На главной вкладке нажмите **Open** у результата, чтобы просмотреть визуализацию на правой боковой панели контекста и скачать оттуда данные.

[![Режим Explore на главной вкладке dbt Wizard: сводка на обычном языке, диаграмма и переключатели Chart/Table/SQL.](/img/docs/dbt-platform/wizard-home-explore-viz.png?v=2 "Режим Explore на главной вкладке dbt Wizard: сводка на обычном языке, диаграмма и переключатели Chart/Table/SQL.")](#)Режим Explore на главной вкладке dbt Wizard: сводка на обычном языке, диаграмма и переключатели Chart/Table/SQL.

## Режим встроенного предварительного просмотра

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

Предварительный просмотр включает:

* **Расширенное сравнение SQL**: просматривайте предлагаемые изменения кода в расположенных рядом версиях, прежде чем принять их.
* **Структурные визуализации DAG**: исследуйте преобразования в виде DAG на уровне операторов, где логика разбита на знакомые операции — соединения, фильтрацию, агрегацию и проекции, — чтобы было проще понять изменения модели, не ограничиваясь исходным SQL.
* **Результаты проверки с учётом выполнения**: просматривайте результаты компиляции и сборки прямо в интерфейсе, чтобы оценить и предлагаемую реализацию, и поведение преобразования на практике.
* **Переход к связанным интерфейсам**: из предварительного просмотра открывайте модель непосредственно в Catalog для изучения метаданных и происхождения данных или открывайте файл в Studio IDE, чтобы при необходимости доработать его вручную.

## Когда использовать главную вкладку, а когда — Studio IDE

Главная вкладка и Studio IDE предназначены для разных этапов процесса разработки:

|                                         | Главная вкладка                                                             | Studio IDE                                                                                         |
| --------------------------------------- | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| **Основной рабочий процесс**            | Контроль и проверка результатов работы агента                               | Написание и изменение кода непосредственно в редакторе                                             |
| **Интерфейс**                           | Упрощённый чат для работы с агентом                                         | Полноценная IDE с обозревателем файлов, редактором и консолью                                      |
| **Лучше всего подходит для**            | Доработка с помощью естественного языка, просмотр различий, запуск проверок | Ручное редактирование файлов, непосредственное написание SQL, сложная работа с несколькими файлами |
| **Встроенный предварительный просмотр** | ✅ Различия в SQL, визуализации DAG, результаты сборки                      | Отображение различий в файлах до сохранения изменений                                              |

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

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

При использовании управляемое подключение инференса 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 в Studio IDE](https://docs.getdbt.tech/docs/dbt-ai/wizard-ide.md)
* [Приглашение пользователей с доступом только для чтения в dbt Wizard](https://docs.getdbt.tech/docs/platform/wizard-read-only-users.md)
* [О dbt Wizard в dbt platform](https://docs.getdbt.tech/docs/platform/wizard-platform.md)
* [Как работает dbt Wizard](https://docs.getdbt.tech/docs/dbt-ai/wizard-how-it-works.md)
* [Сборник примеров запросов](https://docs.getdbt.tech/guides/prompt-cookbook.md)
* [Часто задаваемые вопросы об ИИ в dbt](https://docs.getdbt.tech/docs/dbt-ai/dbt-ai-faqs.md)