Gerencie as bases (tabela, documento, FAQ, vetor) que alimentam os agentes de IA e os fluxos do AlliahFlow.
Quando o catálogo de produtos, a tabela de preços ou a lista de exceções mora numa planilha no computador de alguém, a automação herda todos os defeitos dessa planilha — e os multiplica pela velocidade da máquina.
A tabela que o fluxo consulta está no e-mail de uma pessoa, numa versão que ninguém sabe se é a última. Quando ela muda, nada avisa o processo que já está rodando com o valor antigo.
Sintoma · versão v3_final_ok.xlsxSem uma chave que defina o que é o mesmo item, a carga em massa duplica cliente, produto e contrato. Depois a duplicata aparece como divergência num relatório, meses depois.
Sintoma · dois cadastros do mesmo CNPJUm agente de IA sem fonte estruturada inventa a lacuna. Não é má-fé do modelo: é falta de um lugar único onde a resposta certa esteja escrita, tipada e consultável.
Sintoma · resposta plausível e erradaEstruture, controle e alimente o conhecimento dos seus agentes com bases tipadas e governança de dados.
Quatro formatos prontos para cada necessidade — cada um com seu esquema e colunas próprios.
Defina colunas-chave para garantir registros únicos e um rótulo (label) para identificar cada item da base.
Carga em massa via planilhas XLSX. Suba milhares de registros de uma vez e exporte sua base a qualquer momento.
Suas bases tornam-se contexto direto para os Agentes de IA e para os fluxos automatizados do AlliahFlow.
Cinco passos, sem nenhum deles exigindo alteração de banco, deploy ou ajuda de quem escreve código.
Nome técnico, rótulo de tela, tipo, obrigatoriedade e ordem. É aqui que se decide o que a base aceita — e, por consequência, o que ela nunca vai deixar entrar errado.
Quais colunas identificam o mesmo registro e qual expressão gera o nome legível. Sem esse passo a carga em massa não sabe distinguir atualização de duplicata.
Suba o CSV ou o XLSX, mapeie as colunas do arquivo para as da base e acompanhe o progresso. Ao final, confira o extrato: inseridos, atualizados e as linhas rejeitadas com o motivo.
Gere a credencial que o fluxo ou o agente vai usar para consultar. Ela aparece uma vez, é guardada como hash e pode ser revogada isoladamente depois.
Da tela, pela grade com filtros; do processo ou do agente, por GET paginado ou busca direta pela chave de unicidade. A partir daqui, atualizar o dado é atualizar a base — nada mais precisa mudar.
O que o recurso faz, por qual mecanismo ele faz e o que sobra na sua mão no fim.
Cada base declara as próprias colunas: nome técnico, rótulo de tela, tipo, obrigatoriedade e ordem. Não existe migração de banco para criar uma base nova — a definição das colunas é guardada como documento na própria base, e os registros vão para uma estrutura JSON indexada.
colunas (JSONB) e o registro em dados (JSONB), com índice GIN para consulta.Você escolhe quais colunas definem "o mesmo registro" — uma ou várias. A partir delas o sistema deriva uma chave normalizada, gravada com restrição de unicidade por base: a segunda tentativa de gravar o mesmo item atualiza em vez de duplicar. O rótulo é uma expressão sobre as colunas, e é ele que aparece quando outra base ou um agente cita aquele registro.
(base, chave); rótulo por expressão configurável.A carga aceita CSV e XLSX. O arquivo é lido, as colunas do arquivo são mapeadas para as colunas da base e o processamento roda em segundo plano, com status próprio. No fim, a importação registra quantas linhas entraram, quantas foram atualizadas e quantas falharam — com o motivo de cada linha rejeitada, não um "erro na importação" genérico.
PENDENTE, PROCESSANDO, CONCLUIDA, ERRO.Antes de gravar, cada valor passa pelo contrato da coluna: tamanho máximo em texto, precisão e escala em número, faixa mínima e máxima em número e em data, lista fechada de opções em ENUM, existência do registro apontado em FK_BASE e máscara em e-mail, URL, CPF e CNPJ. O que não passa vira erro identificado — na linha, com o nome da coluna.
tamanhoMaximo, min/max, opcoes, mascara, baseAlvoId.Os registros são listados com paginação e filtros por coluna, incluindo busca por chave. Quando uma coluna vira caminho quente de consulta — o CNPJ que todo agente procura, por exemplo — dá para criar um índice específico para ela e removê-lo depois, sem alterar a definição da base.
Registro excluído é marcado como inativo, não removido fisicamente: o histórico de quem consultou o quê continua fazendo sentido. A base inteira também pode ser desativada, saindo da lista de bases ativas sem perder nada — e uma base que está sendo usada não é apagada por engano.
A exportação devolve a base em XLSX escrevendo direto no fluxo de resposta, sem montar a planilha inteira na memória antes de enviar. É o que permite exportar uma base grande do mesmo jeito que se exporta uma pequena.
O tipo não é só um rótulo: é o contrato que decide o que pode ser gravado naquela coluna.
| Tipo | Guarda | Configuração disponível |
|---|---|---|
TEXTO | Cadeia de caracteres | Tamanho máximo e máscara (EMAIL, URL, CPF, CNPJ) |
NUMERO | Valor numérico decimal | Precisão, escala, mínimo e máximo |
DATA | Data sem hora | Data mínima e data máxima |
DATETIME | Data e hora com fuso | Limite inferior e superior de data e hora |
BOOLEAN | Verdadeiro ou falso | — |
ENUM | Um valor de uma lista fechada | Lista de opções com valor e rótulo |
FK_BASE | Referência a um registro de outra base | Base-alvo e coluna-alvo |
O AlliahBase é um serviço próprio, com banco próprio e API própria — não uma aba escondida dentro de outro produto.
base guarda a definição: nome, tipo, colunas, colunas de unicidade, rótulo e situação.base_registro guarda as linhas, particionada por base — cada base tem a sua partição, o que mantém a consulta previsível conforme o número de bases cresce.base_importacao guarda o histórico de cargas com contagens e o detalhe dos erros.POST na rota de importação da base./api/v1/base — criar, listar, listar ativas, detalhar, editar, ativar/desativar e excluir bases./api/v1/base/{id}/registros — listar, buscar, buscar por chave, criar, editar e desativar registros./api/v1/base/{id}/importacao e /exportar — carga em massa e download em planilha./api/v1/base/{id}/indices — criar, listar e remover índice de coluna.Toda entrada e toda saída passam pela mesma definição de colunas — o que evita que a planilha e a API discordem sobre o que é um registro válido.
A Alliah Base é a camada onde o conhecimento vive. Tudo o que os agentes consultam e tudo o que os fluxos automatizam começa em uma base bem estruturada — tipada, única e pronta para consumo.
O AlliahBase não substitui o seu ERP nem o seu CRM. Ele guarda a tabela de apoio que hoje vive numa planilha e que a automação precisa consultar dezenas de vezes por dia.
Faixa de desconto por perfil, prazo por região, exceções negociadas. São dados que mudam com frequência e que ninguém quer transformar em código toda vez que muda.
Ganho: a regra passa a ler um registro versionável em vez de um valor escrito dentro da automação.
O que o time pode responder, com a redação aprovada, e quais casos exigem escalonar. Uma base de perguntas e respostas com colunas próprias em vez de um documento colado no chat.
Ganho: uma fonte única para pessoa e agente responderem a mesma coisa.
A lista que todo formulário consulta para preencher um campo. Com chave de unicidade, importar a versão nova do catálogo atualiza o que existe em vez de duplicar tudo.
Ganho: a carga mensal deixa de ser um evento de risco.
Mapa de códigos entre dois sistemas, tabela de-para, lista de parceiros homologados. Coisas que não cabem em nenhum dos dois lados e acabam em planilha.
Ganho: o de-para vira endpoint consultável, com histórico de carga.
O que existe na tela, no arquivo e na API depois que a base está no ar.
A lista abaixo descreve mecanismos que existem no código. O que ainda não existe está na seção seguinte, não escondido aqui.
abk_…) e guardada apenas como hash — o valor original é mostrado uma vez, na emissão, e não é recuperável depois.Saber onde o produto termina custa menos do que descobrir na implantação.
Respostas curtas, com o comportamento real do produto.
Não. A base é criada pela tela ou pela API declarando as colunas; nada precisa ser alterado no banco. A definição das colunas e os valores dos registros ficam em estruturas JSON indexadas, e cada base ganha a própria partição de registros automaticamente.
Se a base tem chave de unicidade definida, a segunda carga atualiza os registros que já existem em vez de duplicá-los, e o extrato mostra quantos foram inseridos e quantos atualizados. Sem chave de unicidade definida, não há como o sistema saber o que é o mesmo item.
Não. A exclusão é lógica: o registro é marcado como inativo e continua no banco. O mesmo vale para a base inteira, que pode ser desativada e reativada sem perder conteúdo.
Pela API REST, autenticada por chave de API. As rotas de leitura cobrem listagem paginada, filtro por coluna e busca direta pela chave de unicidade — é essa última que serve para "me dê o registro do CNPJ X" sem varrer a base.
Entram CSV e XLSX pelo assistente de importação, além da criação registro a registro pela tela ou pela API. Sai XLSX na exportação e JSON na API.
Não. O processamento continua e o resultado separa o que entrou do que falhou: a importação guarda a contagem de inseridos, atualizados e erros, mais o detalhe por linha rejeitada, com o motivo. Você corrige as linhas apontadas e reenvia.
Pode. O tipo de coluna FK_BASE guarda a referência a um registro de outra base, configurando qual é a base-alvo e qual coluna dela identifica o registro. Na tela, o campo vira um seletor da base referenciada.
Não nesta versão. A consulta é estrutural: por coluna, filtro e chave. O tipo "vetor" existe como classificação de base, mas não há indexação por embeddings implementada.
Os registros são particionados por base, o que mantém cada consulta restrita à partição da base consultada. Além disso, há um índice geral sobre o conteúdo dos registros e a possibilidade de criar índices específicos para as colunas mais consultadas, criando e removendo pela API conforme o uso real.
Só o hash dela fica guardado. O valor legível aparece uma única vez, no momento da emissão — depois disso, uma chave perdida é substituída, não recuperada. Nenhuma chave vem pré-criada na instalação.
Os termos que aparecem na tela e o que cada um significa aqui dentro.
Crie suas primeiras bases, importe seus dados e dê aos seus agentes o contexto que eles precisam.
Acessar AlliahBase