Voltar para Aprenda

Aptabit Platformv3.7

Administração

Governança e conformidade

Registro unificado, auditoria, proveniência, qualidade da informação, retenção e LGPD.

Nesta página

A Aptabit Platform registra o que acontece na instalação e de onde vem cada resposta de IA, para que a organização demonstre rastreabilidade, qualidade da informação e controle sobre seus dados.

Registro unificado

Em Configurações > Logs, um único registro reúne:

  • cada interação de chat, de agente e de fluxo, com conteúdo, modelo, workspace, pessoa, tokens, latência e avaliação;
  • os eventos de auditoria da instalação.

O registro tem filtros por pessoa, workspace, modelo, origem, evento, severidade, texto e período. A mesma aba mostra o uso por pessoa: conversas, mensagens, tokens de entrada e de saída, avaliações, arquivos, armazenamento, fluxos, execuções e agentes.

Trilha de auditoria

A trilha fica no PostgreSQL e registra organização, workspace, pessoa, sessão, IP de origem, recurso, severidade e metadados. Entre os eventos auditados:

  • logins, falhas de login e logouts;
  • mudanças em pessoas, workspaces, SSO e modo de login;
  • mudanças em segredos e provedores, com valores anteriores e posteriores nas configurações sensíveis;
  • instalação de licença, bloqueio e recuperação da conta root;
  • consultas e cargas de dados;
  • exclusão de documentos, conversas, contextos e tabelas, com o que foi excluído e por quem;
  • mudanças na retenção e na exportação de telemetria.

Os eventos de auditoria não são apagados pelos expurgos de retenção e não podem ser editados nem excluídos pela API. O banco de dados não impõe imutabilidade técnica; restrinja o acesso administrativo ao PostgreSQL conforme a política da organização.

Proveniência das respostas

  • Cada resposta do chat guarda o modelo que a produziu e as fontes que a fundamentaram: documentos com pontuação ou o SQL com o número de linhas.
  • O inspetor do chat mostra a solicitação exata enviada ao modelo.
  • Cada execução de fluxo guarda o rastro de cada bloco, da entrada à saída.

Em Configurações > Governança, dois indicadores acompanham a cobertura: a parcela de respostas com fontes registradas e a parcela de documentos com indexação semântica.

Qualidade da informação

Os recursos desta seção estão alinhados à Resolução Conjunta CMN/BCB nº 18/2025, que dispõe sobre a política de qualidade das informações prestadas na esfera de atuação do Banco Central do Brasil.

Registro de irregularidades

O registro é preenchido automaticamente, por exemplo quando uma entrada viola o contrato de um fluxo ou quando uma carga de dados rejeita linhas. Cada irregularidade tem categoria (validation, provenance, embedding e outras), status (open, acknowledged ou resolved) e plano de ação.

Dicionário de dados

O dicionário descreve as entidades reguladas que a plataforma manipula (documents, document_chunks, flow_runs, chat_messages, audit_events e data_quality_irregularities), seus campos relevantes e as dimensões de qualidade que sustentam: acurácia, completude, rastreabilidade, tempestividade, integridade, consistência e governança.

Endpoints de governança

Disponíveis para sessões de administrador:

Texto
GET  /api/v1/admin/data-quality/dictionary
GET  /api/v1/admin/data-quality/irregularities
POST /api/v1/admin/data-quality/irregularities/:id/resolve
GET  /api/v1/admin/data-quality/report

O relatório agrega as irregularidades por status e categoria, a cobertura de proveniência das respostas de IA e a indexação dos documentos, como base para o relatório semestral.

A plataforma não é, por si, instituição autorizada pelo Banco Central do Brasil. Esses recursos permitem que a instituição regulada que a utiliza demonstre rastreabilidade, acurácia e governança sobre os dados gerados e processados nela.

Retenção e exclusão

  • A retenção é opcional e definida por organização: execuções de fluxos, mensagens de chat e cargas de dados podem ser expurgadas automaticamente após um número de dias.
  • Por padrão, nada é expurgado.
  • A trilha de auditoria não entra nos expurgos.
  • Cada exclusão de documentos, anexos, contextos, conversas e tabelas fica registrada: o que foi excluído e por quem.

LGPD

  • Residência: conteúdo, dados e embeddings ficam nos bancos e no armazenamento da instalação.
  • Minimização: retenção com expurgo automático, módulos concedidos por pessoa e workspaces separados.
  • Rastreabilidade: exclusões registradas e proveniência das respostas.
  • Anonimização: o template de fluxo "Anonimização de dados (LGPD)" usa um modelo de IA para mascarar dados pessoais; revise o resultado conforme o risco do caso.
  • Rótulos: a classificação de documentos e a sensibilidade de colunas organizam o acervo; o controle de acesso é feito por módulo, workspace e compartilhamento.

Esses recursos apoiam o programa de conformidade da organização; não substituem a avaliação jurídica nem constituem certificação.

Exportação para observabilidade

Em Configurações > Logs, configure a exportação de traces e logs por OpenTelemetry (OTLP) para o coletor da organização, como Grafana Tempo, Jaeger ou Datadog. A conexão tem teste e passa a valer no próximo reinício. A exportação vem desligada por padrão.

Documentaçãov3.7