01
← → para navegar
Treinamento Nekt · ~1h30

Dos seus dados à inteligência.

Seis módulos, do primeiro sync ao agente respondendo. Prático, com mockups, exemplos e casos de uso reais.
academy.nekt.com
Agenda · seis módulos
O caminho que vamos percorrer
01
Ingestão
Sync, streams e agendamento, sem desperdício.
02
Armazenamento
Lakehouse, catálogo e camadas Bronze, Silver, Gold.
03
Contexto
A camada semântica que faz a IA acertar.
04
Transformações
Queries SQL e notebooks Python.
05
Ativação
MCP, Data API, destinations e BI.
06
Governança
Observabilidade, alertas e permissões.
00
ANTES DE COMEÇAR

O modelo mental

A jornada de maturidade em dados, e por que valor vem antes de otimização.
A raiz do problema
Cada ferramenta é uma ilha
Hoje · dados espalhados
HSHubSpot
MMeta Ads
GGoogle Ads
$ERP
GSSheets
PGPostgres
Com a Nekt · um só lugar
Ambiente único
Lakehouse + Catálogo
gold.receita_por_canal gold.funil_por_origem gold.clientes_360
A Nekt conecta os dados de todas as suas ferramentas num único ambiente. Sem isso, cada fonte conta uma história diferente.
O que a fragmentação causa
O mesmo número, quatro respostas Qual foi o faturamento de março?
M
Marketing
painel de anúncios
R$ 205 mil
Receita atribuída às campanhas
V
Vendas
CRM
R$ 188 mil
Soma dos deals marcados como ganhos
D
Diretoria
planilha manual
R$ 176 mil
Fechamento consolidado à mão
F
Financeiro
ERP
R$ 152 mil
Notas emitidas e conciliadas
152
176
188
205
R$ 53 mil de diferença Quatro sistemas, quatro verdades, e ninguém fecha o número. Sem uma base única, o dado gera reunião, não decisão.
Modelo de maturidade
Quatro etapas, valor desde cedo
01
Consolidar
Todas as fontes juntas no Lakehouse da Nekt.
02
Extrair valor
Contexto mais IA, e você já conversa com os dados. O valor aparece aqui, antes de qualquer modelagem.
03
Transformar
Modelar as consultas que viram rotina, quando compensa.
04
Produção
Apps e agentes rodando no dia a dia do time.
O princípio que guia tudo
Contexto e agentes já entregam assertividade que surpreende. A transformação vem depois, quando compensa.
Otimização não é o começo da jornada, é consequência de ter achado o que importa. Os seis módulos seguem essa ordem.
01
MÓDULO 01

Ingestão de dados

Trazer o dado certo, do jeito certo, na hora certa, sem surpresa de custo.
O que dá pra conectar
Estruturado e não estruturado
HS
HubSpot
Deals, contatos e pipeline do CRM
M
Meta Ads
Campanhas, gasto e resultado
G
Google Ads
Cliques, custo e conversões
PG
Postgres
Tabelas direto do schema
SQL
MySQL
Banco transacional do produto
GS
Google Sheets
Planilhas e controles manuais
S3
S3 / Arquivos
CSV, Excel e Parquet
API
API REST
Qualquer fonte com endpoint
Estruturado (APIs, bancos, planilhas) e não estruturado (PDFs, imagens, docs).
Growth · Custom

Trazer dado não estruturado para dentro do Catálogo, PDFs, imagens e documentos para a IA ler, é recurso dos planos Growth e Custom.

Comece pela pergunta
Da pergunta até a fonte
Pergunta de negócio
Qual canal traz mais receita?
Dado necessário
Vendas + origem do lead
Fonte
E-commerce + CRM
Engenharia reversa: parta do que o negócio pergunta, não da fonte.
Streams · o que trazer da fonte
Nem toda tabela precisa vir
fonte · HubSpot streams
dealspipeline de vendas
contactsquem é o lead
companiesempresa do lead
email_eventsnão precisa agora
marketing_emailsnão precisa agora
Traga só o necessário

