Mapeamento
Ligue campos de origem aos conceitos semânticos de negócio do Blocchi para que as métricas possam ser calculadas.
O mapeamento diz ao Blocchi o que seus dados de origem significam. Uma Opportunity do Salesforce, um negócio do HubSpot ou uma linha de planilha viram a mesma Oportunidade semântica depois de mapeados, então métricas, relatórios e agentes funcionam igual independentemente do provedor.
Visão do mapeamento (/app/data/mapping)
Veja a cobertura por fonte e dataset: quais entidades e atributos semânticos estão mapeados e quais dimensões estão prontas para análise. Abra o console técnico só quando precisar mudar algo.
Editando um mapeamento
Na página de uma fonte, abra Mapeamento (/app/data-sources/[connectionId]/mapping):
- Escolha a entidade semântica (por exemplo Conta, Pessoa, Oportunidade) e o objeto de origem.
- Associe os campos de origem aos atributos semânticos. O Blocchi sugere correspondências; você confirma.
- Revise a prontidão das dimensões — por exemplo 8 de 10 dimensões estão prontas para análise neste dataset.
- Salve. Métricas que dependiam do novo mapeamento passam a ser calculadas após a próxima sincronização.
Mapeamento semântico com IA
Depois de selecionar um dataset, o editor examina somente metadados do esquema da fonte e sugere entidades canônicas e associações de campos, com confiança, explicações e campos não mapeados. A IA não recebe registros de clientes nem amostras de planilhas, não altera a fonte nem aprova propostas silenciosamente.
- Revise a entidade sugerida e escolha outra se o significado de negócio for diferente (por exemplo, um cartão do Trello não é necessariamente uma oportunidade de venda).
- Clique em Preencher campos vazios para adicionar sugestões apenas aos campos ainda sem mapeamento. Associações manuais existentes são preservadas.
- Corrija ou remova sugestões e clique em Salvar para confirmar. O esquema da fonte é verificado novamente antes de registrar a aprovação.
- Se precisar de uma entidade específica do negócio, use Criar entidade customizada e defina nome e atributos com tipos. A definição pertence ao seu tenant, sem aparecer para outras organizações.
Para um dataset já mapeado, mudar a entidade é uma reclassificação governada. Confirme explicitamente. O Blocchi arquiva os mapeamentos anteriores para recuperação, limpa projeções antigas e exige um novo mapeamento e sincronização.
Prontidão e revisão contínua
O Blocchi registra uma impressão digital do esquema e uma assinatura das associações salvas. Uma alteração manual ou de esquema exige revisão. O monitor diário autenticado verifica metadados onde a credencial do tenant permite acesso em segundo plano; contas delegadas não são usadas nesse monitoramento.
Um mapeamento aprovado não significa que o Blocchi já tenha lido os registros. A ação Analisar qualidade e problemas aparece apenas após a aprovação atual e uma sincronização bem-sucedida que tenha armazenado registros reais.
Clientes de integração podem consultar propostas em modo de leitura por GET /api/v1/data-plus/semantic-mapping ou pela ferramenta MCP blocchi.propose_semantic_mapping. Aprovações e reclassificações exigem a permissão humana de configuração; o MCP não pode aprová-las.
Por que importa
A maioria dos estados de prontidão do Blocchi ("mapeie este campo para medir este bloco") aponta para cá. Nomes específicos de provedores nunca viram identificadores do produto: uma definição de métrica se refere a atributos semânticos, não a campos do provedor.
Relacionados
Última atualização em