Assistente Virtual de Gestão de Processos (n8n & IA)

Um agente autônomo capaz de gerenciar processos, manipular bancos de dados e gerar documentação técnica (PDD) via chat.

Este projeto implementa uma arquitetura de Agente de IA utilizando n8n self-hosted ou nuvem. Ele atua como um consultor virtual, interpretando linguagem natural para realizar operações de CRUD em tabelas do n8n e orquestrar a criação de PDFs complexos.

---

Funcionalidades

• Chatbot : Interpreta a intenção do usuário e decide qual ferramenta acionar.
• CRUD via Chat : Criação, Leitura, Atualização e Deleção de registros na base de dados (n8n Tables) usando linguagem natural.
• Geração de PDD : Sub-workflow dedicado que transforma dados brutos do processo em um documento PDF profissional e formatado.
• slack Integração Slack : Convera, execução de CRUD e Entrega automática dos documentos gerados diretamente em canais do Slack.

---

Tech Stack

• Orquestração: n8n (Self-hosted via Docker) ou via nuvem
• LLM (Cérebro): OpenAI Chat Model(4.1 mini) e como Fallback Google Gemini (1.5 Flash/Pro)
• Database: n8n Tables (Nativo)
• PDF Engine: PDFShift.io (HTML para PDF)
• Mensageria: n8n Chat ou Slack API

---

Pré-requisitos

Antes de começar, certifique-se de ter instalado em sua máquina:

• Docker & Docker Compose
• Git

---

Instalação e Execução (Passo a Passo)

Siga os comandos abaixo no seu terminal para subir o ambiente localmente.

1. Clonar o Repositório

git clone [https://github.com/seu-usuario/seu-repositorio.git](https://github.com/seu-usuario/seu-repositorio.git)
cd seu-repositorio

2. Subir o Ambiente n8n

O projeto já inclui um arquivo docker-compose.yml configurado. Execute:

docker-compose up -d

Aguarde alguns instantes enquanto o Docker baixa as imagens e inicia o serviço.

3. Acessar o Editor

Abra seu navegador e acesse: http://localhost:5678

• Usuário/Senha: Definidos no seu docker-compose.yml (Padrão sugerido: admin / senha configurada).

---

Configuração do n8n (Pós-Instalação)

Como o n8n não exporta credenciais por segurança, você precisará configurar o ambiente manualmente após o login.

1. Importar os Workflows

No editor do n8n:

1. Vá em Workflows > Import from File.
2. Selecione os arquivos .json presentes na pasta deste projeto:
   • Main Workflow.json (O Agente Principal)
   • Sub_workflow_gerar_PDD_pdf.json (O Gerador de Documentos)

2. Configurar Credenciais

Você precisará criar as seguintes credenciais no menu Credentials do n8n:

Serviço	Configuração Necessária
Google Gemini	API Key do Google AI Studio (PaLM/Vertex).
Slack API	OAuth2. Escopos obrigatórios: chat:write, files:write.
PDFShift	API Key no Header x-api-key do nó HTTP Request.

3. Configurar a Base de Dados (n8n Table)

1. No n8n, vá para o menu Tables.
2. Crie uma nova tabela chamada Base Avanade.
3. Adicione as colunas esperadas pelo Agente:
   • id (Number/Auto-increment)
   • nome_processo (Text)
   • departamento (Text)
   • sistemas_alvo (Text)
   • descricao_do_sistema (Text)
   • excecoes_negocio (Text)
   • tipo_de_regra (Text)
   • condicao_da_regra (Text)

---

🧠 Como Usar

Com os workflows ativos (Active), abra o chat de testes no Main Workflow e interaja naturalmente.

Exemplos de Prompts:

• Listar: "Quais processos estão cadastrados?"
• Detalhar: "Me dê os detalhes do processo de ID 1."
• Atualizar: "Mude o Sistema do processo de Onboarding para 'Google'."
• Gerar PDD: "Gere o PDD do processo em ID 2." (Isso acionará o sub-workflow e enviará o PDF no Slack).

---

📂 Estrutura de Arquivos

/
├── docker-compose.yml                # Configuração do container n8n
├── Main Workflow.json                # Lógica para consulta do Chatbot e Roteamento
├── Sub_workflow_gerar_PDD_pdf.json   # Lógica para consulta de Geração de PDF
└── README.md                         # Este arquivo

---

Desenvolvido por Rafael Sampaio, Arthur Felipe, Victor Hugo, Gabriel Martins, Matheus Veríssimo