Cada stream é uma tabela a mais pra sincronizar. Menos streams, sync mais rápido e catálogo enxuto. Marque o que responde uma pergunta e ligue o resto quando precisar.

Sync e custo
Atualização x custo
Sync completo
Full
Relê a fonte inteira a cada execução. Simples e à prova de erro: o destino é sempre um retrato exato da origem.
Sync incremental
Incremental
Só o que mudou desde o último sync. Barato em tabela grande, precisa de uma coluna de atualização confiável.
Full · relê a tabela inteira
5M linhas relidas a cada sync · minutos a horas
Incremental · só o que mudou
~2 mil linhas tocadas · segundos
Mesma tabela, mesma frescor. O incremental faz o mesmo trabalho tocando só o que mudou.
Agendamento e gatilhos
Frequência na fonte, o resto por evento
Fonte · agendada
1x por dia, dias úteis
Query · por evento
roda quando a fonte termina
Notebook · por evento
roda quando a query termina
Consumo
painel pronto às 8h
Encadeie por evento

Marque a frequência só na fonte. As transformações rodam em cascata, quando a etapa anterior termina, sem execução à toa e sem dado pela metade.

Caso real
Uma base saiu de 160+ execuções por semana (full de hora em hora, 24/7) para 5, incremental à noite em dias úteis, mantendo o painel pronto de manhã.
02
MÓDULO 02

Armazenamento, catálogo e camadas

O lakehouse: onde o dado mora e como ele é refinado, do bruto ao pronto.
Arquitetura medallion
Bronze, Silver e Gold
Bronze
Camada bruta
Como veio da fonte
  • Espelho fiel da origem
  • Sem edição, imutável
  • Tipos crus, muitas vezes texto
  • Um conjunto por fonte
refina
Silver
Camada tratada
Limpo e tipado
  • Colunas renomeadas e claras
  • Tipos corretos, sem duplicatas
  • Uma tabela por entidade
  • Agradável de ler
refina
Gold
Camada de consumo
Pronto pra decisão
  • Junta fontes, aplica regra de negócio
  • Tabelas prontas pra análise
  • É daqui que BI, MCP e API leem
  • Uma fonte de verdade
Uma recomendação, não uma regra

Cada empresa organiza as camadas como fizer sentido. O que importa é o conceito: bruto, refinado, pronto.

A mesma linha, refinada
Do cru ao pronto
pedido · bronze como veio
{ "id": "a83f", "vl": "1234.50", "st": "APV", "cust": "c_5521" } // texto, códigos crípticos, difícil de usar
gold.pedidos pronto
pedido valor status cliente canal
a83f R$ 1.234,50 aprovado Loja Silva Instagram
b91c R$ 890,00 pendente Café Aurora Google
Tipado, legível, com nome do cliente e canal já juntados. Pronto pra somar, filtrar e perguntar.
O Catálogo
Onde tudo fica organizado
catálogo do workspace camadas
── bronze/ # como veio da fonte hubspot_deals meta_ads_insights ── silver/ # limpo e tipado deals anuncios ── gold/ # pronto pra consumo receita_por_canal funil_por_origem
  • Camada como prefixo: bronze, silver, gold dão a leitura de maturidade num relance.
  • Nome que se explica: receita_por_canal diz o que é sem abrir a tabela.
  • Boa taxonomia é o que faz humano e IA acharem a tabela certa.
O nome importa mais que a camada

A camada é convenção. O que guia o consumo é a tabela ter um nome claro e estar no lugar esperado.

03
MÓDULO 03

Contexto e camada semântica

