Conceitos

Esta página apresenta o vocabulário usado na plataforma e no restante da documentação.

Instalação e organização

Uma instalação é uma stack completa da Aptabit Platform em um servidor, com sua configuração, seus dados e sua identidade de licença. Cada instalação atende uma organização, criada no primeiro acesso.

Para separar ambientes ou unidades com isolamento completo, use instalações distintas. Várias instalações podem rodar no mesmo servidor, cada uma com seu projeto Compose, seus containers e sua rede.

Workspaces

O workspace é a unidade de trabalho dentro da organização:

• Pessoal: cada pessoa tem o seu.
• Compartilhado: criado por um administrador, com membros diretos ou vindos de grupos do diretório corporativo.

Contextos, fluxos, agendamentos e integrações são organizados por workspace. Um modelo só aparece no chat de um workspace depois de ser habilitado nele. O seletor de workspace fica na barra superior.

Papéis e módulos

O acesso combina três camadas:

• Papel: conta root (proprietária da instalação), administrador ou membro.
• Módulos por pessoa: Chat, Agentes, Armazenamento, Dados, Fluxos, Agendamentos e Integrações. Pessoas novas começam sem nenhum módulo.
• Escopo: participação em workspaces e acesso a cada agente e modelo.

Veja Usuários, papéis e acesso.

Contextos

Um contexto é onde ficam os arquivos e os dados que a plataforma usa:

• Conhecimento: documentos lidos, divididos em trechos e indexados para busca híbrida (semântica e lexical).
• Dados: tabelas tipadas, preenchidas por arquivo ou manualmente, consultadas por SQL somente leitura.
• Pessoal: a área fixa de cada pessoa com os arquivos que ela anexou no chat, visível só para ela.

Veja Armazenamento: conhecimento e dados.

Modelos e provedores

Um provedor externo é um serviço de modelos acessado por API: OpenAI, Azure OpenAI, Anthropic ou qualquer endpoint compatível com a API OpenAI. Um modelo local roda no seu servidor, em um runtime gerenciado pela própria plataforma ou em um servidor de inferência que você já opera. Veja Modelos, runtimes e aceleradores.

Agentes

Um agente combina um modelo base, instruções e parâmetros de geração, com acesso restrito a workspaces e pessoas. O conhecimento vem do contexto escolhido na conversa ou de um fluxo construído ao redor do agente. Veja Agentes.

Fluxos, contratos e execuções

Um fluxo é uma automação montada com blocos em um construtor visual. Seu contrato define a exposição (interno, API ou chat) e os esquemas JSON de entrada e de saída. Um fluxo passa de rascunho a publicado e só roda publicado.

Cada execução gera um registro de execução com origem, status, entrada, saída e o rastro de cada bloco. Veja Fluxos e agendamentos.

Agendamentos

Um agendamento executa um fluxo publicado em intervalo fixo (a partir de 60 segundos), com uma entrada JSON fixa, até um número máximo de execuções, se definido.

Integrações

Uma integração é uma conexão cadastrada com um sistema externo, com seus recursos e credenciais cifradas. Os fluxos a usam pelo bloco de integração. Veja Integrações.

Registros e proveniência

O registro unificado reúne cada interação de chat, agente e fluxo e os eventos de auditoria. A proveniência é o que cada resposta de IA guarda sobre sua origem: o modelo que a produziu e as fontes que a fundamentaram. Veja Governança e conformidade.

Licença

A licença é emitida pela Aptabit para a sua organização e validada online, por check-in, ou offline, por arquivo. Veja Licença e conectividade.