> ## Documentation Index
> Fetch the complete documentation index at: https://docs.strattum.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://docs.strattum.ai/api-reference/knowledge/search)**
>
> Busca semântica via embeddings — retorna chunks rankeados por similaridade coseno.

> **[GET /documents](https://docs.strattum.ai/api-reference/knowledge/list-documents)**
>
> Lista todos os documentos indexados com paginação e filtros.

> **[GET /documents/\{doc\_id}](https://docs.strattum.ai/api-reference/knowledge/get-document)**
>
> Metadados + todos os chunks de um documento específico.

> **[GET /documents/\{doc\_id}/chunks](https://docs.strattum.ai/api-reference/knowledge/list-chunks)**
>
> Chunks de um documento ordenados por posição.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.