O que faz a IA entender de verdade os seus dados. O maior salto de assertividade.
Duas casas, dois papéis
Onde mora cada coisa
Descrição no Catálogo · o que o dado é
tabela assinaturas
ColunaDescrição
status int 1 = ativa, 2 = cancelada, 3 = em atraso
mrr decimal Receita recorrente mensal, em BRL
cliente_id int Referência ao cliente dono da assinatura
Context document · o que a métrica significa
cliente-acme.md Context document
# Acme Corp ## Cliente ativo Assinatura com status pago e ao menos 1 pagamento. Trials cancelados não contam. ## Receita Reconhecida a partir da data de corte do financeiro.
Por que contexto importa
As três formas de a IA errar
01 · Ambiguidade
Conceito → entidade
Existem quarenta campos plausíveis pra "receita". Sem contexto, o agente não sabe qual é o certo.
02 · Desatualização
Dado envelhece
Definições e schema mudam. O que o agente "sabia" fica velho e ele responde pelo passado.
03 · Recuperação
Não acha
A informação existe, mas some no meio de tudo. O agente não localiza a tabela certa.
Descrição de colunas, context documents e camada semântica atacam as três de uma vez.
Framework de falhas descrito pela Anthropic ao automatizar a própria análise de dados com Claude.
Benchmark externo · Anthropic
O que contexto fez pela própria Anthropic
95%
das perguntas de análise de negócio respondidas por IA, sem analista no meio.
90%
dos PRs de dados já atualizam a documentação escrita pra IA.
Acerto nas respostas
21%
só os dados crus
95%
+ camada semântica e skills
Fonte: Anthropic, "How Anthropic enables self-service data analytics with Claude". A camada semântica vira a fonte de verdade determinística das métricas.
A mensagem
O que mais move a assertividade não é modelar tudo. É dar contexto.
04
MÓDULO 04

Transformações de dados

Queries SQL e notebooks Python: modelar o que virou rotina, quando compensa.
Duas ferramentas de transformação
Query ou notebook?
SQL · declarativa
Query
Joins, agregações, filtros: o dia a dia da transformação. Roda agendada, é rápida de escrever e o MCP já gera pra você.
SELECT canal, SUM(valor) FROM silver.pedidos GROUP BY canal
Python / PySpark · procedural
Notebook
Quando a lógica não cabe em SQL: passo a passo, bibliotecas e integrações. Também gerado pelo MCP em linguagem natural.
import nekt df = nekt.load_table("Silver", "leads") df = enriquece_via_api(df) nekt.save_table(df, "Gold", ...)
O que só o notebook faz

Enriquecer via API externa, aplicar um modelo de ML, processar texto livre ou JSON aninhado, e cálculos iterativos. Regra prática: SQL pra maioria, notebook quando precisa de lógica ou libs.

Exemplo · transformação em SQL
Uma query que vira Gold
receita_por_canal.sql query
CREATE TABLE gold.receita_por_canal AS SELECT p.canal, date_trunc('month', p.data) AS mes, SUM(p.valor) AS receita FROM silver.pedidos p WHERE p.status = 'aprovado' GROUP BY 1, 2
Junta, filtra e agrega o Silver. Roda agendada e vira uma tabela pronta.
gold.receita_por_canal resultado
canal mes receita
Instagram2026-06R$ 42.000
Google2026-06R$ 31.500
Orgânico2026-06R$ 18.900
Gerado por linguagem natural

"Some a receita aprovada por canal e mês" e o MCP escreve essa query pra você.

Exemplo · transformação em notebook
Quando SQL não basta
enriquece_leads.ipynb python
import nekt, requests # lê a tabela tratada do Catálogo df = nekt.load_table("Silver", "leads") # enriquece cada lead via API externa def porte(cnpj): r = requests.get(f"https://api.receita/{cnpj}") return r.json()["porte"] df["porte"] = df["cnpj"].apply(porte) # salva de volta na camada Gold nekt.save_table(df, "Gold", "leads_enriquecidos")
Só o notebook faz
Chamar uma API externa por linha, aplicar um modelo de ML, ler texto livre ou JSON aninhado, e cálculos que precisam de laço. Lógica que SQL não expressa.
Mesmo destino

Query e notebook escrevem no mesmo Gold. Quem consome não sabe (nem precisa saber) como a tabela foi feita.

