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

Локальная разработка

Wizard Desktop — это dbt Wizard в виде нативного приложения. Просматривайте наглядные визуализации данных, различия в данных, граф зависимостей и многое другое, чтобы получать результаты быстрее, чем когда-либо.

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

[Download for macOSFor Apple silicon Macs · .dmg](https://public.cdn.getdbt.com/dbt-wizard/latest/dbt-wizard-app-aarch64-apple-darwin.dmg)[Download for WindowsFor x64 processors · .exe](https://public.cdn.getdbt.com/dbt-wizard/latest/dbt-wizard-app-x86_64-pc-windows-msvc.exe)[Download for LinuxFor x86\_64, Debian-based distributions · .deb](https://public.cdn.getdbt.com/dbt-wizard/latest/dbt-wizard-app-x86_64-unknown-linux-gnu.deb)

Need a different build? [Intel Mac (.dmg)](https://public.cdn.getdbt.com/dbt-wizard/latest/dbt-wizard-app-x86_64-apple-darwin.dmg) · [Linux ARM64 (Debian-based) (.deb)](https://public.cdn.getdbt.com/dbt-wizard/latest/dbt-wizard-app-aarch64-unknown-linux-gnu.deb)

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

* **Параллельные чаты:** каждый чат получает собственное рабочее дерево (worktree) Git, поэтому несколько задач могут выполняться одновременно без конфликтов.
* **Наглядная проверка:** просматривайте структурированные результаты, включая представление `dbt-compare`, показывающее, как ваши изменения повлияли на данные.
* **Контекстные комментарии:** наведите указатель практически на любой элемент, чтобы прокомментировать именно его, а затем отправьте несколько комментариев вместе.
* **Диаграммы и таблицы:** задайте вопрос о данных и увидите ответ прямо в чате.
* **Влияние изменений прямо в интерфейсе:** смотрите, какие модели затронуты изменениями dbt Wizard, и открывайте сравнение версий, не покидая текущего представления.
* **Просмотр графа зависимостей, файлов и метрик:** изучайте проект прямо рядом с чатом.

[![Главный экран dbt Wizard](/img/wizard/desktop/wizard-desktop-intro.png?v=2 "Главный экран dbt Wizard")](#)Главный экран dbt Wizard

[![Активный сеанс с диаграммой в чате и результатами проверки на боковой панели](/img/wizard/desktop/wizard-desktop-validation.png?v=2 "Активный сеанс с диаграммой в чате и результатами проверки на боковой панели")](#)Активный сеанс с диаграммой в чате и результатами проверки на боковой панели

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

Для использования Wizard Desktop вам понадобятся:

* Компьютер с macOS, Linux или Windows.
* Учётная запись dbt, если вы хотите использовать ключи, управляемые dbt. Вы можете создать бесплатную учётную запись при входе или использовать существующую. При использовании [BYOK](https://docs.getdbt.tech/docs/dbt-ai/wizard-byok.md) можно работать с Wizard Desktop без учётной записи dbt.
* Локальная копия проекта dbt на вашем компьютере, если вы хотите, чтобы dbt Wizard работал с файлами проекта. Приложение ищет существующие проекты, но вы также можете выбрать папку проекта самостоятельно.
* Учётные данные для хранилища данных, если вы хотите, чтобы dbt Wizard запускал ваш проект или выполнял запросы к данным. Настраивать их до открытия приложения не требуется.

[]()

## Установка Wizard Desktop

1. Скачайте установщик для вашей операционной системы:

   * [macOS, Apple silicon (.dmg)](https://public.cdn.getdbt.com/dbt-wizard/latest/dbt-wizard-app-aarch64-apple-darwin.dmg) или [macOS, Intel (.dmg)](https://public.cdn.getdbt.com/dbt-wizard/latest/dbt-wizard-app-x86_64-apple-darwin.dmg)
   * [Windows, x64 (.exe)](https://public.cdn.getdbt.com/dbt-wizard/latest/dbt-wizard-app-x86_64-pc-windows-msvc.exe)
   * [Linux, x86\_64 (.deb)](https://public.cdn.getdbt.com/dbt-wizard/latest/dbt-wizard-app-x86_64-unknown-linux-gnu.deb) или [Linux, ARM64 (.deb)](https://public.cdn.getdbt.com/dbt-wizard/latest/dbt-wizard-app-aarch64-unknown-linux-gnu.deb) — для дистрибутивов на основе Debian, таких как Ubuntu

   В других дистрибутивах Linux установите приложение через [dbt Wizard CLI](https://docs.getdbt.tech/docs/dbt-ai/wizard-cli.md): выполните `wizard app`.

2. Откройте Wizard Desktop и выберите **Get started** на экране приветствия.

3. Следуйте инструкциям первоначальной настройки. При появлении запроса создайте бесплатную учётную запись dbt или войдите в существующую. Если вы используете собственные учётные данные провайдера ИИ ([BYOK](https://docs.getdbt.tech/docs/dbt-ai/wizard-byok.md)), вход можно пропустить.

## Добавление проектов dbt

На экране **Scan for your dbt projects** выберите, как dbt Wizard будет находить проекты:

* **Scan for projects**: dbt Wizard ищет локальные репозитории Git и добавляет все найденные проекты dbt. При появлении запроса разрешите доступ к папкам macOS, чтобы приложение могло обнаружить проекты.
* **Add from dbt platform**: подключите свою учётную запись dbt platform. dbt Wizard выполнит аутентификацию и покажет список ваших проектов на платформе; по умолчанию будут выбраны все проекты. Выберите проекты для добавления и, при необходимости, папку для их клонирования, затем нажмите **Clone**. dbt Wizard клонирует проекты локально, чтобы вы могли работать с файлами.
* **Add a folder instead**: выберите папку проекта на своём компьютере.
* **Start chatting without one**: пропустите настройку проекта. Чат без проекта не использует файлы проекта или подключение к хранилищу данных, поэтому переходите к разделу [Начало первого сеанса](#start-your-first-session).
* Когда закончите, нажмите **Continue**.

## Выбор способа доступа к модели ИИ

На экране **Connect an AI model provider** выберите, как dbt Wizard будет получать доступ к модели ИИ:

* **Start free trial with dbt-managed keys**: dbt Labs управляет ключами и предоставляет доступ к актуальным моделям OpenAI, Anthropic и моделям с открытым исходным кодом. Использование учитывается в рамках ваших кредитов dbt.
* **Use my own API key**: используйте собственные учётные данные провайдера с помощью [BYOK](https://docs.getdbt.tech/docs/dbt-ai/wizard-byok.md) для OpenAI, Anthropic, AWS Bedrock, Azure, Snowflake Cortex, Google Gemini, Databricks и других сервисов. Оплату взимает непосредственно ваш провайдер; этот вариант работает без тарифного плана dbt platform.
* **Skip, I'll do this later**: продолжите без выбора провайдера. Чтобы настроить его позже, перейдите в **Settings** → **AI providers**.

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

С 1 сентября 2026 года использование dbt Wizard тарифицируется по количеству токенов и оплачивается из кредитов вашего аккаунта. Все суммы кредитов предоставляются на аккаунт, а не на пользователя. Аккаунты Enterprise и Enterprise+ получают кредиты ежемесячно. Тарифные планы Developer и Starter включают 30-дневный пробный период и кредиты на сумму $100; те же условия доступны пользователям CLI с бесплатным аккаунтом dbt.

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

## Настройка подключения к хранилищу данных

Для запуска проекта или выполнения запросов к его данным dbt Wizard необходимо подключение к хранилищу данных. На главном экране выберите **Set a connection**. По умолчанию dbt Wizard подключается через ваш `profiles.yml`, который может быть ещё не настроен для проекта. Выберите один из вариантов:

* **Set warehouse credentials**: введите свои учётные данные, и dbt Wizard сохранит их локально в [`profiles.yml`](https://docs.getdbt.tech/docs/local/profiles.yml.md) и подключится напрямую. Используйте те же учётные данные разработчика, которые вы использовали бы для разработки в dbt platform. Сведения о том, какие данные вводить, см. в разделах [Начало работы со Studio IDE](https://docs.getdbt.tech/docs/platform/studio-ide/develop-in-studio.md#get-started-with-the-studio-ide) и [Окружения dbt platform](https://docs.getdbt.tech/docs/dbt-platform-environments.md).
* **Use the dbt platform CLI**: dbt Wizard работает через вашу учётную запись dbt platform, поэтому учётные данные остаются на платформе. Требуется отдельная установка [dbt platform CLI](https://docs.getdbt.tech/docs/platform/dbt-cli-installation.md).

Если подключение уже существует — через активный сеанс dbt platform или локальный `profiles.yml`, — dbt Wizard воспользуется им, и вы сможете перейти к разделу [Начало первого сеанса](#start-your-first-session).

## Начало первого сеанса

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

1. Убедитесь, что выбран нужный проект, или оставьте поле пустым для чата без проекта.
2. Для сеанса с проектом выберите, где dbt Wizard должен запускать проект, например `default · dev`. Если доступных вариантов нет, [настройте подключение к хранилищу данных](#set-up-your-warehouse-connection).
3. Выберите модель и глубину её рассуждений. Если доступных моделей нет, настройте провайдера в **Settings** → **AI providers**.
4. Выберите, какие действия dbt Wizard может выполнять без вашего одобрения. Доступные режимы разрешений, описанные в [следующем разделе](#review-and-accept-changes): **Plan changes**, **Ask for approval** и **Auto**.
5. Опишите, что вы хотите поручить dbt Wizard, или выберите вариант быстрого старта, например **Audit for test coverage**, **Tell me about this project** или **Help me refactor a model**.

Вот несколько запросов, которые стоит попробовать при первом запуске:

* `Tell me about this project`
* `Which models have no tests?`
* `Refactor stg_orders and show me what changes in the data`

Чат — это отдельная беседа о вашем проекте. Каждый чат с проектом работает в собственной копии репозитория и отдельной ветке, используя рабочее дерево Git (worktree), поэтому вы можете одновременно вести несколько задач, не мешая одной другой.

Каждый чат получает имя, например `docs-fox`, которое также используется для его ветки и схемы. Подробнее о значении этих имён см. в разделе [Имена рабочих деревьев и схем](https://docs.getdbt.tech/docs/dbt-ai/wizard-desktop-use.md#worktree-and-schema-names).

## Проверка и принятие изменений

dbt Wizard изучает граф зависимостей, тесты и метаданные вашего проекта, запускает инструменты и создаёт по волшебству изменения в виде сравнения версий. Дальнейшие действия зависят от выбранного [режима разрешений](https://docs.getdbt.tech/docs/dbt-ai/wizard-desktop-use.md#permission-modes):

* **Plan changes**: dbt Wizard предлагает подход, ничего не редактируя.
* **Ask for approval**: dbt Wizard предлагает каждое изменение и ждёт. Ничего не записывается, пока вы не одобрите изменение.
* **Auto**: dbt Wizard применяет правки и показывает индикатор изменений, который можно открыть для их проверки.

Каждое изменение представлено в виде сравнения версий, доступного для проверки. Вы можете прокомментировать конкретную строку, ячейку таблицы или диаграмму, чтобы отправить обратную связь в чат. См. раздел [Проверка изменений](https://docs.getdbt.tech/docs/dbt-ai/wizard-desktop-use.md#review-what-changed).

## Обновление приложения

Когда появляется новая версия Wizard Desktop, приложение обычно сообщает об этом через несколько секунд после запуска. Нажмите **Install**, чтобы обновить приложение, или **Dismiss**, чтобы отложить обновление до следующего запуска.

Чтобы проверить наличие обновлений в любое время:

1. Перейдите в **Settings** → **General** → **Application updates**. Здесь отображается текущая версия приложения.
2. Нажмите **Check for updates**.
3. Если доступна новая версия, нажмите **Install version** и дождитесь завершения установки.
4. Нажмите **Restart to finish update**. Приложение не перезапустится автоматически.

Вы также можете включить автоматические обновления с помощью переключателя **Automatic updates** в том же разделе.

## Переходите с CLI?

Это тот же знакомый вам dbt Wizard, работающий на том же движке, что и [dbt Wizard CLI](https://docs.getdbt.tech/docs/dbt-ai/wizard-cli.md). В приложении есть встроенный терминал, поэтому вы можете запускать команды dbt привычным способом, а также в любой момент выбрать **Open in**, чтобы открыть ту же ветку в iTerm, Terminal, VS Code, Cursor или Finder.

[Скачайте Wizard Desktop](#install-and-open-wizard-desktop) и установите приложение.

Сведения о файлах конфигурации, используемых CLI, см. в [справочнике по конфигурации](https://docs.getdbt.tech/docs/dbt-ai/wizard-config.md).

|                                                      | [Wizard Desktop](https://docs.getdbt.tech/docs/dbt-ai/wizard-desktop.md)    | [CLI](https://docs.getdbt.tech/docs/dbt-ai/wizard-cli.md) | [dbt platform](https://docs.getdbt.tech/docs/platform/wizard-platform.md) |
| ---------------------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------- | -------------------------------------------------------------------------- |
| Где работает                                         | Нативное приложение на вашем компьютере                                      | Ваш терминал                                               | Браузер                                                                    |
| Лучше всего подходит для                             | Наблюдения за работой и управления ею, ведения нескольких задач одновременно | Написания скриптов и рабочих процессов в терминале         | Полноценной разработки и аналитики для бизнес-пользователей                |
| Визуальное представление таблиц, диаграмм и различий | Да                                                                           | Обычный текст в терминале                                  | Да                                                                         |
| Параллельная работа                                  | Да, каждый чат получает собственное рабочее дерево                           | Один сеанс на терминал                                     | Да                                                                         |
| История чатов                                        | Хранится в приложении                                                        | Возобновление предыдущего сеанса с помощью `wizard resume` | Хранится в вашей учётной записи dbt                                        |
| Доступность                                          | Публичная бета-версия, скачайте приложение                                   | Публичная бета-версия, установите CLI                      | Публичная предварительная версия, в вашей учётной записи dbt               |

## Что дальше

* [Использование Wizard Desktop](https://docs.getdbt.tech/docs/dbt-ai/wizard-desktop-use.md): параллельные чаты, проверка результатов, комментарии, сравнение версий и устранение неполадок
* [Настройки Wizard Desktop](https://docs.getdbt.tech/docs/dbt-ai/wizard-desktop-settings.md): провайдеры, коннекторы, внешний вид, сочетания клавиш и GitHub
* [Сценарии использования и примеры](https://docs.getdbt.tech/docs/dbt-ai/wizard-use-cases.md)
* [Как использовать dbt Wizard в проекте dbt](https://docs.getdbt.tech/best-practices/how-to-use-wizard/wizard-1-intro.md)
* [Настройка BYOK](https://docs.getdbt.tech/docs/dbt-ai/wizard-byok.md)

Посмотрите, как это работает, и поделитесь отзывом

Хотите увидеть dbt Wizard в действии? Посмотрите [демонстрационное видео](https://www.youtube.com/watch?v=-lIzh1xQWMA).

Нам было бы интересно узнать о вашем опыте работы с dbt Wizard. Поделитесь отзывом, выполнив слеш-команду `/feedback` в интерактивном сеансе терминала или перейдя в канал [#dbt-wizard](https://getdbt.slack.com/archives/C0B6KLW6T26) в [Slack-сообществе dbt](https://docs.getdbt.com/community/join?version=2.0).

Большое спасибо за помощь в улучшении dbt Wizard и процесса разработки данных с помощью dbt!