> ## Documentation Index
> Fetch the complete documentation index at: https://strattumai.mintlify.site/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

<CardGroup cols={2}>
  <Card title="POST /search" icon="magnifying-glass" href="/api-reference/knowledge/search">
    Busca semântica via embeddings — retorna chunks rankeados por similaridade coseno.
  </Card>

  <Card title="GET /documents" icon="folder-open" href="/api-reference/knowledge/list-documents">
    Lista todos os documentos indexados com paginação e filtros.
  </Card>

  <Card title="GET /documents/{doc_id}" icon="file-lines" href="/api-reference/knowledge/get-document">
    Metadados + todos os chunks de um documento específico.
  </Card>

  <Card title="GET /documents/{doc_id}/chunks" icon="list" href="/api-reference/knowledge/list-chunks">
    Chunks de um documento ordenados por posição.
  </Card>
</CardGroup>