=======================
4. Dataset Builder AI
=======================

Objetivo
========

Gerar dataset transformado com fluxo conversacional guiado e rastreavel.

O que este modulo deve cumprir
==============================

1. Fazer perguntas relevantes por etapa.
2. Gerar e executar transformacoes.
3. Exibir preview com impacto em linhas/colunas.
4. Permitir confirmar, repetir ou corrigir.

Fluxo conversacional realista
=============================

1. Abrir ``Dataset Builder AI`` e selecionar versao do dataset.
2. Ler analise inicial.
3. Responder perguntas com interacao humana real:
   - Pedir esclarecimentos.
   - Mudar decisao no meio do fluxo.
   - Rejeitar resultado e pedir nova tentativa.
4. Continuar ate aparecer preview final.
5. Confirmar apenas quando a saida cumprir o objetivo.

Se o resultado nao for o esperado
=================================

1. Pedir esclarecimento antes de confirmar a etapa.
2. Ajustar decisoes anteriores e executar retry.
3. Se o row count cair de forma inesperada, repetir com parametros mais conservadores.
4. Se a saida ficar com zero linhas, usar retry e revisar opcoes de transformacao.

Checklist de validacao funcional
================================

1. Builder cria artifact e nova versao de dataset.
2. Row count final e reportado explicitamente.
3. Preview reflete transformacoes escolhidas.
4. Estado da conversa persiste apos refresh/reentrada.
5. Retry restaura dataset valido anterior quando solicitado.

Resultado esperado
==================

1. Fluxo completo de analise ate artifact final sem perda de estado.
2. Dataset final utilizavel em Experiments.

Erros comuns e recuperacao
==========================

1. ``Zero-row output``:
   - Executar retry e ajustar estrategia.
2. Resultado inesperado:
   - Solicitar rollback/retry na conversa.
3. Interrupcao de sessao:
   - Reabrir sessao e continuar do checkpoint.

Imagem
======

.. figure:: ../../_static/user-manual/common/dataset-builder.png
   :alt: Conversa e preview do Dataset Builder
   :width: 90%

   Fluxo conversacional com preview de transformacao.