Knowledge Base (RAG)

A Knowledge Base permite que seus agentes respondam com base em conteúdo real do seu negócio, usando RAG (Retrieval-Augmented Generation).

Fontes Suportadas

Tipo	`source_type`	Descrição
Arquivo PDF/DOCX	`file`	Upload de documentos
URL / Site	`url`	Extrai conteúdo de uma página web
YouTube	`youtube`	Transcreve vídeos automaticamente

Criar uma Fonte

curl -X POST https://api.mex.aillom.com.br/api/knowledge-base \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "FAQ do Produto",
    "source_type": "url",
    "source_url": "https://suaempresa.com.br/faq"
  }'

Status de Processamento

Após criar, a fonte é processada em background (vetorização):

Status	Descrição
`pending`	Aguardando processamento
`processing`	Sendo vetorizado
`processed`	Pronto para uso
`error`	Falha no processamento

# Verificar status
curl https://api.mex.aillom.com.br/api/knowledge-base/{id} \
  -H "Authorization: Bearer SEU_TOKEN"

Vincular ao Agente

curl -X POST https://api.mex.aillom.com.br/api/agents/{agent_id}/knowledge-bases \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "knowledge_base_id": "uuid-da-kb" }'

Listar Fontes do Agente

curl https://api.mex.aillom.com.br/api/agents/{agent_id}/knowledge-bases \
  -H "Authorization: Bearer SEU_TOKEN"

:::info Um agente pode ter múltiplas fontes de conhecimento. O sistema busca automaticamente nos documentos mais relevantes para cada pergunta. :::