1
denisforigo
2 min de leitura ·

Pitch: Criei um assistente de IA com RAG (Gemini + Convex) para WordPress e publiquei no repositório oficial

Fala pessoal!

Quero compartilhar um projeto que desenvolvi recentemente e que acaba de ser aprovado e publicado no diretório oficial do WordPress.org: o PlatoDev Content Chat Assistant.

O Problema

A maioria dos chatbots para sites WordPress ou são caros, ou são burros (baseados em árvores de decisão antigas), ou usam IA sem contexto real, inventando respostas (alucinações) sobre produtos e serviços.

Eu queria uma solução que:

  1. Lesse exatamente o conteúdo publicado no site (posts, páginas e produtos do WooCommerce).
  2. Respondesse apenas com base no que está no site, citando a fonte.
  3. Fosse acessível e não dependesse de infraestruturas caras para quem está começando.

A Arquitetura Técnica

Para viabilizar isso de forma rápida, eficiente e escalável:

  • WordPress (Frontend/Admin): Plugin nativo em PHP/JS. Ele expõe endpoints para sincronização seletiva dos Custom Post Types e injeta o widget do chat (com layout Drawer lateral ou Modal centralizado).
  • Nuvem & Vector Database (Convex): Em vez de sobrecarregar o banco MySQL do WordPress gerando vetores e fazendo busca por similaridade de cosseno direto no servidor do usuário (o que derrubaria hospedagens compartilhadas), deleguei a indexação vetorial e as queries para o Convex.
  • Engine de IA (Google Gemini 2.5 Flash): O Gemini Flash tem uma janela de contexto generosa, é extremamente rápido e o Google AI Studio oferece uma cota gratuita de até 1.500 requisições diárias, permitindo que a grande maioria dos sites rode o assistente a custo zero.
  • Embeddings Opcionais (Voyage AI): Para quem possui catálogos extensos no WooCommerce e precisa de assertividade semântica máxima.
  • Anti-Bot (Cloudflare Turnstile): Proteção integrada contra scrapers e bots sem forçar visitantes a resolver captchas visuais.

O Processo de Aprovação no WordPress.org

Colocar um plugin no repositório oficial é um baita teste de paciência e qualidade de código:

  • Revisão linha por linha das diretrizes da comunidade (GPL compliance, segurança com check_admin_referer, sanitização rigorosa com sanitize_text_field e absint).
  • Fim de travas artificiais: a versão gratuita no modelo BYOC / BYOK (conectando seu Convex e sua chave Gemini) é livre para sincronizar quantos tipos de post você quiser e usar os formatos Drawer ou Modal.
  • Todo o processo de deploy foi automatizado via SVN com scripts em bash.

Links & Testes

O plugin é 100% gratuito para rodar com suas próprias chaves (modelo BYOK):

Gostaria muito de ouvir feedbacks de quem puder testar no seu próprio WordPress ou loja virtual. Sugestões de melhorias na UI do chat ou na arquitetura de sincronização são super bem-vindas!

Carregando publicação patrocinada...