Pular para o conteúdo
Camada semântica e contexto

Os modelos dão a cada pergunta as mesmas definições: datasets SQL com medidas, segmentos e relacionamentos. A IA escreve os modelos a partir de uma descrição e aprende enquanto você trabalha, e o seu time verifica o que vira referência.

Teste de 14 dias. Sem cartão de crédito.

Analytics para mais de 5000 times no mundo

Exa logoTiger Data logoPurpose logoGumloop logoComposio logoFullscript logoShiftrx logoDrata logoExa logoTiger Data logoPurpose logoGumloop logoComposio logoFullscript logoShiftrx logoDrata logo

Camada semântica

Um modelo é um dataset SQL com significado: descrições de colunas, medidas como a receita recorrente mensal, segmentos como assinaturas ativas, uma granularidade e joins com outros modelos. Pergunte sobre receita e a IA reutiliza essa lógica em vez de reconstruí-la a partir das tabelas brutas.

MRR by plan

Last 6 months

Show MRR by plan for active subscriptions. Built from the verified Subscriptions model.

Reused from the semantic layer

SUM(monthly_amount)
Measuremonthly_recurring_revenue
status = 'active'
Segmentactive_subscriptions
models.subscriptions
ModelSubscriptions

Criado com IA

Peça um modelo de atividade de clientes e o Basedash inspeciona o seu schema, escolhe as tabelas e os joins, escreve SQL no nível de linha, documenta cada coluna e adiciona as medidas e os segmentos. Visualize com dados reais, ajuste e siga em frente.

New model

Create a customer activity model and define active users as people who completed at least one session in the last 30 days.

Customer activity

Drafted by AI
  • Row-grain SQLone row per session
  • 7 columnsdescribed
  • Measureactive_users
  • Segmentactive_last_30_days
  • Default time columnoccurred_at
models.customer_activityPreview · 48,210 rows

Definições governadas

Cada alteração no SQL ou na semântica de um modelo salva uma versão que você pode restaurar. Admins verificam os modelos com a lógica aprovada, e qualquer edição remove o selo até uma nova revisão, então os agentes nunca confundem um rascunho com a métrica de referência.

History· Subscriptions

Changes in version 14

-- segment at_risk
−status = 'past_due'
+status IN ('past_due', 'unpaid')

Editing a segment removed verification until an admin reviews this version.

Uma única fonte da verdade

Toda superfície lê os mesmos modelos: chat, gráficos, dashboards, insights, automações, o editor SQL e agentes como Claude ou Cursor pelo servidor MCP. Já documenta tabelas no dbt? O Basedash também lê essas descrições direto do seu warehouse.

Dashboard · KPIs

$381,200

MRR · +5.2% vs. last month

Claude · Basedash MCP

MRR this month is $381,200, from the verified Subscriptions model.

#revenue · Weekly digest

MRR closed the week at $381,200. The Growth plan is up 4.5% this month.

monthly_recurring_revenue

Dentro de um modelo

Nenhuma linguagem de modelagem nova. Um modelo é SQL no dialeto da sua fonte, com os metadados e controles que um time de dados espera.

  • SQL puro

    Escrito no dialeto da sua fonte e consultado como models.nome.

  • Medidas e segmentos

    Agregações e filtros nomeados que a IA reutiliza em toda query.

  • Relacionamentos

    Joins muitos-para-um, um-para-um ou um-para-muitos, definidos uma vez.

  • Granularidade e sinônimos

    O que uma linha representa e como o time chama o modelo.

  • Histórico de versões

    Toda mudança de SQL ou semântica fica salva e pode ser restaurada.

  • Verificação por admin

    Os agentes preferem modelos verificados, e qualquer edição remove o selo.

  • Regras de acesso aplicadas

    Regras por linha e por objeto filtram o SQL e os metadados.

  • API REST

    Crie e atualize modelos a partir de scripts ou do CI.

Como a camada semântica funciona, como ela se encaixa com o dbt e quem controla as suas definições.

