Especificações técnicas
Requisitos, recursos e limites da Aptabit Platform, versão 3.7.1.1
Sistema e implantação
- Sistema operacional
- Linux, em servidor físico ou máquina virtual
- Arquiteturas x86_64 e ARM64
Windows não é suportado. macOS apenas para desenvolvimento.
- Contêineres2
- Docker Engine com Compose v2 (instalação guiada)
- Podman, com suporte parcial e sem instalação guiada
- Serviços
Dez serviços em contêineres: proxy, web, API, worker, PostgreSQL, Redis, armazenamento de objetos compatível com S3, Milvus, etcd e um guardião isolado para o Docker.
- Dependências externas
PostgreSQL, Redis, armazenamento compatível com S3 e Milvus ou Zilliz podem ser os da própria instalação ou serviços já existentes na sua organização.
- Topologia
Um nó por instalação. Várias instalações isoladas podem conviver no mesmo servidor, cada uma com seus contêineres e sua rede.
- Rede
- Proxy HTTP em uma porta, 8080 por padrão
- TLS terminado no balanceador ou no proxy reverso da sua organização
- Compatível com proxies corporativos e inspeção TLS, com a CA da organização instalada no servidor
- Modos de operação3
- Online
- Totalmente offline, em rede isolada, com licença por arquivo
- Interface
- 9 idiomas, com tradução mais completa em português, inglês e espanhol
- Temas claro e escuro
- Logo, nome e cor da sua organização na tela de entrada e no menu
Hardware e aceleração
- Memória4
- Mínimo: 4 GiB
- Recomendado: 8 GiB
- Disco
- Mínimo: 10 GiB
- Recomendado: 50 GiB
- CPU
Executa a plataforma e os modelos locais somente com CPU, em x86_64 ou ARM64. A verificação da máquina indica o maior modelo do catálogo que cabe nela.
- GPU
- NVIDIA, via CUDA, com o driver e o NVIDIA Container Toolkit
- Intel integradas ou dedicadas, via OpenVINO
Sem o NVIDIA Container Toolkit, a plataforma sobe na CPU em vez de falhar.
- NPU
Inferência em NPU.
- Detecção
O painel do sistema mostra CPU, memória, discos e GPUs (NVIDIA, AMD, Intel e Apple), com a memória de vídeo.
- Verificação de compatibilidade
Antes de implantar um modelo, a plataforma confere o runtime, o hardware e a memória disponível e recusa combinações incompatíveis.
Modelos e runtimes
- Provedores em nuvem
OpenAI, Azure OpenAI, Anthropic e qualquer endpoint compatível com a API da OpenAI.
Chaves cifradas e teste de conexão.
- Runtimes locais gerenciados
vLLM, llama.cpp, OpenVINO Model Server, TensorRT-LLM, SGLang e IPEX-LLM, em contêineres isolados, com instalação, início, parada, reinício e remoção pelo painel.
IPEX-LLM ainda em validação.
- Servidores locais existentes
Ollama, vLLM e LM Studio em execução são detectados e conectados como endpoints compatíveis.
- Catálogo
Mais de 1.000 modelos abertos, em um catálogo curado filtrável por modalidade, família, quantização e runtime, com estimativa de compatibilidade com a máquina.
- Formatos de pesos
- GGUF
- OpenVINO IR
- safetensors (Hugging Face)
Cada formato é oferecido apenas aos runtimes que o executam.
- Quantizações
Q4_K_M, Q5_K_M, Q8_0, FP16, INT8 e INT4
- Habilitação
Modelos globais, habilitados por workspace, com modelos padrão para embeddings, reclassificação, visão e transcrição.
- Agentes
Modelo base local ou em nuvem, instruções de sistema, temperatura, máximo de tokens, penalidade de repetição, top-p e top-k. Rascunho, publicado ou arquivado, com acesso por workspace e por pessoa.
Dados e formatos
- Contextos de conhecimento5
- 41 extensões de arquivo
- Texto: txt, md, csv, tsv, json, xml, html e log
- PDF e Office: pdf, docx, xlsx e pptx
- Imagens, em 10 extensões, descritas por um modelo de visão
- Áudio, em 9 extensões, e vídeo, em 8, transcritos
- Busca
Híbrida: vetorial (Milvus) e textual (PostgreSQL), combinadas por Reciprocal Rank Fusion e reordenadas por um modelo de reclassificação.
Trechos de 900 caracteres, com 150 de sobreposição.
- Embeddings
Servidos localmente por modelos compatíveis com a API da OpenAI. Cada contexto fixa o seu modelo e pode ser reindexado.
- Contextos de dados
- Tipos: texto, inteiro, decimal, booleano, data, data e hora e JSON
- Chave primária, colunas pesquisáveis e rótulos de sensibilidade
- Carga de CSV, TSV ou XLSX até 100 MB, em acréscimo ou substituição, com as linhas rejeitadas e o motivo
- Consultas SQL
Somente leitura, em um papel de banco separado: uma instrução SELECT por vez, com tempo limite e até 1.000 linhas. Podem ser desligadas por contexto.
- Anexos no chat
Documentos, imagens, áudio e vídeo, até 100 MB por arquivo, com tipos e limites definidos pelo administrador.
- Arquivos gerados
.xlsx, .pptx, .pdf, .csv, .md e .txt
- Busca na web
Opcional, por mensagem: DuckDuckGo (padrão), Tavily ou Brave.
- Entrada por voz
Reconhecimento de fala do navegador ou um modelo de transcrição.
Fluxos
- Editor
Visual, com 13 tipos de bloco: Entrada, Decisão, Agente, Modelo de IA, Integração, Busca no armazenamento, Consulta de dados, Gravar dados, IA sobre linhas, Carregar arquivos, Transformar, Subfluxo e Saída.
- Saída estruturada
JSON Schema com enumerações fechadas e nível de raciocínio configurável nos blocos de IA.
- IA sobre linhas
Até 50 linhas por chamada e até 8 chamadas simultâneas.
- Subfluxos
Até 8 níveis de aninhamento.
- Ciclo de vida
Rascunho, publicado e arquivado, com contrato de entrada e de saída em JSON Schema.
- Execução
- Pelo chat
- Por endpoint HTTP, com token próprio de cada fluxo
- Por agendamento em intervalos a partir de 60 segundos, com entrada fixa, início e número máximo de execuções
- Rastro
Cada execução registra a entrada, as fontes consultadas com a relevância, as decisões e a saída de cada etapa.
- Templates de fluxo
30, em 6 áreas: crédito e risco (8), documentos e back-office (7), atendimento (5), compliance e jurídico (4), RH (3) e vendas (3).
- Portabilidade
Exportação e importação de fluxos em JSON.
Integrações
- Conectores prontos6
- Mais de 99. Exemplos por categoria:
- E-commerce: Amazon Selling Partner, Mercado Livre, Shopify, Meta Product Catalog e TikTok Shop
- Mensageria: WhatsApp Cloud API, Telegram, Twilio e Slack
- Produtividade: Microsoft 365 e Google Workspace
- ERP: TOTVS Protheus
- CRM: Salesforce
- Banco de dados: SAP HANA
- DevOps: Jira e Confluence
- ITOM: HPE OpsRamp
- Backup: Veeam
- Segurança: Netskope
- Dados de mercado: AwesomeAPI
- Conexões personalizadas
- REST e GraphQL, executadas nos fluxos
- Outros tipos, como banco de dados, transferência de arquivos e gRPC, ficam cadastrados com teste de conectividade
- Autenticação
Chave de API, bearer, básica, OAuth 2.0 client credentials e OAuth 2.0 refresh token, com renovação automática, além da opção sem autenticação.
Credenciais cifradas e decifradas apenas na execução.
- API de fluxos
Endpoint HTTP (POST) por fluxo publicado, com token bearer próprio, exibido uma única vez, guardado como hash e rotacionável, e lista de origens permitidas (CORS).
- Proteção
Chamadas de saída validadas contra SSRF e sem seguir redirecionamentos.
Identidade e acesso
- SSO
OIDC (Authorization Code com PKCE) com Microsoft Entra ID, Google Workspace ou qualquer provedor OIDC, como Keycloak, Okta e Auth0.
MFA pelo provedor de identidade. Política opcional de acesso somente por SSO.
- Regras por grupo
Grupos do diretório concedem administração, módulos e workspaces.
- Papéis
Proprietário (root), administrador e membro.
- Módulos
Concedidos por pessoa: Chat, Agentes, Armazenamento, Dados, Fluxos, Agendamentos e Integrações. Novos usuários começam sem nenhum.
- Workspaces
Um espaço pessoal para cada usuário e espaços compartilhados, com membros, modelos e agentes habilitados por espaço.
- Login local
- Senhas com no mínimo 12 caracteres, com hash Argon2
- Cookies de sessão HttpOnly e SameSite=Strict
- Bloqueio
Após 7 falhas por origem ou 30 por conta, por 15 minutos.
- Conta de emergência
Conta root com senha, nunca federada, recuperável no servidor com uma chave de uso único verificada offline.
Governança e auditoria
- Trilha de auditoria
Logins e falhas, usuários e workspaces, SSO e política de acesso, provedores e segredos, licença, conta root, consultas e cargas de dados, configurações com valores antes e depois e cada exclusão.
Não entra no expurgo automático e não pode ser editada nem excluída pela API.
- Registro de interações
Cada interação de chat, agente e fluxo, com conteúdo, modelo, workspace, usuário, tokens, latência e avaliação, com filtros.
- Proveniência
Modelo e fontes de cada resposta: documentos com a relevância, ou a consulta SQL com o número de linhas. Indicadores de respostas com fontes e de documentos indexados.
- Qualidade de dados7
Registro de irregularidades com plano de ação, relatório semestral e dicionário de dados legível por máquina, alinhados à Resolução Conjunta CMN/BCB nº 18/2025.
- Retenção
Opcional: expurgo de execuções de fluxo, mensagens e cargas de dados após o prazo definido. Sem política, os dados são mantidos. Cada exclusão fica registrada.
- Uso
Conversas, mensagens, tokens de entrada e de saída e avaliações, no total e por pessoa.
- Observabilidade
Logs estruturados em JSON, verificações /health e /ready e exportação de rastros e logs via OpenTelemetry (OTLP) para o coletor da sua organização.
- Segredos
XChaCha20-Poly1305 para chaves e credenciais. Cada instalação gera os próprios segredos e senhas de serviço.
- Isolamento do Docker
A API não tem acesso direto ao Docker do servidor. Um guardião isolado e sem rede permite apenas operações dos runtimes de modelo, sem contêineres privilegiados, montagens do servidor ou rede do host.
Operação e CLI
- CLI
Binário estático para Linux x86_64 e ARM64, inclusive RHEL 8, Ubuntu 20.04 e Debian 11, em português e inglês.
- Verificação
aptabit check: sistema, memória, disco, Docker e Compose, GPUs e NPUs, rede, relógio e proxy, com saída em JSON e modo offline.
- Instalação
aptabit install: verifica, configura e sobe a plataforma. Executar de novo atualiza a instalação existente e nunca apaga dados.
- Atualização
aptabit update: backup prévio, atualização em etapas com verificação de saúde e reversão automática se a nova versão falhar. Canais e fixação de versão.
- Backup
Cópias locais da configuração e dos volumes da instalação, com listagem, reversão e limpeza.
A plataforma para por alguns instantes durante a cópia. Serviços externos não entram no backup.
- Diagnóstico
Status em JSON, diagnóstico e pacote de suporte sem senhas, chaves ou tokens. Cada erro tem um código estável.
- Migrações
Aplicadas automaticamente ao iniciar a plataforma.
- Imagens
Registro privado com credenciais de curta duração vinculadas à licença e declaração de proveniência assinada em cada imagem do produto.
Licenciamento
- Cobrança
- Apenas pelos fluxos publicados em produção
- Sem cobrança por usuário, por token, por armazenamento ou por uso
- Licença
Por cliente, assinada digitalmente (Ed25519), com um par de chaves gerado em cada instalação.
- Modo online
Verificação pelo menos a cada 6 horas. Sem contato, a plataforma segue funcionando por até 7 dias, prazo padrão definido em cada licença.
- Modo offline
Arquivo de licença válido por até 120 dias, renovado da mesma forma. A instalação nunca contata a Aptabit.
- Dados enviados no modo online
Metadados da licença e da instalação. Conforme o nível de telemetria definido na licença, também contagens agregadas de uso, relatórios de falha do CLI sem senhas, chaves ou tokens e, no nível completo, um inventário do hardware e do ambiente. Nenhum documento, conversa, prompt ou arquivo.
- Vencimento
Carência de 7 dias por padrão. Uma licença vencida ou suspensa bloqueia o acesso, mas nunca apaga dados nem contêineres.
Precisa de mais detalhes técnicos?
Fale com a nossa equipe para planejar a instalação no seu ambiente.
Notas
- Especificações da versão 3.7.1. Podem mudar em versões futuras.
- O instalador guiado usa Docker Engine com Compose v2. O suporte a Podman é parcial.
- Em instalações isoladas, as imagens dos runtimes e os pesos dos modelos locais são transferidos à parte, ou o modelo é servido por um servidor de inferência compatível na rede local.
- Requisitos da plataforma. Cada modelo local acrescenta de 1 a 40 GB de memória e de disco, conforme o tamanho.
- PDFs digitalizados sem camada de texto não passam por OCR. Arquivos .doc, .xls e .ppt são aceitos, mas o texto deles não é extraído.
- Os fluxos executam chamadas HTTP (REST e GraphQL). Conexões de outros tipos, inclusive o conector de SAP HANA, oferecem cadastro e teste de conectividade.
- Recursos de apoio à conformidade. Não constituem certificação.
© 2026 NVIDIA, the NVIDIA logo, CUDA, and TensorRT are trademarks and/or registered trademarks of NVIDIA Corporation in the U.S. and other countries.