Sprints #904
Aberta
Documentação #901: ÉPICA 04: Integrações e Mensageria
Sprint 13 — Integração com LLMs e Criação das Credenciais N8N
0%
Descrição
Endpoints da API: Utilizaremos a URL https://evolution.ftsflows.com.br diretamente no backend.
Criptografia: Mesmo em modo Stateless, as instâncias locais no n8n precisam de segurança. Utilizaremos o Header apikey dinâmico.
- Validar as credencias inseridas
- Criar credencial no N8N correspondente a LLM
Atualizado por Rodrigo Admin há 7 dias
- Título alterado de Sprint 13 — Atividades de frontend para Sprint 13 — Integração com n8n
- Descrição atualizado(a) (diff)
- Categoria ajustado para Backend
- Atribuído para ajustado para Rodrigo Admin
Atualizado por Rodrigo Admin há 6 dias
- [Phase 1] Integração com n8n
Endpoints da API: Utilizaremos a URL https://evolution.ftsflows.com.br diretamente no backend.
Criptografia: Mesmo em modo Stateless, as instâncias locais no n8n precisam de segurança. Utilizaremos o Header apikey dinâmico.
Proposed Changes (Para a Sessão Atual)
Finalizar a modelagem de dados no backend.
Desenvolver o driver completo para Evolution API.
Atualizado por Rodrigo Admin há 4 dias
- Título alterado de Sprint 13 — Integração com n8n para Sprint 14 — Integração com n8n
Atualizado por Rodrigo Admin há 4 dias
- Título alterado de Sprint 14 — Integração com n8n para Sprint 13 — Integração com LLMs e Criação das Credenciais N8N
- Descrição atualizado(a) (diff)
Atualizado por Rodrigo Admin há 3 dias
Walkthrough — Sprint 13: Integração com LLMs e Credenciais N8N
Nesta sprint, implementamos a base para integrar serviços de IA ao FTSAssistants, garantindo segurança na persistência de chaves e automação na configuração do n8n.
Mudanças Principais
Backend (NestJS & Prisma)
Validação de Tokens: Criamos o LlmService que valida chaves da OpenAI e Anthropic em tempo real consultando seus endpoints oficiais de modelos.
Segurança: Expandimos o modelo Integration com o campo encryptedData. As chaves de API são criptografadas via AES-256-GCM antes de serem salvas no banco.
Automação N8N: O N8nService agora cria automaticamente credenciais do tipo openAiApi e anthropicApi no cofre do n8n sempre que uma integração é salva.
Endpoints:
POST /integrations/llm/test: Para testes instantâneos no frontend.
POST /integrations/llm/save: Para persistência e sincronização com n8n.
Frontend (Flutter)
IntegrationsRepository: Implementação da camada de dados para comunicação com os novos endpoints de LLM.
Bot Wizard (Passo 2):
Substituímos a lógica simulada por chamadas reais à API.
Adicionamos suporte ao provedor Anthropic.
Implementamos feedback visual de "Testando conexão" e sucesso/erro.
O salvamento da chave agora ocorre de forma transparente ao avançar no wizard.
Verificação e Testes
Testes Automatizados (Backend)
Executamos as suítes de teste unitário para garantir a integridade dos payloads e do tratamento de erros:
llm.service.spec.ts: PASS (3 testes)
n8n.service.spec.ts: PASS (9 testes, incluindo novos casos de LLM)
Demonstração Técnica
TIP
No Passo 2 do Wizard, ao selecionar "OpenAI" ou "Anthropic", o usuário pode clicar no ícone de raio (⚡) para validar sua chave. Somente chaves válidas são persistidas no sistema.
Sprint 13 concluída com sucesso. O sistema está pronto para a Sprint 14 (OAuth2/Google).