n8n-nodes-rag-api

Custom n8n nodes para integração com RAG API - Busca semântica com dropdown de tabelas.

Novidades v1.2.0

• Dropdown de Tabelas - Selecione a tabela diretamente no node (carrega automaticamente da API)
• Autenticação simplificada - Use apenas o API Token (não expira)
• Sem limite de resultados - Retorna todos os documentos por padrão
• Nova rota GET - Query via URL path para melhor integração

Nodes Incluídos

| Node | Descrição | |------|-----------| | RAG Consulta | Busca semântica com dropdown de tabelas | | RAG Upload | Upload de arquivos (PDF, DOCX, TXT, imagens) | | RAG Ingestão | Ingerir documentos via JSON | | RAG Pastas | Gerenciar tabelas (criar, listar, deletar) | | RAG Arquivos | Gerenciar arquivos enviados |

Instalação

Opção 1: npm Link (Desenvolvimento)

cd n8n_nodes
npm install
npm run build
npm link

# Na pasta do n8n
npm link @stg_digital/n8n-nodes-rag-api

Opção 2: Docker

COPY n8n_nodes /home/node/.n8n/custom/n8n-nodes-rag-api
RUN cd /home/node/.n8n/custom/n8n-nodes-rag-api && npm install && npm run build

Opção 3: Instalação Local

# Copie para a pasta custom do n8n
cp -r n8n_nodes ~/.n8n/custom/n8n-nodes-rag-api
cd ~/.n8n/custom/n8n-nodes-rag-api
npm install && npm run build

Reinicie o n8n após a instalação.

Configuração

1. Criar Credencial

1. No n8n: Credentials → New Credential → RAG API
2. Configure:
   • URL Base: http://seu-servidor:8000
   • API Token: Seu token (encontre em API Docs no painel)

O API Token não expira e é usado automaticamente em todas as requisições.

2. Usar os Nodes

Os nodes carregam automaticamente as tabelas disponíveis quando você configura a credencial.

Uso

RAG Consulta (Busca)

O node principal para buscar documentos.

┌─────────────────────────────────┐
│ Tabela: [Carros (150 docs)]  ▼ │  ← Dropdown automático
│ Consulta: carros até 100 mil   │
│                                 │
│ Opções: (opcional)              │
│   Limite: 0 (sem limite)        │
│   Score Mínimo: 0               │
└─────────────────────────────────┘

Saída:

{
  "folder": "Carros",
  "query": "carros até 100 mil",
  "total_results": 25,
  "query_time_ms": 234,
  "results": [
    {
      "content": "Honda Civic 2020 - R$ 95.000...",
      "score": 0.89,
      "metadata": {
        "source": "catalogo.pdf",
        "fileUrl": "/api/files/abc123",
        "isImage": false
      }
    }
  ]
}

RAG Upload

Upload de arquivos com processamento automático.

┌─────────────────────────────────┐
│ Tabela: [Carros (150 docs)]  ▼ │
│ Tipo: Dados Binários            │
│ Propriedade: data               │
└─────────────────────────────────┘

Tipos suportados: PDF, DOCX, TXT, JSON, imagens.

RAG Ingestão

Ingerir documentos via JSON (ideal para dados estruturados).

┌─────────────────────────────────┐
│ Tabela: [Produtos (50 docs)] ▼ │
│ Tipo: Documento Único           │
│ Conteúdo: {{$json.descricao}}   │
│ Metadados: {"preco": 100}       │
└─────────────────────────────────┘

RAG Pastas

Gerenciar tabelas/coleções.

• Listar Todos - Lista todas as tabelas com contagem de docs
• Criar - Cria nova tabela
• Deletar - Remove tabela e todos os documentos
• Obter Info - Informações de uma tabela

RAG Arquivos

Gerenciar arquivos enviados.

• Listar - Todos os arquivos
• Listar por Tabela - Arquivos de uma tabela específica (dropdown)
• Obter - Baixar arquivo por ID
• Deletar - Remover arquivo

Exemplo de Fluxo

[Trigger] → [RAG Consulta] → [AI Agent] → [Responder]
                 ↓
         "carros até 100k"
                 ↓
         [25 resultados com
          imagens + descrições]
                 ↓
         [Agent monta resposta
          para o cliente]

API Reference

| Endpoint | Método | Node | |----------|--------|------| | /api/query/:folderId | GET | RAG Consulta | | /api/query | POST | RAG Consulta | | /api/upload | POST | RAG Upload | | /api/admin/ingest | POST | RAG Ingestão | | /api/admin/folders | GET, POST | RAG Pastas | | /api/admin/folders/:name | GET, DELETE | RAG Pastas | | /api/files | GET | RAG Arquivos | | /api/files/folder/:id | GET | RAG Arquivos | | /api/files/:id | GET, DELETE | RAG Arquivos |

Autenticação

Todas as requisições usam o header X-API-Key automaticamente:

X-API-Key: seu-api-token

O token é obtido no painel da aplicação (API Docs) e não expira.

Changelog

v1.2.0

• Dropdown de tabelas carregado automaticamente da API
• Autenticação via X-API-Key (token não expira)
• Query sem limite por padrão (retorna todos os resultados)
• Nova rota GET /api/query/:folderId
• Removido campo JWT das credenciais

v1.1.0

• Suporte a upload de arquivos
• Gerenciamento de arquivos
• Múltiplos tipos de entrada na ingestão

v1.0.0

• Release inicial
• Nodes básicos: Query, Ingest, Folders

License

MIT