Endpoint de API de Perguntas e Respostas de Documentos com PDF Vector RAG - Fluxo de trabalho n8n

• Desenvolvedores de IA e engenheiros de backend que precisam de um microsserviço RAG (Geração Aumentada por Recuperação) personalizado.


• Integradores de sistemas que constroem APIs de alta performance com o n8n.


• Usuários que buscam alavancar o nó n8n PDF Vector para consulta contextual de documentos.


• Aqueles que procuram templates n8n avançados para serviços web customizados.

Este fluxo de trabalho n8n especializado transforma uma simples requisição de processamento de documento em um serviço de API sofisticado e ciente do contexto. Ele resolve o desafio de fornecer respostas instantâneas e verificáveis baseadas no conteúdo de um documento específico, como PDFs ou artigos da web. Ao utilizar o poderoso nó n8n PDF Vector, o fluxo de trabalho analisa, vetoriza e consulta eficientemente o documento fornecido, mimetizando a lógica de uma base de conhecimento customizada. A arquitetura é projetada para confiabilidade, começando com uma etapa de validação robusta e terminando com uma resposta JSON padronizada, garantindo que este template n8n esteja pronto para produção. Todo esse processo é orquestrado pelo n8n, demonstrando sua capacidade muito além da simples automação de tarefas, permitindo que os usuários implementem rapidamente serviços web potencializados por IA.

Todo o processo é iniciado por uma chamada de API externa usando o gatilho Webhook do n8n. Este fluxo de trabalho n8n opera de maneira clara e linear:

1. Gatilho da API: O processo começa quando o gatilho Webhook do n8n recebe uma requisição POST no endpoint configurado /doc-qa. A requisição deve conter uma URL de documento e a pergunta do usuário.


2. Validação da Requisição: O primeiro nó Code do n8n, 'Validate Request', analisa o corpo JSON recebido. Ele garante que question e um identificador de documento (documentUrl ou documentId) estejam presentes, gerando um sessionId único e definindo uma flag booleana valid.


3. Verificação Condicional: O nó If do n8n 'Valid Request?' ramifica a execução. Se a requisição for inválida, o fluxo prossegue para 'Format Error Response'.


4. Processamento de IA (Caminho de Sucesso): Se for válida, o fluxo atinge o nó n8n 'PDF Vector - Ask Question'. Esta etapa crítica usa a URL do documento e o prompt do usuário para executar o RAG, extraindo a resposta contextual mais relevante.


5. Formatação da Resposta de Sucesso: Um nó Code subsequente do n8n pega a resposta gerada pelo PDF Vector, calcula um nível de confiança simulado e estrutura a saída JSON final rica, incluindo metadados de processamento e o ID da sessão.


6. Tratamento de Erros (Caminho de Falha): Se a validação da requisição falhar, o nó Code 'Format Error Response' compila os erros de validação em um JSON de erro limpo e estruturado.


7. Saída Final: Ambos os caminhos, sucesso e erro, convergem para o nó n8n 'Send Response' (Respond to Webhook), que envia imediatamente os dados JSON apropriados de volta ao cliente de origem, completando o ciclo da requisição da API.

Para implementar este template de fluxo de trabalho n8n completo, siga estes passos:

1. Importar: Copie todo o código JSON fornecido e importe-o diretamente para sua instância n8n usando o menu 'New' e selecionando 'Import from JSON'.


2. Configuração de Credenciais: O nó n8n 'PDF Vector - Ask Question' requer credenciais (geralmente uma chave de API para o serviço de IA subjacente, como OpenAI ou serviços de vetor similares). Certifique-se de que estejam configuradas de forma segura.


3. Ativação do Webhook: O gatilho Webhook do n8n está configurado para responder a requisições POST no caminho /doc-qa. Após salvar o fluxo de trabalho n8n, certifique-se de que ele esteja ativado (ative o interruptor no canto superior direito).


4. Testes: Teste a API enviando uma requisição POST para a URL do webhook da sua instância n8n, incluindo os parâmetros obrigatórios documentUrl e question no corpo JSON.

Webhook (Gatilho n8n): Nomeado 'Webhook'. Serve como ponto de entrada da API, configurado para o método POST no caminho /doc-qa. Ele escuta requisições externas de Q&A de documentos.
Code (nó n8n): Nomeado 'Validate Request'. Realiza a sanitização da entrada, verificando os parâmetros necessários (documentUrl e question) e definindo uma flag booleana para validade. É crucial para estabilizar o fluxo de trabalho n8n.
If (nó n8n): Nomeado 'Valid Request?'. Controla o fluxo, direcionando requisições válidas para o caminho de processamento de IA e requisições inválidas para o caminho de formatação de erro.
PDF Vector (nó n8n): Nomeado 'PDF Vector - Ask Question'. O componente de inteligência central. Ele processa a URL do documento fornecida na requisição e usa a lógica RAG para gerar uma resposta contextual à pergunta do usuário.
Code (nó n8n): Nomeado 'Format Success Response'. Lida com a transformação final dos dados, estruturando a resposta da IA, calculando um nível de confiança e empacotando-a em um formato JSON claro e amigável ao cliente.
Code (nó n8n): Nomeado 'Format Error Response'. Prepara uma resposta de mensagem de erro padronizada quando a validação inicial da requisição falha, garantindo uma experiência de API consistente.

• Respond to Webhook (nó n8n): Nomeado 'Send Response'. Este é o nó n8n terminal que envia imediatamente os dados JSON estruturados de volta ao cliente que iniciou o gatilho n8n.