Gerenciamento de Modelos

Gerencie seus modelos treinados: liste-os, inspecione a importância das features, verifique métricas e gerencie sua licença ML.

Listar todos os modelos

dataspoc-lens ml models

Mostra todos os modelos treinados no seu bucket com a coluna alvo, data de treino e métrica principal:

Model                    Target    Trained       AUC
churned_activity         churned   2026-04-10    0.91
ltv_customers            ltv       2026-04-08    0.87
fraud_transactions       is_fraud  2026-03-22    0.95

Explicar um modelo

dataspoc-lens ml explain --model <model>

Mostra a importância das features, métricas de avaliação e detalhes de treinamento de um modelo específico:

Model: churned_activity
Target: churned
Algorithm: GradientBoosting
Trained: 2026-04-10 14:32:00
Rows: 45,231

Metrics:
  AUC:       0.91
  Accuracy:  0.88
  Precision: 0.84
  Recall:    0.79

Top features:
  1. days_since_last_login    (0.23)
  2. total_sessions_30d       (0.18)
  3. support_tickets_open     (0.14)
  4. plan_type                (0.11)
  5. months_as_customer       (0.09)

Status da licença

dataspoc-lens ml status

Mostra se o ML está ativado, o tier da licença e a data de expiração.

Ativar o ML

dataspoc-lens ml activate <key>

Ativa o DataSpoc ML com uma chave de licença. Entre em contato com ml@dataspoc.com para obter uma chave.

Artefatos do modelo no bucket

Cada modelo treinado produz três arquivos armazenados em bucket/ml/models/<model>/:

Arquivo	Descrição
model.pkl	Modelo treinado serializado
features.json	Definições de features, transformações e mapeamentos de tipos de colunas usados durante o treinamento
metrics.json	Métricas de avaliação (accuracy, AUC, RMSE, precision, recall, etc.)

Esses artefatos são lidos por ml predict para pontuar novos dados e por ml explain para exibir detalhes do modelo.