Knowledge API

Busca semântica e gerenciamento de documentos via Qdrant (vector search) e PostgreSQL.

A Knowledge API expõe o produto Knowledge da strattum.ai: busca semântica sobre documentos indexados e listagem de documentos e chunks com metadados de proveniência.

Base URL

http://localhost:8003

Em produção, o endereço é configurado no deployment BYOC do cliente.

Autenticação

A versão 1.0 não exige autenticação — o acesso é controlado pela rede privada do cliente (VPC/VLAN). Autenticação via API key está prevista no roadmap.

Serviços de infraestrutura

Serviço	Papel
PostgreSQL 16	knowledge_documents e knowledge_chunks
Qdrant v1.9	Índice vetorial para busca por similaridade semântica
LLM Embeddings	Modelo configurado via LLM_EMBEDDING_MODEL (padrão: text-embedding-3-small)

Endpoints

POST /search

Busca semântica via embeddings — retorna chunks rankeados por similaridade coseno.

GET /documents

Lista todos os documentos indexados com paginação e filtros.

GET /documents/{doc_id}

Metadados + todos os chunks de um documento específico.

GET /documents/{doc_id}/chunks

Chunks de um documento ordenados por posição.