dbt Wizard home tab BetaStarterEnterpriseEnterprise +
The dbt Wizard home tab is an agent-native development experience in the dbt platform. It centers your workflow around collaborating with the agent itself — iterating through natural language, reviewing generated changes, and validating outcomes — without the overhead of a traditional IDE environment.
We'd love to hear how dbt Wizard is working for you. Share your feedback by either running the /feedback slash command in your interactive terminal session or by going to the #dbt-wizard channel in the dbt Community Slack.
Thanks so much for your help in improving dbt Wizard and dbt data development!
dbt Wizard home tab — agent refactoring a model with an inline SQL diff
dbt Wizard home tab — empty state with quick-start promptsThe dbt Wizard home tab is complementary to the dbt Wizard experience in Studio IDE. Where the Studio IDE supports users working directly within a traditional IDE environment, the home tab is purpose-built for agent-native development — it reduces overhead and keeps you focused on supervising and validating agent-generated work.
Prerequisites
- A Starter, Enterprise, or Enterprise+ plan
- A dbt account and Developer seat license.
- A development environment and credentials set up in the Studio IDE.
- Enabled AI features for your account.
- If you're using dbt Wizard in the home tab, you need to enable experimental features for your account.
What you can do
Use dbt Wizard in the home tab to:
- Answer project-aware questions: Ask about lineage, dependencies, model logic, and project context.
- Debug failed jobs: Investigate run and job failures using dbt Agent Skills with full project context.
- Create and manage branches: Initiate and switch branches directly from the agent workflow.
- Make model and project changes: Refactor SQL, update YAML, and modify project configuration through natural language.
- Generate and refine transformation logic: Build or rewrite models, tests, documentation, and semantic definitions from plain-language prompts.
- Run validation workflows: Execute compile and build checks to validate proposed changes before they're persisted.
Always review AI-generated content before applying it. For prompt best practices, refer to the Prompt cookbook.
Inline preview mode
A core part of the home tab experience is inline preview mode, which gives you multiple ways to review and validate agent-generated changes directly in the workflow without switching to a separate tool.
The preview experience includes:
- Enhanced SQL diffs: Review proposed code changes side by side before accepting them.
- Structural DAG visualizations: Inspect transformations as operator-level DAG views that break logic into familiar patterns — joins, filters, aggregations, and projections — making it easier to understand how a model changed beyond the raw SQL.
- Execution-aware validation feedback: See results from compile and build checks inline, so you can assess both the proposed implementation and how the transformation behaves in practice.
- Jump to related surfaces: From the preview, open a model directly in Catalog to explore metadata and lineage, or open the file in Studio IDE to iterate manually when needed.
Wizard home tab vs Studio IDE
The home tab and Studio IDE support different parts of the development workflow:
For most development workflows, you can move between the two surfaces freely. Use the home tab to investigate and generate, and drop into Studio IDE when you need direct control.
Related docs
- dbt Wizard in Studio IDE
- About dbt Wizard in the dbt platform
- How dbt Wizard works
- Prompt cookbook
- dbt AI FAQs
Was this page helpful?
This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.
