Proposta de Desenvolvimento — Assistente Pessoal Inteligente (n8n + Google Drive + Pinecone + OpenAI)

📄 Proposta de Desenvolvimento — Assistente Pessoal Inteligente (n8n + Google Drive + Pinecone + ******)
Resumo do Projeto
Este projeto é para criar um agente pessoal que me auxilie a tomar decisões pessoais, profissionais e de negócios de forma mais assertiva.
A Base de Conhecimento será alimentada com pastas/subpastas/arquivos no diretório PILO_2025 do Google Drive, ao qual o agente terá acesso total.
Essa base inclui:
* Documento North Star com objetivos, metas e planos estratégicos.
* Planilha financeira com dados consolidados de receita/despesa no fechamento de cada mês, para embasar decisões financeiras e de planejamento de longo prazo.
* Revisões diárias, semanais e mensais (logs e anotações de progresso).
* Documentos gerais, como transcrições, propostas, relatórios e materiais de estudo.
Uso prático:
Posso chamar o agente a qualquer momento para diversas funções, como:
* Revisões/reflexões diárias à noite (preferencialmente com áudio convertido para texto).
* Proposta de agenda matinal (AM) com base nas prioridades do dia.
* Revisões semanais e mensais.
* Buscar uma transcrição específica e me ajudar em um caso prático (ex.: planejar uma aula ou otimizar uma campanha de tráfego pago).
O diferencial é que o agente propõe essas interações de forma proativa e conduz conversas de ida e volta comigo usando a base de conhecimento. Além disso, o sistema deve se retroalimentar — quanto mais interagimos, mais o agente conhece meu perfil, contexto e preferências.

Escopo Técnico e Fases do Projeto
O desenvolvimento será dividido em duas fases principais, cada uma com entregáveis claros e validação.

Fase 1 — Atualização da Base de Conhecimento (Google Drive ➜ Pinecone)
Objetivo: Sempre que um arquivo for adicionado a uma pasta específica do Google Drive, o sistema deve baixá-lo, processá-lo em blocos (chunks), adicionar metadados e enviar para o Pinecone usando embeddings da ******.
Fluxo e Configuração Node a Node:
1. GDrive Trigger: Folder Watch
* Tipo: Google Drive (Trigger)
* Acionamento: Quando um arquivo for criado na pasta alvo (PILO_2025)
* Frequência: A cada 1 min (ou conforme definido)
* Por que importa: Dispara o fluxo assim que um arquivo novo é detectado.
* Definition of Done: Upload de teste dispara o fluxo e mostra saída no node.
2. GDrive Download: File
* Operação: Download do arquivo por ID ({{$json["id"]}})
* Por que importa: Obtém o conteúdo binário do arquivo para processamento.
* Definition of Done: Execução retorna ************ com tamanho > 0.
3. Pinecone Upsert
* Modo: Inserir documentos
* Namespace: pilo_2025
* Modelo de embedding: text-embedding-3-small (******)
* Divisão de texto: Recursive Character Splitter (chunk 500 / overlap 20)
* Metadados: file = nome do arquivo + (opcional: tipo MIME, link de visualização, data de criação)
* Por que importa: Cria blocos pesquisáveis com contexto e metadados para rastreamento de origem.
* Definition of Done: Pinecone registra > 0 documentos, com ************ correto.
Checklist Fase 1:
* Testar com arquivo .txt/.md/.pdf/.csv
* Confirmar aumento no total de vetores no Pinecone
* Validar metadados no console do Pinecone

Fase 2 — Assistente Pessoal (Chat + Recuperação + Interface Pública/Embed)
Objetivo: Criar uma interface de chat que usa o namespace no Pinecone + ****** para responder perguntas baseadas na base de conhecimento.
Fluxo e Configuração Node a Node:
1. Chat: Pilo Assistant
* Tipo: On Chat Message
* Por que importa: Fornece a interface para interagir em tempo real.
* Definition of Done: Chat responde a “oi” com saudação.
2. Agent: Pilo Assistant
* Tipo: AI Agent (Tool Agent)
* Prompt/Sistema:
Você é um assistente pessoal que ajuda o usuário a tomar decisões pessoais, profissionais e de negócios. Use apenas o contexto fornecido. Se não souber, diga “Não sei.”

* Modelo: gpt-4o-mini (rápido e econômico)
* Memória: Window Buffer (últimas 5–10 mensagens)
* Ferramenta: Vector Store Tool (Pinecone Retrieval)
* Por que importa: É o cérebro e orquestrador das respostas.
* Definition of Done: Pergunta de conhecimento aciona busca no Pinecone e retorna informação correta.
3. Ferramenta: Pinecone Retrieval
* Top K: 4 resultados
* Namespace: pilo_2025
* Modelo de embedding: text-embedding-3-small
* Por que importa: Permite respostas fundamentadas na base de conhecimento.
* Definition of Done: Pergunta sobre um documento conhecido retorna informação correta e citada.
4. Publicação/Embed
* Modo: Público ou Embedded Chat
* Opções: URL com autenticação básica, ou código para incorporar no site
* Definition of Done: Link ou embed funcional e protegido (se necessário).

Notas Operacionais e Considerações
* Compatibilidade: Pinecone index dimension deve corresponder ao modelo de embedding.
* Chunking: Ajustável conforme tamanho dos documentos.
* Namespaces: 1 namespace por projeto facilita resets e múltiplos agentes.
* Custos: gpt-4o-mini + text-embedding-3-small têm baixo custo; Pinecone free tier é suficiente no início.
* Evolução: Sistema será treinado continuamente com interações para melhor personalização.