Valor primeiro, modelo depois
Modele o que se repete
  • Valor primeiro. Modele só depois que a resposta provou que serve.
  • Quando uma consulta vira rotina, aí sim vale virar tabela.
  • Para IA, a Nekt tende a favorecer wide tables, sem joins.
Cuidado com over-engineering

Não monte um star schema quando uma wide table resolve. Modelo bonito no diagrama costuma ser caro na prática.

Escolha pelo consumo
Três formas de modelar
Dimensional · fato_vendas com FKs
gold.fato_vendaschaves, precisa juntar
data_id
→ dim_data
cliente_id
→ dim_cliente
produto_id
→ dim_produto
valor
d_031c_5521p_88R$ 1.234
d_031c_7702p_88R$ 890
Guarda só as chaves. Pra ler cliente ou produto, precisa de joins com as dimensões.
Wide table · tudo numa tabela só
gold.vendas_wide1 linha por venda
data cliente produto canal valor
06-01Loja SilvaPlano ProInstagramR$ 1.234
06-01Café AuroraPlano LiteGoogleR$ 890
Sem joins, uma linha por evento. Ótima pra IA e exploração.
A terceira é consolidação: junta sistemas diferentes por uma chave comum. E Bronze Silver Gold é recomendação, não regra.
05
MÓDULO 05

Ativação e consumo

O último quilômetro: onde o dado vira decisão, ação e produto.
Panorama da ativação
Quatro formas de consumir
Linguagem natural
MCP
Agentes de IA perguntam e exploram os dados. Lê a camada semântica e responde em linguagem natural.
Programático
Data API
Apps e sistemas pedem a mesma tabela e recebem sempre a mesma resposta.
Reverse ETL
Destinations
As tabelas prontas pra consumo voltam pras ferramentas do time: HubSpot, planilhas, Slack.
Dashboards
BI
Looker, Metabase, Power BI leem as mesmas tabelas e montam os painéis.
Quatro portas, uma fonte de verdade só. Todas leem as mesmas tabelas prontas pra consumo.
Determinístico vs exploratório
Data API vs MCP
Data API · programático · determinístico
GET/v1/tables/gold.uso_por_conta?conta_id=c_5521
resposta
{
  "conta_id": "c_5521",
  "uso_mes": 1842,
  "limite": 5000
}
Um sistema pede, a mesma tabela responde igual toda vez.
MCP · linguagem natural · exploratório
Pessoa
Por que o uso caiu essa semana? E como fica por plano?
Agente
Lê a Camada Semântica, encontra as tabelas certas e responde em linguagem natural, sem você escrever SQL.
Uma pessoa pergunta, o agente descobre o caminho.
O caminho da pergunta
O caminho da pergunta até a resposta
PERGUNTA linguagem natural AGENTE Cliente de IA via MCP CAMADA GOLD tabelas prontas wide, confiáveis CAMADA SEMÂNTICA context documents, regras e definições RESPOSTA "Instagram, R$ 42 mil"
A pergunta entra em português, o agente lê Gold e Semântica via MCP, a resposta volta pronta.
Destinations · reverse ETL
O dado tratado de volta às ferramentas
Gold
gold.lead_score
Destination
sincroniza de volta
Ferramenta do time
HubSpot · Sheets · Slack
HubSpot · contato campo atualizado
empresaLoja Silva
lead_score87 · quente
portemédio
Ative onde o time já trabalha

O vendedor não abre o Lakehouse da Nekt. O score calculado no Gold aparece direto no card do HubSpot, onde ele já está.

BI · dashboards
Dashboards lendo o Gold
Receita por canal · junho dashboard
Instagram
R$ 42.000
Google
R$ 31.500
Orgânico
R$ 18.900
Email
R$ 11.700
Uma fonte, vários consumos

O mesmo gold.receita_por_canal que o agente lê alimenta o painel de BI. Ninguém recalcula, ninguém diverge.

Conecta Looker, Metabase ou Power BI ao Lakehouse da Nekt e o painel lê o Gold direto.
06
MÓDULO 06

Observabilidade e governança