O que é a camada semântica do Basedash?

A camada semântica do Basedash é feita de modelos. Um modelo é um dataset SQL reutilizável sobre uma fonte de dados, com metadados semânticos: descrições e sinônimos de colunas, medidas como a receita recorrente mensal, segmentos como assinaturas ativas, uma coluna de tempo padrão, uma granularidade, orientações de uso e relacionamentos com outros modelos. Os modelos aparecem como tabelas virtuais somente leitura, consultadas pelo nome de referência, como models.subscriptions, e toda IA do Basedash recebe as definições e o status de verificação deles ao responder.

O Basedash funciona com dbt?

Sim, junto com ele. Conecte o warehouse onde o dbt constrói as suas tabelas e o Basedash consulta essas tabelas e views diretamente. As descrições de tabelas e colunas no warehouse, incluindo as que o dbt persiste lá, são lidas automaticamente como contexto para a IA. O Basedash não lê os arquivos de projeto do dbt, então os times costumam construir modelos sobre os seus marts do dbt para adicionar as medidas, os segmentos e os relacionamentos que os agentes usam, e podem gerenciá-los pelo CI com a API REST.

Como defino uma métrica como MRR ou usuários ativos?

Defina como uma medida em um modelo. Uma medida é uma expressão de agregação nomeada, como SUM(monthly_amount) para a receita recorrente mensal, e um segmento é um filtro nomeado, como status = 'active'. Mantenha o SQL do modelo no nível de linha, uma linha por assinatura por exemplo, e escolha uma coluna de tempo padrão para que a IA possa agrupar a métrica por dia, semana ou mês. Escreva tudo à mão, ou descreva a métrica e deixe a IA rascunhar o SQL, as medidas e os segmentos para você revisar.

Os modelos fazem transformação de dados?

Sim. O SQL de um modelo pode limpar, unir, renomear e remodelar tabelas brutas em datasets prontos para análise, e um modelo pode fazer join com outros modelos e tabelas da mesma fonte de dados. Cada modelo roda no dialeto SQL nativo da sua fonte. Para modelar ferramentas SaaS como Stripe e HubSpot juntas, sincronize-as no Basedash Warehouse, onde cada uma chega no próprio schema em uma mesma fonte, e construa os modelos por cima.

Por que os modelos deixam as respostas da IA mais precisas?

Sem modelos, uma IA reconstrói a lógica de negócio a partir das tabelas brutas a cada pergunta, e pequenas diferenças se acumulam: um filtro esquecido, um join errado, receita contada duas vezes. Com modelos, o Basedash entrega aos agentes as medidas, os segmentos, a granularidade, os relacionamentos, os sinônimos e o status de verificação de cada modelo. A IA reutiliza as expressões de medida no SELECT e as de segmento no WHERE, segue os relacionamentos declarados para evitar linhas duplicadas nos joins e prefere modelos verificados quando mais de um poderia responder.

Quem pode alterar um modelo e como as mudanças são revisadas?

Membros podem ver e editar modelos das fontes de dados que acessam, e as regras de acesso por linha e por objeto continuam filtrando o SQL e os metadados que cada pessoa vê. Toda mudança de SQL ou de metadados semânticos cria uma versão que você pode revisar e restaurar pelo histórico. Só admins da organização podem verificar um modelo, e editar o SQL, as colunas, as medidas, os segmentos ou a coluna de tempo padrão remove a verificação até que um admin revise a nova versão.

Qual a diferença entre modelos e skills?

Modelos guardam lógica executável: datasets SQL, medidas e segmentos que qualquer query pode reutilizar, para que os números sempre batam. Skills guardam critério: playbooks em linguagem natural, como o jeito que o financeiro reporta receita ou como ler um experimento, que a IA carrega quando um pedido precisa deles. A maioria dos times usa os dois: modelos para o que calcular e skills para como analisar e apresentar.

Conecte uma fonte, descreva sua primeira métrica e deixe a IA escrever o modelo.