Skip to content

Backend

PT | EN

A infraestrutura de backend do Vectora foi projetada para resolver o maior gargalo dos agentes de IA modernos: a gestão de estado em escala. Enquanto o runtime do Vectora processa a inteligência, o backend garante que essa inteligência seja fundamentada em dados persistentes, seguros e buscáveis.

O Vectora utiliza uma arquitetura unificada baseada em MongoDB Atlas, permitindo que vetores, metadados e memória operacional coexistam no mesmo ecossistema.

O Motor por Trás do Contexto

Tópicos desta seção

PáginaDescrição
MongoDB AtlasPor que escolhemos o Atlas e como ele serve como nossa fundação de dados.
Busca VetorialMergulho técnico em embeddings, similaridade de cosseno e o algoritmo HNSW.
Persistência e MemóriaComo o Vectora mantém o estado entre sessões e constrói a memória de longo prazo (AGENTS.md).

Visão Geral da Arquitetura

O backend do Vectora não é apenas um local de armazenamento; é uma extensão do Harness Runtime.

    graph TD
    A[Vectora Runtime] --> B{Service Layer}
    B --> C[Vector Service]
    B --> D[Session Service]
    B --> E[Audit Service]

    subgraph "MongoDB Atlas (Gerenciado pela Kaffyn)"
        C --> F[(Documents & Vectors)]
        D --> G[(Operational State)]
        E --> H[(Audit Logs)]
    end
  

Princípios de Backend

  1. Isolamento por Namespace (RBAC): O backend impõe limites rígidos. Dados de um projeto nunca se misturam com outros, garantindo privacidade multi-tenant.
  2. Atomicidade: Vetores e metadados de código são armazenados juntos. Se um arquivo é atualizado, o índice vetorial e o documento são atualizados simultaneamente.
  3. Escalabilidade Transparente: Usando MongoDB Atlas, o Vectora escala de pequenos projetos individuais a codebases corporativas com milhões de linhas de código sem perda de performance.
  4. Governança Ativa: Cada interação é persistida e auditável, permitindo transparência total sobre as ações da IA.

Modos de Backend

ModoDescriçãoUso Ideal
Gerenciado (SaaS)Backend MongoDB Atlas provisionado pela Kaffyn. Zero configuração.Planos Free, Pro e Team.
Híbrido (BYOK)Você fornece as chaves de API do Voyage, mas o Atlas é gerenciado pela Kaffyn.Controle de custo de API com facilidade infra.
Enterprise / CustomConexão com seu próprio cluster MongoDB Atlas ou infraestrutura on-premise.Requisitos rígidos de soberania de dados.

Perguntas Frequentes

P: Onde meus vetores ficam armazenados fisicamente? R: Nos clusters do MongoDB Atlas gerenciados pela Kaffyn, geralmente localizados em regiões AWS ou Google Cloud de baixa latência.

P: Meus dados de backend são usados para treinar modelos da Kaffyn? R: Não. Seguimos uma política estrita de privacidade. Seus vetores e metadados são de sua propriedade exclusiva e usados apenas para fornecer contexto ao seu agente.

P: O backend é necessário para o modo offline? R: O Vectora permite caching local de alguns metadados, mas a busca vetorial semântica completa e a memória persistente de longo prazo dependem da conectividade com o backend.


External Linking

ConceptResourceLink
MongoDB AtlasAtlas Vector Search Documentationwww.mongodb.com/docs/atlas/atlas-vector-search/
MCPModel Context Protocol Specificationmodelcontextprotocol.io/specification
MCP Go SDKGo SDK for MCP (mark3labs)github.com/mark3labs/mcp-go
RBACNIST Role-Based Access Control Standardcsrc.nist.gov/projects/rbac
RAGRetrieval-Augmented Generation for Knowledge-Intensive NLParxiv.org/abs/2005.11401
HNSWEfficient and robust approximate nearest neighbor searcharxiv.org/abs/1603.09320

Frase para lembrar: “O runtime é o cérebro; o backend é a biblioteca. Sem uma biblioteca organizada, o cérebro não tem onde buscar as respostas.”


Parte do ecossistema Vectora · Open Source (MIT) · Contribuidores