Tecnologia

jsonW, formato de dados para IA: como guardar o que o modelo lê?

Para IA, o dado precisa de tipo exato, busca por significado e permissão. Veja como o jsonW guarda o que o modelo lê, sem base extra.

Por Equipe Wortic 6 min de leitura Atualizado em 15 de novembro de 2026

Guarde o dado em texto válido como JSON, com tipos exatos, e coloque os vetores de busca no mesmo arquivo. Assim o modelo lê só o que a permissão deixa ver, sem uma segunda base só para a busca. O jsonW segue essa ideia, e o README público diz que todo JSON válido é jsonW-texto válido.

jsonW, formato de dados para IA: como guardar o que o modelo lê?

Um modelo lê o que recebe. Se um preço chega como texto solto, 12,50 vira um número sem moeda, e um CNPJ que perdeu o zero à esquerda vira outro código. O README do jsonW usa esses mesmos casos como exemplo: o preço que virou texto, o código que perdeu o zero e o peso que ninguém sabe se era em gramas ou em quilos.

Por isso o jsonW tem tipos como dinheiro, decimal[2], medida[kg] e codigo. O valor carrega o que ele é, e o modelo não precisa adivinhar a unidade nem a moeda.

Como guardar vetores sem um banco separado?

Um vetor de embedding é uma lista de números que representa o sentido de um texto. No jsonW ele é um tipo de coluna, como vf16[768], que guarda cada número em 16 bits. Segundo o README, o vf16 reduz o tamanho à metade em relação ao float32.

A busca fica no próprio arquivo. Primeiro, grave os textos com o vetor:

wjsw de-texto 'id:i64,texto:texto,v:vf16[768]' chunks.jsonl chunks.jsw

Depois, peça as cinco linhas mais próximas por cosseno:

wjsw avaliar chunks.jsw cosseno v '<vetor da pergunta>' 5

Os termos e os filtros podem entrar no mesmo pedido, segundo o README. Quando os vetores têm tamanho variável, o número de dimensões pode ser omitido no tipo, e a matriz continua contígua no arquivo, segundo a referência do formato.

Como o modelo deixa de ver o que não deve ver?

A permissão roda no servidor, e não no navegador nem no prompt. Um leitor com credencial assinada só abre os blocos do cliente dele. Colunas marcadas como pessoais saem nulas quando a sessão não tem o escopo.

A referência do jsonW diz que o que a sessão não pode ver não sai do servidor. Isso importa para IA, porque um modelo só responde com o que recebeu. Se o dado sensível nunca chega ao contexto, ele não aparece na resposta.

Como o jsonW chega aos agentes e aos sistemas?

O README diz que os front ends em React, Vue, Svelte e Solid leem jsonW pela rota do servidor, porque o leitor roda onde estão os dados e as credenciais. Um arquivo guardado no R2 ou no S3 pode ser consultado sem baixar tudo: o leitor pede só os blocos necessários, por HTTP Range.

Segundo o mesmo README, a Wortic roda os próprios modelos de IA, o índice de agentes e a API de dados sobre o jsonW. É o uso que a empresa faz do próprio formato.

Na prática, a equipe grava o arquivo no servidor, o agente pede a consulta pela rota da aplicação, e o servidor devolve só as linhas que a sessão pode ver. O modelo nunca abre o arquivo por conta própria, e isso mantém a regra de permissão do lado de quem guarda os dados.

Por que manter vetor, dado e permissão no mesmo arquivo?

Quando o dado, o vetor de busca e a permissão ficam em três lugares, cada cópia pode sair de sincronia com as outras. Um arquivo com as três coisas evita a cópia, e a conferência fica num ponto só, com o comando conferir, que verifica o conteúdo inteiro.

Isso não elimina o cuidado com a origem dos dados. O jsonW guarda bem o que você grava, mas não decide se a informação está certa. Essa checagem continua com quem alimenta a base.

O que o jsonW não faz por você?

O jsonW não é um modelo de linguagem. Ele guarda, mede e busca. Os sinais de fala e de texto que ele calcula, segundo o README, não decidem nada: quem interpreta é o seu modelo. Um formato melhor não garante resposta melhor sozinho. A qualidade depende do que você coloca no contexto e de como o sistema usa esses dados.

Perguntas frequentes sobre formato de dados para IA

Preciso de um banco vetorial para guardar embeddings?

Quando os vetores ficam num arquivo que o seu sistema lê, o jsonW dispensa um banco vetorial separado para a busca por cosseno. Quando a busca precisa de um serviço próprio, avalie a alternativa antes de decidir. Não existe resposta única para todos os casos.

O jsonW foi feito só para IA?

Não. Os tipos de dinheiro, medida, código e tempo servem a sistemas de negócio, e o formato também guarda histórico e lotes em arquivo. A IA é um dos usos, ao lado dos outros.

Posso começar com um arquivo pequeno?

Sim. Um JSONL pequeno vira um arquivo .jsw com o comando de-texto, e o comando conferir confirma o resultado. Depois você cresce a base com o mesmo esquema, sem refazer nada.

Como um modelo lê um arquivo jsonW?

Pela ferramenta ou por um SDK, que devolvem as linhas em jsonW-texto, com o esquema declarado. O modelo recebe texto, e cada campo já vem com o seu tipo. Antes de servir os dados, convém conferir a integridade do arquivo com o comando conferir.

A página inicial da Wortic apresenta a empresa. Os planos estão na página de planos, o contato leva à equipe, a página de sistemas mostra os sistemas da empresa e a área para desenvolvedores reúne os caminhos de integração.

Perguntas frequentes

Preciso de um banco vetorial para guardar embeddings?

Quando os vetores ficam num arquivo que o seu sistema lê, o jsonW dispensa um banco vetorial separado para a busca por cosseno. Quando a busca precisa de um serviço próprio, avalie a alternativa antes de decidir. Não existe resposta única para todos os casos.

O jsonW foi feito só para IA?

Não. Os tipos de dinheiro, medida, código e tempo servem a sistemas de negócio, e o formato também guarda histórico e lotes em arquivo. A IA é um dos usos, ao lado dos outros.

Como um modelo lê um arquivo jsonW?

Pela ferramenta ou por um SDK, que devolvem as linhas em jsonW-texto, com o esquema declarado. O modelo recebe texto, e cada campo já vem com o seu tipo. Antes de servir os dados, convém conferir a integridade do arquivo.

Fontes

Conheça: jsonW (json Wondrous): o formato de dados da Wortic.

Quer isso funcionando na sua empresa?

Um consultor da Wortic olha o seu caso e mostra o caminho, sem compromisso.

Falar com um consultor

Equipe editorial

Equipe editorial da Wortic especializada em automacao, IA, ERP, CRM e crescimento operacional.

  • Automacao com IA
  • Gestao empresarial
  • CRM
  • ERP
  • Marketing digital

Isso funcionando no seu negócio.

Um consultor mostra o sistema do seu ramo, com a IA dentro.