Bases de conhecimento — API

Veja o guia conceitual em Bases de conhecimento.

Criar

POST /api/v1/knowledge-bases admin

Requisição

{
  "name": "Políticas de cobrança",
  "description": "Políticas internas e FAQ para o Assistente de Faturas.",
  "agent_id": 3
}

agent_id: null cria uma base global, disponível para todos os agentes.

Documentos

Endpoint	Papel	Descrição
POST /api/v1/knowledge-bases/{id}/documents	admin	Ingere um documento (título, conteúdo e URL de origem opcional). A plataforma indexa para busca semântica.
GET /api/v1/knowledge-bases/{id}/documents	leitor	Lista os documentos.
DELETE /api/v1/knowledge-bases/{id}/documents/{doc_id}	admin	Remove um documento.

Exemplo de ingestão

{
  "title": "Política de inadimplência",
  "content": "Faturas em aberto após 30 dias têm multa de 2% ao mês…",
  "source_url": "https://wiki.interna/cobranca/inadimplencia"
}

Busca semântica

POST /api/v1/knowledge-bases/{id}/query admin

Requisição

{ "query": "O que acontece quando uma fatura vence?", "top_k": 5 }

Resposta 200

{
  "results": [
    { "document_id": 12, "title": "Política de inadimplência", "chunk": "…", "score": 0.91 }
  ]
}