# Как использовать Wizard в вашем проекте dbt

dbt Wizard — это ИИ-агент, который опирается на метаданные вашего проекта dbt — модели, граф зависимостей, тесты и метрики — вместо того чтобы делать предположения только на основе кода. Вы можете запускать его локально из CLI или в dbt platform. Подробнее о нём читайте в разделе [Обзор dbt Wizard](https://docs.getdbt.tech/docs/platform/wizard-overview.md), а инструкции по настройке — в разделе [Начало работы](https://docs.getdbt.tech/docs/platform/wizard-overview.md#get-started).

В этом руководстве собраны рабочие процессы, которые мы рекомендуем использовать после запуска Wizard в реальном проекте: изучение незнакомой кодовой базы, проверка изменений перед внедрением, добавление тестов, отладка задания, завершившегося с ошибкой, разработка с учётом состояния продакшен-среды, создание определений Semantic Layer и расширение возможностей Wizard с помощью плагинов и хуков.

## Цели обучения

* Разобраться, какие запросы и контекст помогают получать надёжные результаты от dbt Wizard при решении реальных задач проекта.
* Научиться определять, когда стоит использовать dbt Wizard, а когда — выполнить задачу вручную.
* Выстроить воспроизводимые рабочие процессы, которые вы и ваша команда сможете повторно использовать в разных проектах.

## Перед началом работы

Эти рабочие процессы применимы к CLI dbt Wizard и dbt platform. На каждой странице указано, относится ли она к CLI или к dbt platform.

Для локальных рабочих процессов убедитесь, что CLI dbt Wizard установлен, настроен и подключён к проекту dbt с актуальным файлом `target/manifest.json`.

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

## Используйте отдельный чат для каждой задачи

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

Рабочие процессы в этом руководстве следуют этому принципу: каждый из них представляет собой самостоятельную задачу, которую можно выполнить в отдельном чате. О том, как начинать, возобновлять и управлять сеансами в каждом интерфейсе, читайте в разделе [Сеансы и разговоры](https://docs.getdbt.tech/docs/dbt-ai/wizard-how-it-works.md#sessions-and-conversations) для dbt platform и в разделе [Сеансы](https://docs.getdbt.tech/docs/dbt-ai/wizard-how-it-works.md#sessions) для CLI и Wizard Desktop.