Rodar com confiança, avisar antes do problema chegar e controlar quem vê o quê.
Quando algo falha
Leia o log e o resumo por IA
run #1 · falhou Runs
falha Source Meta Ads · 30/06 05:58 · 14s · 401 Unauthorized
Resumo do analista · gerado por IA
O que aconteceu
As credenciais da fonte expiraram e a fonte respondeu 401 Unauthorized. O run parou logo no início e nenhuma linha foi processada.
Ações recomendadas
1) Atualizar as credenciais  ·  2) Verificar permissões  ·  3) Reprocessar o pipeline
A primeira medida diante de uma falha: abrir o run e ler. A Nekt já explica o que houve e o que fazer.
Alertas
Avise antes do cliente perceber
#alertas-dados Slack
N
Nekt · sáb 08:02
Pipeline crítico falhou, painel de receita não atualizou. Fonte Meta Ads, 401. Resumo e ação no run #1.
Sem alerta
Sexta 23h falhou. Segunda 9h o cliente liga perguntando do painel.
Com alerta
Sábado 8h o time é avisado e resolve em 5 min, antes de qualquer um notar.
Configure nos pipelines críticos

Alerta por Slack ou email nas rotinas que alguém depende. O barato é avisar cedo.

Governança e permissões
Quem vê o quê Growth
Nível 01
Viewer
Vê e usa, read-only. Não edita nem deleta nada.
Nível 02
Editor
Tudo do Viewer, e edita e cria: descrições, fontes, queries e tabelas.
Nível 03
Manager
Tudo do Editor, e deleta o recurso e concede acesso a outros membros.
O elo com a IA

O agente enxerga exatamente o que o usuário do token enxerga. Token Scoped limita às tabelas escolhidas.

07
NA PRÁTICA

Playbooks por vertical

Os seis módulos montados end-to-end para a sua indústria.
Panorama
Um playbook pra cada tipo de negócio
Agência multi-tenant
Mídia e CRM por cliente
Fontes de cada conta consolidadas, isoladas e comparáveis.
SaaS / Produto
Churn, retenção, MRR
Cohorts, receita recorrente e sinais de saúde da base.
E-commerce
Pedidos e atribuição
Produtos, pedidos e a origem que trouxe cada venda.
Contabilidade
Consolidação financeira
Números de cada cliente padronizados numa base só.
Construção civil
Custo e avanço por obra
Orçado contra realizado, físico e financeiro por canteiro.
Imobiliárias
Funil e comissões
Carteira, funil de vendas e comissão por corretor.
Cenário · plataforma de gestão de academias
Exemplo: SaaS
gold.cohort_retencao retenção %
COHORT M0 M1 M2 M3
Jan 100 72 58 49
Fev 100 75 61 ·
Mar 100 78 · ·
Cada linha é uma safra de novos clientes, cada coluna um mês depois da entrada.
Valor SaaS
Um dashboard de cohort mostra quem fica e quem some, mês a mês. E um agente responde na hora: qual safra retém melhor e o que ela tem de diferente.
Cuidado

Churn conta só assinaturas que já pagaram ao menos uma vez. Trial cancelado não é churn.

Cenário · agência com 12 clientes
Exemplo: Agência
gold.consolidado_midia 1 tabela · N clientes
data cliente canal investimento leads
2026-06-01 Loja Silva Meta R$ 320 18
2026-06-01 Loja Silva Google R$ 410 22
2026-06-01 Café Aurora Meta R$ 280 15
2026-06-01 Café Aurora Google R$ 190 9
Meta e Google de cada conta, na mesma tabela, com colunas padronizadas.
Uma base, vários clientes, sem misturar.
Isolamento multi-tenant

Prefixo ou coluna por cliente garante que os dados nunca se misturam.

Mãos à obra
Seus dados já podem
virar valor hoje.
Conecte uma fonte, dê contexto, plugue o MCP e pergunte. O resto é evolução, no seu ritmo.
academy.nekt.com docs.nekt.com
Obrigado